API

API ו-Webhooks

קליטת לידים מכל מקור חיצוני בשנייה אחת. בלי ייצוא קבצים, בלי סנכרון יומי, בלי העתקה ידנית.

סקירה כללית

Webhook הוא כתובת קליטה ייעודית שאנחנו פותחים לכל workspace. כל מערכת חיצונית (טופס, אוטומציה, פלטפורמת לידים) יכולה לשלוח לכתובת בקשה אחת בכל פעם שמתקבל ליד חדש, והוא ייכנס מיידית למערכת, משויך לאיש הקשר הנכון, עם כל פרטי הקמפיין.

האבטחה בנויה על טוקן ייעודי לכל workspace, שיוך אוטומטי לתחום הנכון, אחסון מוצפן של חתימת הטוקן בלבד (לא הטוקן עצמו), וביטול מיידי בכל רגע.

אימות וטוקנים

כל workspace מקבל טוקן פרטי משלו. ניתן להעביר את הטוקן באחת משלוש דרכים שקולות:

  • Authorization header (מומלץ): Bearer YOUR_TOKEN
  • X-CRM-Token header: X-CRM-Token: YOUR_TOKEN
  • Query parameter: ?token=YOUR_TOKEN

טוקנים מונפקים בתוך המערכת אחרי הרשמה. פתחו workspace והיכנסו ל-Settings כדי ליצור טוקן ראשון.

כתובת Webhook ופורמט בקשה

שיטה POST, Content-Type application/json. שדה זיהוי חובה: לפחות אחד מ-name, phone או email. שדות אופציונליים: city, source, campaign, ad_name, adset_name, form_id, notes, lead_date.

POST https://my-crm.vip/api/leads/webhook/generic
Authorization: Bearer YOUR_TOKEN_HERE
Content-Type: application/json

דוגמת JSON

{
  "name": "ישראל ישראלי",
  "phone": "0541234567",
  "email": "israel@example.co.il",
  "city": "תל אביב",
  "source": "facebook_ads",
  "campaign": "קמפיין קיץ 2026",
  "adset_name": "קהל גילאי 25-45",
  "ad_name": "מודעה וידאו A",
  "form_id": "lead_form_summer_v2",
  "notes": "ביקש להתקשר אחרי 18:00",
  "lead_date": "2026-06-08T14:32:00.000Z"
}

דוגמת cURL

curl -X POST https://my-crm.vip/api/leads/webhook/generic \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ישראל ישראלי",
    "phone": "0541234567",
    "source": "website_form"
  }'

5 מתכוני אינטגרציה פופולריים

הדרכים הנפוצות לחבר מקור לידים חיצוני ב-15 דקות:

Zapier

בחרו Action של Webhooks by Zapier > POST. כתובת היעד היא ה-URL של ה-Webhook, ה-Payload Type הוא JSON, וב-Headers מוסיפים Authorization עם הטוקן. הוסיפו את שדות הליד כ-Data וחברו את Trigger Zap למקור הלידים שלכם.

Make.com

צרו מודול HTTP > Make a request. שיטה POST, Body Type Raw, Content Type application/json. הדביקו את ה-JSON עם הטוקן ב-Authorization header. Make תומך במיפוי שדות דינמי מכל טריגר.

n8n

מודול HTTP Request, Method POST, Authentication = Generic Credential Type > Header Auth. שם הפרמטר Authorization, ערך Bearer YOUR_TOKEN. ה-Body הוא JSON עם שדות הליד.

Tally / טפסי אתר

ב-Tally בחרו Integrations > Webhooks. הדביקו את כתובת ה-Webhook, הוסיפו Header של Authorization עם הטוקן, ומפו את שדות הטופס לשמות name, phone, email.

Backend מותאם אישית

כל שרת שיכול לשלוח HTTP POST עם JSON עובד מיידית. Node.js, Python, PHP, Ruby, Go, .NET. ראו את דוגמת ה-cURL למעלה והעתיקו את הלוגיקה לסביבה שלכם.

קודי שגיאה

כל תגובה כוללת קוד HTTP סטנדרטי וגוף JSON עם פירוט השגיאה:

קודמשמעות
200הליד נקלט בהצלחה ונשמר במערכת
400JSON לא תקין או חסר שדה זיהוי (name/phone/email)
401טוקן חסר, לא קיים או בוטל
403הטוקן לא מורשה לכתוב לסקופ הזה
413ה-Payload גדול מ-100KB
429חריגה ממכסת הקצב, נסו שוב בעוד דקה
500שגיאה זמנית בצד השרת, נסו שוב או פנו לתמיכה

מגבלות קצב וגודל

  • Webhooks ללידים: 100 בקשות בדקה לכל טוקן
  • Forms public submit: 30 בקשות בדקה לכל IP, 10 לטופס בשעה
  • API מאומת: 1000 בקשות בדקה לכל workspace
  • גודל מקסימלי של Payload: 100KB לבקשה
  • אורך מקסימלי של notes: 5000 תווים
  • חריגה מהמכסה תחזיר 429 עם header של Retry-After בשניות

מוכנים להתחיל?

פתחו workspace וקבלו טוקן ראשון תוך 30 שניות. הקליטה הראשונה עובדת מיד אחרי יצירת הטוקן, ללא צורך בהגדרות נוספות.

שאלות טכניות?

שלחו פנייה ל-dev@my-crm.vip או דרך דף יצירת הקשר. צוות הפיתוח שלנו עונה בתוך יום עסקים.