הקמת Webhook חדש

הקמת Webhook חדש

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

בצעו את השלבים הבאים. לפני שמתחילים, כדאי לדעת אילו פעולות שולחות הודעה: אילו פעולות שולחות הודעה, ואילו לא.

גשו לתפריט "הגדרות מערכת" ובחרו באפשרות "ניהול WebHook".

לחצו על כפתור "חדש" בצד שמאל למעלה (בריחוף מופיע "הוספת אירוע"). בטלפון זה כפתור + עגול בתחתית המסך.

נפתח הטופס "הזנת אירוע חדש":

מסך פרטי Webhook (אירוע)

בטופס ארבעה שדות, ושלושה מהם חובה:

• "סוג האירוע": לוחצים על האייקון "עדכון אירוע" שליד השדה, מסמנים שורה בחלון "רש' אירועים" ולוחצים "בחר אירוע". ברשימה 14 סוגים, כמו "הוספת ליד", "הפקת מסמך" ו"עדכון מלאי". שמירה בלי סוג מציגה "יש לעדכן את סוג האירוע".
• "פעיל" / "לא פעיל": אירוע חדש נפתח במצב "פעיל". היום גם אירוע במצב "לא פעיל" ממשיך לשלוח, ולכן כדי להפסיק לשלוח מוחקים את האירוע.
• "מפתח Api" (חובה): סיסמה שאתם בוחרים ומוסרים גם למערכת המקבלת. ביג בוס שולחת אותה בכל הודעה בכותרת Authorization: Bearer, והמערכת המקבלת בודקת שהיא נכונה. אין לשדה הזה קשר לתוסף ממשק ה-API. בלי מפתח מופיע "יש לעדכן ערך בשדה זה".
• "כתובת נקודת הקצה" (חובה): הכתובת שאליה נשלחת ההודעה. היא חייבת להתחיל ב-https, אחרת מופיע "שדה זה חייב להתחיל עם https", והיא צריכה לענות מהאינטרנט, כי כתובות פנימיות נחסמות.

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