מבוא ל-API
ה-API של TASKEY מאפשר לחבר למערכת כל מקור חיצוני - להכניס לידים, פגישות ורכישות, וגם לשלוף נתונים החוצה. כל מה שצריך כדי להתחיל נמצא כאן.
מערכת TASKEY מספקת API פתוח ומלא שעובד בשני הכיוונים:
- הכנסת מידע - לקלוט לידים, פגישות, רכישות, משימות והודעות וואטסאפ ממקורות חיצוניים (טפסים, פייסבוק, Make, Zapier ועוד).
- שליפת מידע - למשוך לידים לפי טווח תאריכים, לקרוא את הסטטוס של כל ליד, את הסיבה שסומנה ל"לא רלוונטי" ועוד.
📍 על קצה המזלג כל קריאה היא POST לכתובת
https://YOUR-SUBDOMAIN.taskey.co.il/webapi/ENDPOINT.php. חלק מהקריאות פתוחות (כמוAddLead), וחלק דורשות Bearer Token (ראו אימות).
כתובת בסיס (Base URL)
הכתובת הבסיסית לכל קריאת API נגזרת מהסאב-דומיין של החשבון שלכם:
https://YOUR-SUBDOMAIN.taskey.co.il/webapi/ENDPOINT.phpלמשל, אם הסאב-דומיין שלכם הוא mycompany:
https://mycompany.taskey.co.il/webapi/AddLead.phpפורמטים נתמכים
קריאות הכנסת מידע מקבלות application/json, application/x-www-form-urlencoded או XML. קריאות שליפה מקבלות גוף application/json.
מה אפשר לעשות
| תחום | Endpoints עיקריים |
|---|---|
| הכנסת לידים ועדכונם | AddLead, UpdateLead |
| שליפת לידים וסטטוסים | GetLeadIds, GetLeadId, GetStatus |
| משימות | AddTask, GetTasks, GetTask, UpdateTask |
| פגישות | AddMeeting, UpdateMeeting, CancelMeeting |
| רכישות | AddPurchase, GetPurchases, GetPurchase, UpdatePurchaseStatus |
| הוראות קבע / ריטיינרים | AddRecurring, GetRecurring, UpdateRecurring |
| פרויקטים | AddProject, GetProject, UpdateProject |
| וואטסאפ | AddWhatsappToSend, GetWhatsappMessages |
| אינטגרציות מוכנות | Make, Zapier, וורדפרס, פייסבוק |
איפה מקבלים מפתח API
גשו להגדרות → API בתוך המערכת. המפתח מוצג בראש הדף - לחיצה על אייקון העין חושפת אותו. העתיקו אותו; תצטרכו אותו לכל קריאה שדורשת אימות.
⚠️ שמרו על המפתח. מי שמחזיק בו יכול להוסיף לידים ולגשת לנתוני החשבון. אל תשתפו אותו בפומבי.
צעד ראשון מומלץ: קראו את עמוד אימות, ואז עברו ל-AddLead (הפעולה הנפוצה ביותר) או ל-שליפת רשימת לידים.