שליחת אירועים למערכות חיצוניות (Webhook)

חיפוש

שליחת אירועים למערכות חיצוניות (Webhook) בביג בוס
 

שליחת אירועים למערכות חיצוניות (Webhook) בביג בוס: הודעה למערכת שלכם כשמשהו משתנה

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

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

הכיוון הוא אחד: ביג בוס שולחת. כשהמערכת שלכם צריכה לפנות לביג בוס, למשל כדי לשאול על יתרת מלאי או ליצור בה מסמך, זה התפקיד של התוסף ממשק API. ולמי שרוצה להבין קודם את המושג עצמו, המאמר מה זה Webhook מסביר בשפה פשוטה איך מערכת אחת מודיעה לאחרת שמשהו קרה.

למשל: חנות אונליין שרוצה לעדכן את האתר כשכמות במחסן משתנה, יועץ שמעביר כל ליד חדש למערכת הדיוור שלו, או עסק שמחזיק לוח נתונים עם כל מסמכי המכירה שהופקו. בכל המקרים האלה ביג בוס מודיעה, והצד השני בונה את ההמשך: בקוד, או בכלי חיבור של צד שלישי כמו Make או Zapier.

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

שימו לב: שליחת אירועים למערכות חיצוניות (Webhook) היא תוסף בתשלום, והפירוט בעמוד המסלולים. התוסף מוצע לעוסק מורשה ולחברה. בתקופת הניסיון מפעילים את התוסף בכרטיס התוספים שבפרופיל, בלי חיוב. התוסף לא דורש את תוסף ממשק ה-API. הודעות על לידים דורשות את התוסף ניהול לידים ומשימות (CRM).

 

מדריך עבודה עבור התוסף שליחת אירועים למערכות חיצוניות (Webhook)

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

להלן רשימת הקישורים במדריך:

– מה עושה שליחת אירועים (Webhook), ומה לא

– הפעלת התוסף בכרטיס התוספים

– הגדרת אירוע חדש: סוג, מפתח וכתובת

– רשימת האירועים: מה רואים בה, ואיך מוחקים אירוע

– פתיחת אירוע קיים ושינוי ההגדרות שלו

– אילו פעולות שולחות הודעה, ואילו לא

– הודעת מלאי: מה המספר אומר

– קליטת ההודעה בצד שלכם: כתובת, מפתח ותשובה

– הודעת מסמך: מה נשלח בהפקה, בעריכה ובביטול

– מבנה ההודעה לכל סוג אירוע (מפרט טכני)

– Webhook או ממשק API: מה ההבדל, ומתי צריך כל אחד

 

מאמרים נוספים

הצד השני של החיבור, שבו המערכת שלכם פונה לביג בוס, מוסבר במה עושה ממשק ה-API של ביג בוס, ומה לא. ומי שמקבל הודעות מלאי ורוצה גם את היתרה העדכנית ימצא את ההסבר במשיכת כמויות מלאי למערכת חיצונית.

 

איך זה עובד?

ארבעה שלבים. את שני הראשונים עושים בהתחלה, והשאר קורה לבד.

  • מפעילים את התוסף: ב"פרופיל משתמש" ← "תוספים", בכרטיס "Webhook". בתפריט "הגדרות מערכת" נוסף הפריט "ניהול WebHook".
  • מגדירים אירועים: לכל סוג פעולה שרוצים לשמוע עליו מגדירים אירוע, עם "סוג האירוע", סיסמה שאתם בוחרים בשדה "מפתח Api", ו"כתובת נקודת הקצה", כתובת https של המערכת המקבלת. כתובת אחת לכל סוג אירוע.
  • ביג בוס שולחת: מיד אחרי הפעולה יוצאת בקשת POST עם הפרטים בפורמט JSON והסיסמה בכותרת, ובדרך כלל היא מגיעה תוך כמה שניות. אם הכתובת לא עונה בהצלחה, יש עוד שני ניסיונות: אחרי כדקה, ואחרי עוד כ-5 דקות.
  • המערכת שלכם מקבלת: בודקת את הסיסמה, עונה תוך 15 שניות, ועושה את מה שבניתם בה: מעדכנת את האתר, מוסיפה איש קשר לרשימת דיוור או מוסיפה שורה ללוח הנתונים.

ככה זה נראה ביום רגיל: עובד מפיק קבלה ללקוח, ותוך כמה שניות לוח הנתונים של העסק מקבל את המסמך עם הסכום והשורות. בקופה נמכרות שתי יחידות, והאתר מקבל הודעה שהכמות במחסן ירדה בשתיים, ושולף את היתרה העדכנית דרך ממשק ה-API. ליד חדש נשמר בכרטיס, ומערכת הדיוור מוסיפה אותו לרשימה.

ומה צריך בצד שלכם: כתובת שמתחילה ב-https ועונה מהאינטרנט, בדיקה של הסיסמה בכל הודעה, ותשובה תוך 15 שניות. בגוף ההודעה אין שם אירוע, ולכן נותנים לכל סוג כתובת משלו, או מוסיפים לכתובת פרמטר שמגיע שלם. ייתכן שאותה הודעה תגיע פעמיים, ולכן מזהים כפילויות לפי המזהה שבה, למשל מספר הליד או מספר המסמך. הפירוט המלא במדריך על קליטת ההודעה שברשימה למעלה.

 

