GetLeadIds - רשימת לידים

זו הקריאה שעונה על "תן לי את כל הלידים שנכנסו בשבוע האחרון". כל ליד בתשובה הוא ליד מלא - כולל הסטטוס והסיבה ל"לא רלוונטי" - בדיוק כמו GetLeadId.

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

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

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

טווחי התאריכים הם מילות מפתח (לא תאריך מדויק): last_7_days, last_week, today, yesterday, month, last_month, last_30_days. אפשר גם להעביר יום בודד מדויק (למשל 2026-06-01). רשימה מלאה: סינון תאריכים.

דוגמת בקשה - כל הלידים מהשבוע האחרון

{
  "Created": "last_7_days"
}

דוגמת בקשה - לידים בסטטוס מסוים בחודש האחרון

{
  "Created": "last_30_days",
  "status_id": 8,
  "limit": 50
}

דוגמת בקשה - כל מי שעודכן בתקופה, מכל הסטטוסים

{
  "last_update_from": "01/09/2026",
  "last_update_to": "30/09/2026",
  "order_by": "last_update_lead",
  "order_dir": "asc",
  "limit": 100
}

הרחבה מלאה על סנכרון לפי ת. עדכון אחרון, כולל הגדרה ב-Make: משיכת לידים שעודכנו.

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

{
  "Created": "last_7_days",
  "include_comments": 1
}

מבנה התשובה

{
  "status_code": 200,
  "total_rows": 2,
  "total_count": 87,
  "limit": 50,
  "offset": 0,
  "page": 1,
  "total_pages": 2,
  "has_more": true,
  "next_page": 2,
  "leads": [
    {
      "id": 12345,
      "name": "ישראל ישראלי",
      "phone": "0501234567",
      "email": "israel@example.com",
      "status_id": "3",
      "status_name": "בטיפול",
      "leave_reason": "",
      "source": "פייסבוק",
      "campaign": "קמפיין קיץ",
      "adset": "גילאי 25-40",
      "ad": "מודעה א",
      "dates": [
        { "key": "add_date", "label": "תאריך יצירה ראשון", "date": "08/06/2026", "time": "10:14" },
        { "key": "Created",  "label": "תאריך פנייה אחרונה", "date": "08/06/2026", "time": "10:14" },
        { "key": "FU",       "label": "תאריך חזרה",         "date": "10/06/2026", "time": "09:00" },
        { "key": "last_update_lead", "label": "ת. עדכון אחרון", "date": "09/06/2026", "time": "16:32" }
      ],
      "last_update_ts": 1781011920,
      "last_update_date": "09/06/2026 16:32",
      "fields": [
        { "key": "Custom1", "label": "סוג עסק", "value": "עסק קטן" }
      ],
      "comments": [
        {
          "id": 1825,
          "comment": "שוחחתי עם הלקוח, מעוניין בהצעה",
          "notes": "",
          "user_id": 6,
          "user_name": "דנה כהן",
          "add_date": "21/05/2026 22:05",
          "timestamp": 1747857955
        }
      ]
    }
  ]
}

💡 כל פריט ברשימה הוא ליד מלא - אותו מבנה בדיוק שמחזירה הקריאה GetLeadId. אין צורך בקריאה נוספת כדי לקבל את הסטטוס או הסיבה.

דפדוף (Pagination)

כשיש יותר תוצאות מה-limit, התשובה כוללת שדות דפדוף:

כש-has_more הוא true - שלחו את אותה בקשה עם page: next_page לקבלת העמוד הבא.

התגובות של הליד (include_comments)

בברירת מחדל התגובות לא נשלפות (חוסך נפח בתשובה). שליחת include_comments: 1 מוסיפה לכל ליד מערך comments - לוג הליד, עד 50 תגובות אחרונות, מהחדשה לישנה. כל תגובה כוללת את הטקסט (comment), הערות (notes), מי כתב (user_id + user_name) ומתי (add_date + timestamp).

הסטטוס והסיבה ל"לא רלוונטי"

כל ליד כולל שלושה שדות שעונים בדיוק על "מה הסטטוס, ולמה לא רלוונטי":

כדי לתרגם בין status_id לשם, או לדעת אילו סטטוסים קיימים - קראו ל-GetStatus.

דוגמת cURL מלאה

curl -X POST "https://forte.taskey.co.il/webapi/GetLeadIds.php" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"Created":"last_7_days"}'

🏢 מנהלים כמה חשבונות לקוח (סוכנות)? ראו סוכנות עם כמה חשבונות.