Webhooks של סטטוס

קבל במערכת שלך את סטטוס ההודעות של WhatsApp.

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

Webhook POST https://seusistema.com/webhooks/wpp

{
  "id": "evt_0123456789abcdef",
  "event": "MESSAGE_DELIVERED",
  "timestamp": "2026-09-15T10:30:00Z",
  "message": {
    "id": "msg_123",
    "status": "delivered",
    "phone": "5511999999999"
  }
}

פלו

WPP Marketing מודיע למערכת שלך כאשר הסטטוס משתנה.

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

01 אתה מספק את כתובת ה‑URL

רשום בלוח הבקרה נקודת קצה HTTPS מהמערכת שלך כדי לקבל החזרים.

02 בחר אירועים

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

03 הסטטוס משתנה

יצירה, משלוח, קריאה או שגיאה מנורמלים באותה צורה ללא קשר לחיבור הנבחר.

04 קבל ועקוב

ה-endpoint שלך מעבד את ה-payload וההיסטוריה של השליחות זמינה בלוח הבקרה וב-GET /webhooks.

אירועים זמינים ובדיקת משלוחים.

ארבעת האירועים משתמשים באותו חוזה בכל חיבור, ו־API מאפשרת לשאול את תוצאת כל ניסיון מסירה.

POST MESSAGE_CREATED

הודעה נוצרה בזרימה וקיבלה מזהה למעקב.

Criação

POST MESSAGE_DELIVERED

ההודעה נמסרה לנמען כאשר הערוץ מחזיר אישור.

Entrega

POST MESSAGE_READ

ההודעה נקראה כאשר אישור הקריאה זמין.

Leitura

POST MESSAGE_ERROR

הודעה נתקלה בשגיאה בשליחה, באימות או בעיבוד.

Erro

GET /webhooks

הצג היסטוריית משלוחים עם סטטוס, ניסיונות, תגובת HTTP ודפי־תוצאות. דורש את הסקופ webhooks:read.

Logs

שיטות עבודה מומלצות

הכן את נקודת הקצה (endpoint) שלך לקבלת אירועים חוזרים ואשר אינם בסדר.

Webhook הם משלוחים בין מערכות. ה‑backend שלך צריך להגיב במהירות, לרשום לוגים ולעבד באידמופוטנטיות.

HTTPS

השתמש ב-URL מאובטח, ציבורי ויציב כדי לקבל אירועי callback.

תגובה מהירה

השב עם HTTP 200 או 204 לאחר קבלת האירוע ועבד משימות ארוכות בתור פנימי.

Idמפוטנציה

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

יומנים

לרשום את ה-payload, התאריך, סטטוס HTTP ותוצאת העיבוד לצורכי ביקורת.

התראות

השתמש ב-MESSAGE_ERROR כדי להתריע לתמיכה או לתפעול על כשלים המוחזרים על ידי כל חיבור.

הפרדה

Webhooks של סטטוס הם תגובות מ‑WPP Marketing. כדי לשלוח אירועי מסחר מהחנות, השתמש ב‑Events API.

רוצים לעקוב אחר מסירות ושגיאות במערכת שלכם?

הגדר URL בלוח הבקרה, בחר את הסטטוסים ועקוב אחר אספקות בדוח ה-webhooks.

Configurar webhooks