הלשונית Webhooks מחברת את banta לאתר שלכם ולמערכות חיצוניות. מגיעים אליה בהגדרות הארגון ← חיבורים וטכנולוגיה ← Webhooks. יש בה שני חלקים:
- קבלת לידים - טפסים באתר (וורדפרס ואחרים) ואוטומציות של Zapier או Make שולחים לידים ישירות ל-banta, בלי מפתח API ובלי קוד.
- שליחת אירועים - banta שולחת לשרת שלכם הודעה חתומה בכל פעם שמשהו קורה: ליד חדש, שינוי סטטוס, תשלום ועוד.
דוגמאות
- טופס צור קשר באתר וורדפרס: יוצרים נקודת קליטה בשם "טופס האתר", מדביקים את הכתובת שלה בטופס של Elementor Pro, וכל פנייה מהאתר נכנסת לרשימת הלידים עם המקור, האחראי והתגיות שהגדרתם.
- עדכון מערכת אחרת: מוסיפים webhook לאירוע "ליד חדש" עם הכתובת של המערכת השנייה, וכל ליד שנוצר ב-banta נשלח אליה מיד.
איך מחברים טופס מהאתר ל-banta?
- בחלק קבלת לידים לחצו "נקודת קליטה חדשה" ותנו לה שם (למשל "טופס צור קשר באתר").
- בחרו ברירות מחדל לכל ליד שיגיע דרכה: מקור ליד, סטטוס התחלתי, אחראי ותגיות. באחראי, האפשרות ללא אחראי (או לפי השיוך האוטומטי, אם הופעל) שולחת כל ליד ליועץ הבא בסבב של הארגון, כשהשיוך האוטומטי פעיל.
- בחרו מה קורה כשמגיע ליד עם טלפון או אימייל של ליד קיים: ליצור ליד חדש ולסמן אותו ככפילות אפשרית (מומלץ), לרשום את הפנייה כהערה על הליד הקיים, או ליצור ליד חדש בלי בדיקה.
- לחצו "יצירת נקודת קליטה". כתובת הנקודה מוצגת פעם אחת בלבד - העתיקו אותה ושמרו עליה כמו על סיסמה.
- הדביקו את הכתובת בכלי שלכם ושלחו טופס בדיקה. בחלון שנפתח אחרי היצירה יש הוראות קצרות לכל כלי.
אילו כלים אפשר לחבר?
- Elementor Pro - בעריכת הטופס, תחת Actions After Submit, מוסיפים Webhook ומדביקים את הכתובת.
- Contact Form 7 - בעזרת תוסף webhook (למשל CF7 to Webhook).
- WPForms ו-Gravity Forms - בתוסף ה-Webhooks שלהם, בשיטה POST ובפורמט JSON.
- Zapier ו-Make - בפעולת POST לכתובת הנקודה. כך אפשר לחבר גם לידים מ-Facebook Lead Ads.
הוראות מפורטות לכל כלי נמצאות במדריך קבלת הלידים באתר התיעוד.
איך banta יודעת איזה שדה הוא שם ואיזה טלפון?
שם, טלפון, אימייל והודעה מזוהים אוטומטית לפי שם השדה, בעברית ובאנגלית ("טלפון", "phone", "your-tel" וכדומה). שדה שלא זוהה - למשל מזהה מספרי של Gravity Forms - ממפים בכפתור "מיפוי שדות" בכרטיס הנקודה: המסך מציג את השדות שהגיעו בשליחות האחרונות (אחרי שליחת בדיקה לוחצים "רענון"), ולכל אחד בוחרים שדה ליד, שדה מותאם או "להתעלם". שדה שלא מופה לא הולך לאיבוד - הוא נשמר בהערת פרטים על הליד.
איך רואים מה הגיע ולמה שליחה נדחתה?
ב"יומן אירועים" של הנקודה מופיעה כל שליחה שהגיעה אליה - שהתקבלה או שנדחתה - למשך 30 יום (שליחה לנקודה מושבתת, או גדולה מ-64KB, נדחית לפני שהנקודה מזוהה ולא נרשמת). פותחים שורה כדי לראות את השדות שהגיעו, איך כל אחד מופה, ואת סיבת הדחייה אם הייתה. משליחה שיצרה ליד אפשר לעבור ישירות לליד. אפשר לסנן לפי סטטוס.
איך שומרים על הנקודה מאובטחת?
- הכתובת עצמה סודית. אם היא דלפה, בחרו "חידוש טוקן" בתפריט הנקודה - תוצג כתובת חדשה, והקודמת תפסיק לעבוד מיד.
- כתובות IP מורשות (תחת "אבטחה וסינון") - שליחות מכתובות אחרות נדחות. במצב הזה עובדת רק הכתובת הישירה (db.banta.co.il), עם אותו טוקן, ושליחות דרך הכתובת של app.banta.co.il נדחות. כשמפעילים את הרשימה בנקודה קיימת, המסך מסביר מה לעדכן: להחליף בכלי ששולח לנקודה רק את תחילת הכתובת, או לבחור "שמירה וחידוש הטוקן" ולקבל כתובת ישירה מלאה חדשה. הסרת הרשימה לא מחייבת שינוי - שתי הכתובות עובדות.
- חתימה על כל בקשה - לשרתים ולאוטומציות שאתם כותבים בעצמכם. תוספי טפסים בוורדפרס לא יודעים לחתום, ולכן לא מפעילים חתימה עבורם.
- שדה honeypot - שדה מוסתר בטופס שגולש אמיתי לא ממלא. שליחה שבה הוא מולא נרשמת כספאם ולא יוצרת ליד.
איך שולחים אירועים מ-banta לשרת שלנו?
- בחלק שליחת אירועים לחצו "webhook חדש".
- הזינו כתובת https של השרת המקבל, בחרו אירועים (ליד חדש, שינוי סטטוס, שיוך, המרת ליד לתיק, תיק חדש, משימה שהושלמה, תשלום, חיוב ששולם, אבן דרך שהושלמה ועוד) והוסיפו תיאור.
- סוד החתימה מוצג פעם אחת. שמרו אותו בשרת המקבל - בעזרתו הוא מוודא שההודעה באמת הגיעה מ-banta.
- לחצו "שליחת בדיקה", ועקבו ב"יומן משלוחים": סטטוס, מספר ניסיונות, קוד התגובה, השגיאה ותוכן ההודעה. משם אפשר גם לשלוח משלוח שוב.
מה קורה כשהשרת המקבל לא עונה?
banta מנסה שוב אוטומטית במשך כ-45 שעות - גם כשהשרת המקבל עונה 401 או 403, למשל בזמן החלפת סוד החתימה. אם כל ניסיונות השליחה נכשלים במשך 24 שעות ברציפות (ולפחות 5 ניסיונות), או כשהשרת המקבל מחזיר 410, ה-webhook מושבת אוטומטית, ומשתמשים עם הרשאה לניהול החיבורים מקבלים התראה. תקלה קצרה לא משביתה אותו, גם כשממתינים הרבה משלוחים. אחרי שמתקנים את הבעיה בצד המקבל, מפעילים אותו מחדש מהכרטיס - מאותו רגע נשלחים אירועים חדשים, ואת המשלוחים שדולגו בזמן ההשבתה אפשר לשלוח שוב מ"יומן משלוחים" (הוא נשמר 30 יום). ה-webhook מושבת גם כשמפתח ה-API שיצר אותו נמחק או בוטל.
שאלות נפוצות
מה ההבדל בין נקודת קליטה לטופס ציבורי? טופס ציבורי של banta הוא טופס מוכן שמשתפים או מטמיעים באתר. נקודת קליטה מקבלת לידים מטופס או ממערכת שכבר יש לכם. ראו טפסים ציבוריים.
מה זה התג "נוצר דרך ה-API"? webhook שנוצר על ידי מערכת חיצונית דרך ה-API (למשל Zapier). אפשר לנהל אותו מכאן כמו כל webhook אחר.
למי משויך ליד שהגיע בלי אחראי? אם בארגון פועל שיוך אוטומטי, הליד מקבל את היועץ הבא בסבב - לפי הסדר או לפי עומס - והיועץ מקבל התראה. אחרת הוא נשאר בלי יועץ ומופיע בתצוגה "לא שויך" ברשימת הלידים. כך גם ליד שנוצר דרך ה-API בלי יועץ. ראו שיוך אוטומטי של לידים.
כמה נקודות אפשר ליצור? עד 20 נקודות קליטה ועד 20 webhooks לארגון.
מי רואה את הלשונית? משתמשים עם הרשאה לניהול החיבורים בהגדרות הארגון. יומן האירועים מציג את פרטי הלידים שהגיעו.
המשך מכאן
מערכת חיצונית שמנהלת webhooks בעצמה צריכה מפתח API עם הרשאת Webhooks מפורשת - ראו מפתחות API. למפת כל ההגדרות ראו הגדרות הארגון - מדריך התמצאות. מדריכים מלאים עם דוגמאות קוד: קבלת לידים ו-Webhooks.