Webhook הוא קריאת HTTP שמערכת אחת שולחת אוטומטית לכתובת שהגדרתם בשרת שלכם, ברגע שקורה אירוע מסוים. במקום שהקוד שלכם ישאל כל כמה שניות "ההודעה נמסרה כבר?", המערכת ששלחה את ההודעה מודיעה לכם ברגע שזה קרה.
ההבדל בין Webhook ל-API
ב-API רגיל אתם היוזמים: שולחים בקשה ומקבלים תשובה. ב-Webhook הכיוון הפוך: אתם נותנים כתובת, והמערכת פונה אליכם כשיש מה לספר. שני הכיוונים משלימים זה את זה. שולחים הודעה דרך ה-API, ומקבלים את חיווי המסירה שלה ב-Webhook, בלי לדגום.
ממה Webhook בנוי
- כתובת (endpoint): URL בשרת שלכם שמקבל בקשות POST.
- אירוע: מה קרה, למשל הודעה נמסרה, התקבלה תשובה, איש קשר ביקש להסיר את עצמו.
- גוף הבקשה: פרטי האירוע ב-JSON.
- חתימה: ערך מוצפן שמוכיח שהבקשה באמת הגיעה מהמערכת ולא ממישהו שמתחזה לה. תמיד מאמתים אותה לפני שפועלים.
איך זה נראה ב-Sendy
מגדירים כתובת HTTPS אחת, בוחרים לאילו אירועים להירשם, ו-Sendy שולחת בקשה חתומה על כל אירוע: הודעה שנשלחה דרך ה-API נשלחה, נמסרה או נכשלה, תשובה שהתקבלה למספר הווירטואלי, איש קשר שהסיר את עצמו, קמפיין שהסתיים, ויתרת קרדיטים נמוכה. קמפיין שנבנה בממשק מדווח פעם אחת בסיומו, ולא על כל נמען בנפרד.