GetLeadsSummary - סיכום מצב לידים

בעוד ש-GetLeadIds מחזירה את רשימת הלידים, הקריאה הזו מחזירה סיכום מצרפי של אותם לידים: כמה נכנסו, איך הם מתפלגים לפי סטטוס, כמה נסגרו, מה עלות הליד וכמה שיחות נכנסו. מתאימה בול להודעת "תמונת מצב" שבועית/חודשית ב-Make / Smartsend.

POST https://YOUR-SUBDOMAIN.taskey.co.il/webapi/GetLeadsSummary.php
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

⚠️ חבילה נדרשת: GetLeadsSummary זמין בחבילת Premium / Pro. ללא גישה, התשובה תהיה PLAN_UPGRADE_REQUIRED. ראו אימות.

פרמטרים (כולם אופציונליים)

ערכי range אפשריים: this_week, last_week, this_month, last_month, last_7_days, last_30_days. השבוע מתחיל ביום ראשון (לוח ישראלי).

דוגמת בקשה - סיכום השבוע שעבר + עלות מדיה

{
  "range": "last_week",
  "total_cost": 5000
}

מבנה התשובה

{
  "status_code": 200,
  "range": { "from": 1783617640, "to": 1786209640, "label": "7 הימים האחרונים" },
  "total_leads": 87,
  "by_status": [
    { "status_id": 12, "name": "לקוח של משווק", "color": "success", "finish": "",  "count": 53 },
    { "status_id": 45, "name": "לא רלוונטי",     "color": "danger",  "finish": "-1", "count": 15 }
  ],
  "buckets": {
    "general": 20,
    "in_progress": 30,
    "irrelevant": 15,
    "closed": 12,
    "other": 10
  },
  "cost_per_lead": { "total_cost": 5000, "per_lead": 57.47 },
  "incoming_calls": { "total": 28, "closed": 0 }
}

הסבר השדות

הקבוצות (buckets)

הקיבוץ נקבע לפי שדה ה-Finish של הסטטוס:

דוגמת cURL מלאה

curl -X POST "https://forte.taskey.co.il/webapi/GetLeadsSummary.php" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"range":"last_week","total_cost":5000}'

💡 רשימה מול סיכום: צריך את הלידים עצמם? השתמשו ב-GetLeadIds. צריך רק את המספרים לתמונת מצב? זו הקריאה הנכונה.