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

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

מה אפשר לעשות עם זה

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

האירועים

קבוצה	אירועים
הודעות שנשלחו דרך ה-API	message.sent, message.delivered, message.undelivered, message.failed
תשובות	inbound.received
אנשי קשר	contact.opted_out, contact.resubscribed
קמפיינים מהמערכת	campaign.completed, campaign.cancelled
חשבון	credits.low

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

בלי קוד, דרך n8n, Make או Zapier

לא חייבים מפתח. ב-n8n, ב-Make וב-Zapier יוצרים כתובת קבלה (webhook) בתוך האוטומציה, מדביקים אותה בסנדי, ומכאן כל אירוע מפעיל את התהליך שבנית. ב-Zapier קבלת webhook זמינה רק במסלול בתשלום של Zapier. לחבר אוטומציה בלי קוד

מה שמפתח רוצה לדעת

• חתימה. כל בקשה חתומה ב-HMAC-SHA256 בכותרת Sendy-Signature, כך שאפשר לוודא שהיא באמת מסנדי. בהחלפת סוד, הסוד הקודם ממשיך לחתום במקביל 24 שעות, כדי שאפשר יהיה להחליף בלי השבתה.
• ניסיונות חוזרים. אם השרת שלך לא ענה ב-2xx תוך 10 שניות, סנדי מנסה שוב עד 8 פעמים לאורך בערך 22 שעות, ואחר כך אפשר לשלוח מחדש ידנית.
• יומן משלוחים. 30 יום של היסטוריה לכל ניסיון, עם קוד התשובה של השרת שלך.
• אותו מבנה כמו ה-API. אירוע הודעה מכיל בדיוק את מה ש-GET /v1/messages/{id} מחזיר, כך שקוד קיים ממשיך לעבוד.
• בלי סדר מובטח. אישור מסירה מאוחר יכול להגיע אחרי אירוע אחר של אותה הודעה, ולכן כדאי להסתמך על המצב שבאירוע ולא על סדר ההגעה.

המדריך הטכני המלא · התיעוד ב-API

כמה זה עולה

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

שאלות נפוצות

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

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

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

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

אפשר לקבל אירוע על כל נמען בקמפיין מהעורך? לא. קמפיין מהעורך שולח אירוע אחד בסיומו. אירוע לכל הודעה מגיע על שליחות דרך ה-API.