משיכת לידים שעודכנו
סנכרון לפי השדה "ת. עדכון אחרון" - כל הלידים שהשתנו בתקופה, מכל הסטטוסים, בקריאה אחת. כולל מדריך הגדרה ב-Make.
זו הקריאה שעונה על "תן לי את כל מה שזז מאז אתמול". במקום למשוך לפי תאריך כניסת הליד, מסננים לפי ת. עדכון אחרון - מתי באמת נגעו ברשומה. זה השדה הנכון לסנכרון דו-כיווני מול מערכת חיצונית.
POST https://YOUR-SUBDOMAIN.taskey.co.il/webapi/GetLeadIds.php
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
⚠️ חבילה נדרשת: הקריאה זמינה בחבילת Premium / Pro, כמו
GetLeadIds.
מתי השדה מתעדכן
last_update_lead נכתב בכל אחת מהפעולות הבאות:
- יצירת ליד - הוספה ידנית, טופס, ייבוא, Google Sheets, ו-API.
- שינוי סטטוס - מטבלת הלידים, מכרטיס הליד, מעדכון מרובה, ומ-
UpdateLead. - כל עדכון אחר של הליד - נציג, תאריך חזרה, שדות מותאמים, תגובה חדשה.
כלומר כל שינוי שרואים בכרטיס הליד מזיז את השדה, ולכן קריאה אחת מספיקה כדי לדעת מה השתנה.
פרמטרים
| שדה | תיאור | דוגמה |
|---|---|---|
last_update_from | מתאריך העדכון (כולל) | 01/09/2026 |
last_update_to | עד תאריך העדכון (כולל) | 30/09/2026 |
last_update_lead | יום בודד או מילת מפתח - חלופה לטווח | last_30_days |
order_by | עמודת המיון: last_update_lead, Created, FU, add_date, id | last_update_lead |
order_dir | asc או desc | asc |
status_id | סטטוס בודד. בלי הפרמטר - כל הסטטוסים | 5 |
limit / page | גודל עמוד (עד 100) ומספר עמוד | 100 |
פורמט התאריכים: d/m/Y (למשל 09/09/2026), Y-m-d (למשל 2026-09-09), או UNIX timestamp. שני צידי הטווח אופציונליים - אפשר לשלוח רק last_update_from כדי לקבל "מאז".
last_update_to שנשלח כתאריך בלבד, בלי שעה, כולל את כל אותו יום עד 23:59.
כל הסטטוסים בקריאה אחת
status_id אינו חובה. בלעדיו הקריאה מחזירה את כל הלידים שעודכנו בטווח - מכל הסטטוסים - ואין צורך להריץ את התרחיש פעם לכל סטטוס.
{
"last_update_from": "01/09/2026",
"last_update_to": "30/09/2026",
"order_by": "last_update_lead",
"order_dir": "asc",
"limit": 100,
"page": 1
}
סנכרון מתגלגל
לתרחיש שרץ בלוח זמנים, פשוט יותר לעבוד עם מילת מפתח במקום לחשב תאריכים:
{
"last_update_lead": "last_30_days",
"order_by": "last_update_lead",
"order_dir": "desc",
"limit": 100
}
מילות המפתח הנתמכות: today, yesterday, last_7_days, last_30_days, last_month, month, week. רשימה מלאה: סינון תאריכים.
מה חוזר בכל ליד
התשובה זהה במבנה ל-GetLeadIds, עם שני שדות נוספים:
| שדה | משמעות |
|---|---|
last_update_ts | ת. עדכון אחרון כ-UNIX timestamp. 0 = הליד לא עודכן מעולם |
last_update_date | אותו ערך בפורמט d/m/Y H:i |
{
"id": "10164",
"name": "ישראל ישראלי",
"phone": "0501234567",
"status_id": "2",
"status_name": "בטיפול",
"last_update_ts": 1788472830,
"last_update_date": "04/09/2026 01:00",
"dates": [
{ "key": "last_update_lead", "label": "ת. עדכון אחרון", "date": "04/09/2026", "time": "01:00" }
]
}
הגדרה ב-Make
- מפתח API - בטאסקי: הגדרות ← API. לכל חשבון (סאב-דומיין) מפתח משלו.
- מודול HTTP ← Make a request - URL הוא
https://YOUR-SUBDOMAIN.taskey.co.il/webapi/GetLeadIds.php, Method הואPOST, Body type הואRawו-Content type הואJSON. - כותרת -
Authorizationעם הערךBearer YOUR_API_TOKEN. מסמנים Parse response כדי ש-Make יפרק את ה-JSON לשדות. - גוף הבקשה - אחת הדוגמאות שלמעלה. בלי
status_id, כדי לקבל את כל הסטטוסים. - Iterator על המערך
leads- כל פריט הוא ליד מלא עם מזהה, סטטוס נוכחי, ת. עדכון אחרון ושאר השדות.
מי שמשתמש באפליקציית TASKEY במודול רשימת לידים מקבל את אותם שדות כפרמטרים במודול עצמו.
דפדוף
קריאה אחת מחזירה עד 100 לידים. כדי למשוך תקופה שלמה, מריצים לולאה: כל עוד has_more הוא true, שולחים את אותה בקשה עם page הבא.
מיון לפי order_by: last_update_lead שומר על סדר יציב בין העמודים. ללא מיון קבוע, ליד שמתעדכן באמצע המשיכה עלול לקפוץ בין עמודים.
דוגמת cURL מלאה
curl -X POST "https://forte.taskey.co.il/webapi/GetLeadIds.php" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"last_update_from":"01/09/2026","order_by":"last_update_lead","limit":100}'
💡 מה ההבדל מ-
Created? Createdהוא תאריך הפנייה האחרונה מהליד, ו-FUהוא תאריך החזרה שנקבע. ת. עדכון אחרון הוא מתי הרשומה עצמה השתנתה - כולל שינוי סטטוס שנעשה ביוזמת הנציג.