מפתחים
לידקליינט + Webhook
Webhook הוא המנגנון הגמיש ביותר לחיבור לידקליינט לכל מערכת — CRM, אתר, פלטפורמת פרסום, או כלי פנימי. לידקליינט מציעה Webhook פתוח שמאפשר לשלוח ולקבל אירועים ב-JSON בכל שינוי משמעותי: ליד חדש, שיחה שהסתיימה, עדכון סטטוס, ועוד. כל מפתח שיכול להגדיר HTTP POST יכול לבנות אינטגרציה תוך שעות ספורות, ללא API ייעודי. זהו הבסיס לכל האינטגרציות האחרות של לידקליינט.
איך החיבור עובד
לידקליינט שולחת HTTP POST ל-URL שתגדירו בכל אירוע. הגוף הוא JSON עם שדות מובנים: מזהה ייחודי, סוג האירוע, שם, טלפון, מקור, תאריך, משך שיחה, וקישור הקלטה כשרלוונטי. מהצד השני ניתן גם להגדיר Webhook נכנס — לידקליינט תקבל JSON ותיצור ליד חדש. תיעוד השדות המלא זמין עבור מפתחים דרך תמיכת לידקליינט.
איך מחברים
- 1. הגדירו URL לקבלת Webhooks — הכינו Endpoint שמקבל HTTP POST ב-JSON בשרת שלכם.
- 2. הוסיפו ב-לידקליינט — הכניסו את ה-URL להגדרות Webhook בלידקליינט.
- 3. טפלו ב-JSON — בשרת שלכם עבדו את הנתונים — שמרו ב-DB, שלחו ל-CRM, הפעילו לוגיקה עסקית.
מה אפשר לעשות
- שליחת לידים לכל מערכת פנימית של העסק.
- הפעלת אוטומציות מותאמות אישית בעת שיחה שנגמרה.
- בניית אינטגרציה ייחודית ללא תלות בכלי ביניים.
- חיבור ללוחות BI כמו Google Data Studio.
החיבור לעומק — איך לעבוד עם Webhook
מיפוי שדות ב-Webhook: פורמט ה-JSON שלידקליינט שולחת כולל שדות מובנים קבועים — id, event_type, name, phone, source, timestamp, duration, recording_url. כאשר מממשים Endpoint מקבל, חשוב לטפל גם בשדות חסרים (לדוגמה, recording_url יהיה null בשיחה ללא הקלטה). מומלץ לבנות Schema Validation בצד השרת שמגדיר ממה הוא מצפה ומחזיר 400 אם חסר שדה חובה.
אוטומציות נפוצות: ניתן לבנות Endpoint שמקבל Webhook מלידקליינט ומבצע מספר פעולות במקביל — שמירה ב-DB, שליחה ל-CRM, שליחת SMS, ורישום ב-BI. הפרדה בין קבלת ה-Webhook לעיבוד שלו דרך Queue (לדוגמה, BullMQ, RabbitMQ, או AWS SQS) מאפשרת לוודא שאף אירוע לא יאבד גם אם חלק מהפעולות נכשלות.
מנגנון Retry: לידקליינט מנסה שוב כאשר ה-Endpoint לא מחזיר קוד 2xx. לכן חשוב שה-Endpoint יהיה Idempotent — כלומר, קבלת אותו Webhook פעמיים לא תיצור כפילות. כדי לממש זאת, שמרו את שדה ה-id של כל אירוע ב-DB, ובדקו אם כבר קיים לפני עיבוד. אם קיים — החזירו 200 OK ודלגו על העיבוד.
מבחינת אבטחה, הגישה הנכונה לאימות Webhook: לידקליינט שולחת Secret Header (לדוגמה, X-LeadClient-Signature). ה-Endpoint שלכם מאמת את ה-Header לפני עיבוד הנתונים. מומלץ להשתמש ב-HMAC-SHA256: לידקליינט חותמת את ה-Body עם Secret משותף, אתם מחשבים את החתימה בצד שלכם ומשווים. אם החתימות שונות — החזירו 401 Unauthorized.
השוואה בין Webhook ישיר, Zapier ו-Make: Webhook ישיר מתאים לכאשר יש מפתח שיכול לכתוב ולתחזק Endpoint; הוא המהיר ביותר, הזול ביותר (אין עלות Zapier/Make), ומאפשר לוגיקה עסקית מורכבת. Zapier ו-Make מתאימים לאנשים ללא ידע תכנותי ומציעים אלפי אפליקציות מוכנות. לעסקים טכניים עם צוות פיתוח — Webhook ישיר הוא הבחירה הטבעית.
לבדיקת Webhook: כלי כמו Webhook.site או ngrok מאפשרים לקבל Webhooks מלידקליינט אל כתובת זמנית — שימושי לראות בדיוק מה ה-Payload שמגיע לפני שבונים את ה-Endpoint האמיתי. לאחר שבניתם את ה-Endpoint, בדקו עם ליד בדיקה ובדקו ב-Logs של השרת שהנתונים התקבלו, עובדו, ונשמרו כהלכה.
תרחיש לדוגמה: חברת SaaS בישראל בנתה Endpoint ב-Node.js שמקבל Webhook מלידקליינט. בכל שיחה נכנסת, ה-Endpoint: בודק אם מספר הטלפון קיים ב-DB, אם לא — יוצר Lead חדש; אם כן — מוסיף Note לאיש הקשר הקיים. לאחר מכן מפעיל Twilio SMS ושולח הודעת Follow-Up. כל הלוגיקה כתובה בקוד ומאחסנת ב-GitHub לתחזוקה קלה.
Inbound Webhook — שליחת לידים ל-לידקליינט מבחוץ: אם יש לכם מקור לידים שאינו נתמך ב-Zapier, ניתן לממש HTTP POST ל-Webhook הנכנס של לידקליינט ישירות מה-Backend שלכם. זה שימושי לשילוב לידים ממערכות פנימיות — לדוגמה, לידים שנאספו בכנס, ייבוא Excel מוסב, או שילוב עם ERP קיים. פרטים על הפורמט — דרך תמיכת לידקליינט.
ניטור שוטף של Webhooks: מומלץ לבנות Dashboard פשוט שמציג: כמה Webhooks התקבלו ב-24 שעות האחרונות, כמה עובדו בהצלחה, כמה נכשלו. כלים כמו Datadog, Grafana, או אפילו Google Sheets עם Apps Script יכולים לשמש לכך. ניטור שוטף מאפשר לזהות בעיות (שהEndpoint קרס, שה-Secret פג, שיש spike חריג) לפני שהן מצטברות לאובדן לידים.
שאלות נפוצות — Webhook
מה פורמט ה-JSON שלידקליינט שולחת?
לידקליינט שולחת JSON עם שדות סטנדרטיים: id, event_type, name, phone, source, timestamp, duration, recording_url. מומלץ לפנות לתמיכה לתיעוד מלא ועדכני.
האם הWebhook מאובטח?
מומלץ לאמת בקשות Webhook על ידי בדיקת חתימה (secret) שלידקליינט שולחת ב-Header. פרטים זמינים בתיעוד ה-API.
מה קורה אם ה-Endpoint שלי לא זמין?
לידקליינט מנסה שוב מספר פעמים במרווחי זמן גדלים. מומלץ לנטר כשלים ולהגדיר התראות.
האם ניתן גם לשלוח לידקליינט נתונים מבחוץ דרך Webhook?
כן, לידקליינט תומכת גם ב-Inbound Webhook ליצירת לידים חיצוניים. פרטים על הפורמט ואימות הבקשה — דרך תמיכת לידקליינט.
אינטגרציות נוספות
לידקליינט מתחברת לעוד כלים, מערכות CRM, פלטפורמות פרסום ובוני אתרים. הנה כמה חיבורים נוספים שאולי תרצו.