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 של סטטוס מועילים לביקורת, ייצור התאמות, לוחות מחוונים פנימיים, תמיכה וכללים במערכת שלך.

ה‑webhook מדווח על תוצאת הודעה; זה לא בקשת שליחה. השתמש ב־ Messaging API לשלוח הודעות ו Events API להפעיל אוטומציות באמצעות אירועי מסחר נתמכים.

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 ציבורית עם HTTPS והפעילו אירועים בלוח הבקרה. ההסכם הנוכחי לא שולח חתימת HMAC; קבעו הגנה ואימות מתאימים לנמען מבלי להניח קיום חתימה שאינה קיימת.

תגובה מהירה

הגב עם HTTP 2xx בתוך עד 15 שניות ועבד משימות ארוכות בתור פנימי. הפניות לא נעקבות.

Idמפוטנציה

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

יומנים

הצג ניסיונות HTTP ותשובות ב-GET /webhooks עם webhooks:read. רשומות שהושלמו, נמסרו או נכשלו סופית נשמרות למשך 30 ימים. הגן על נתונים אישיים ותוכן הודעות ביומנים שלך.

ניסיונות חדשים

שגיאות חיבור, timeout ותשובות 408, 425, 429 או 5xx עלולות לגרום עד לשבע ניסיונות בסך הכל, עם מרווחים של 1, 5 ו-15 דקות, ו-1, 6 ו-24 שעות. Retry-After נשמר עד 24 שעות. שגיאות 4xx אחרות מפסיקות את המסירה.

הפרדה

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

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

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

הגדר Webhooks