הטופס הזנת אירוע חדש בביג בוס עם סוג האירוע הוספת ליד, מתג פעיל, מפתח Api וכתובת נקודת הקצה לדוגמה

טופס אירוע: סוג הפעולה, סיסמה בשדה "מפתח Api" וכתובת https שתקבל את ההודעה.

 

החלון רשימת האירועים בביג בוס עם הסוגים הוספת ליד, הוספת לקוח, הוספת ספק, הוספת פריט והפקת מסמך

בורר סוגי האירועים: 14 סוגים, והחלק הראשון שלהם.

 

מה רואים במסכים

  • רשימת האירועים: "רש' אירועים", ובכל שורה "סוג האירוע", "מפתח Api", "כתובת נקודת הקצה" ו"סטטוס", וסמל פח למחיקה. לחיצה על שורה פותחת את "פרטי אירוע".
  • בטלפון: הכתובת מופיעה בשורה "כתובת קצה:" מתחת לכל אירוע, והכפתור להוספת אירוע הוא + עגול.
  • הטופס: סוג האירוע, מתג "פעיל" או "לא פעיל", סיסמה וכתובת. הטופס מתריע על שדה ריק ועל כתובת שאינה https, ואינו שומר פעמיים את אותו סוג עם אותה כתובת: "אירוע זה כבר קיים במערכת".
  • בורר סוגי האירועים: 14 הסוגים, בשמות כמו "הוספת ליד", "הפקת מסמך" ו"עדכון מלאי".

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

 

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

רשימת האירועים במחשב. עמודת הכתובת מטושטשת.

 

רשימת האירועים בביג בוס במסך טלפון, עם השורה כתובת קצה מתחת לכל אירוע וכפתור הוספה עגול

אותה רשימה בטלפון. הכתובות מטושטשות.

 

מה התוסף לא עושה

כדי שלא תבנו תהליך עבודה על יכולת שאינה קיימת, אלה הגבולות היום:

  • הכיוון הוא אחד. ביג בוס רק שולחת, ואין בתוסף קליטה של מידע. כדי שמערכת אחרת תיצור בביג בוס לקוחות, פריטים או מסמכים, צריך את התוסף ממשק API.
  • אין חיבורים מוכנים. ביג בוס שולחת לכתובת שקבעתם, ואת הקליטה בונים בצד שלכם.
  • אין במסך יומן משלוחים, אירוע בדיקה, התראה על כישלון או שליחה חוזרת ידנית. בודקים שההודעות מגיעות בצד המקבל.
  • המצב "לא פעיל" לא עוצר היום את השליחה. כדי להפסיק לשלוח, מוחקים את האירוע מהרשימה.
  • כתובת אחת לכל סוג אירוע. אם מוגדרים שני אירועים מאותו סוג, רק הוותיק מביניהם מקבל את ההודעות. כדי להחליף כתובת, עורכים את האירוע הקיים או מוחקים אותו לפני שמוסיפים חדש.
  • אין סינון ואין בחירת שדות. נשלחים כל הפרטים של הרשומה, על כל פעולה מהסוג שנבחר.
  • אין חתימת HMAC ואין רשימת כתובות IP. האימות היחיד הוא הסיסמה שבחרתם, שנשלחת בכל הודעה.
  • לא כל פעולה שולחת הודעה. לקוח שנפתח בקופה או מתוך מסמך, ליד שהופך ללקוח, ביטול של מסמך, העברה בין מחסנים, ספירת מלאי שנסגרת במסך ומשימות ב-CRM לא שולחים כלום.

 

מדוע לבחור בשליחת האירועים של ביג בוס?

  • מאותה מערכת שבה העסק עובד: ההודעות יוצאות מהמקום שבו מנהלים את הלידים, הלקוחות, המסמכים והמלאי, בלי ייצוא ובלי העתקה.
  • 14 סוגי אירועים: הוספה, עדכון ומחיקה של לידים, לקוחות, ספקים ופריטים, הפקת מסמך מכירה ושינוי בכמות במלאי.
  • פורמט שכל מערכת מכירה: בקשת POST עם JSON, שאפשר לקלוט בקוד או בכלי חיבור של צד שלישי.
  • הגדרה קצרה: טופס אחד לכל אירוע, עם סוג, סיסמה וכתובת.
  • ניסיונות חוזרים: כשהמערכת שלכם לא עונה, ביג בוס מנסה שוב, עד שלושה ניסיונות.
  • עובד לצד ממשק ה-API: מה שנוצר דרך ה-API, כמו לקוח או מסמך, שולח גם הוא הודעה, כשמוגדר לו אירוע.
  • גם בטלפון: את רשימת האירועים ואת טופס האירוע אפשר לפתוח גם במסך טלפון, ולעדכן או למחוק אירוע גם כשאתם לא מול המחשב.

 

התחילו עכשיו!

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

45 ימי הניסיון בחינם שלך מתחילים ביצירת חשבון :)

פותחים חשבון ומתחילים לעבוד. אין חיוב, אין כרטיס אשראי, ואפשר להפסיק בכל רגע: 45 יום מלאים.

🔒 הפרטים מוצפנים ומאובטחים

- נרשמים עכשיו ומתחילים -