Status-webhooks

Ta emot WhatsApp-meddelande-status i ditt system.

Konfigurera en URL för att ta emot standardiserade händelser för skapande, leverans, läsning och fel, och kontrollera leveranshistorik via API:et oavsett vald anslutning.

Konfigurera i instrumentpanelen Visa Events 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"
  }
}

Flöde

WPP Marketing meddelar ditt system när status ändras.

Status‑webhooks är användbara för revision, avstämning, interna dashboards, support och regler i ditt eget system.

Webhooken rapporterar resultatet av ett meddelande; det är inte en sändningsförfrågan. Använd Messaging API för att skicka meddelanden och Events API för att utlösa automationer med stödda kommersiella händelser.

01 Du anger URL:en

Registrera en HTTPS-endpoint från ditt system i panelen för att ta emot återkopplingar.

02 Välj händelser

Aktivera endast de statusar som ditt system behöver bearbeta för att undvika operativt brus.

03 Status ändras

Skapande, leverans, läsning eller fel normaliseras på samma sätt oavsett vilken anslutning som valts.

04 Ta emot och spåra

Din endpoint bearbetar payloaden och leveranshistoriken blir tillgänglig i panelen och via GET /webhooks.

Tillgängliga händelser och kontroll av leveranser.

Alla fyra händelser använder samma kontrakt på vilken anslutning som helst, och API:et tillåter att fråga resultatet av varje leveransförsök.

POST MESSAGE_CREATED

Meddelandet skapades i flödet och tilldelades en identifierare för spårning.

Criação

POST MESSAGE_DELIVERED

Meddelandet levererades till mottagaren när kanalen returnerar bekräftelse.

Entrega

POST MESSAGE_READ

Meddelande lästes när läskvitto finns tillgängligt.

Leitura

POST MESSAGE_ERROR

Meddelandet stötte på ett fel vid skickande, validering eller bearbetning.

Erro

GET /webhooks

Visa leveranshistorik med status, försök, HTTP‑svar och paginering. Kräver scopet webhooks:read.

Logs

Bästa praxis

Förbered din endpoint för att ta emot upprepade och oordnade händelser.

Webhooks är leveranser mellan system. Er backend ska svara snabbt, logga händelser och bearbeta idempotent.

HTTPS

Registrera en offentlig HTTPS-URL och aktivera händelser i panelen. Nuvarande avtal skickar ingen HMAC-signatur; konfigurera lämpligt skydd och validering för mottagaren utan att förutsätta en signatur som inte finns.

Snabbt svar

Svara med HTTP 2xx inom 15 sekunder och bearbeta tidskrävande uppgifter i en intern kö. Omdirigeringar följs inte.

Idempotens

Använd händelse-id:t, som också skickas i Webhook-Id, för att undvika dubbel bearbetning och acceptera händelser utanför ordning. Webhook-Attempt anger försöksnumret. Endast aktiverade händelser loggas och skickas.

Loggar

Visa HTTP-försök och svar på GET /webhooks med webhooks:read. Avslutade, levererade eller slutgiltigt misslyckade poster sparas i 30 dagar. Skydda personuppgifter och meddelandeinnehåll i dina egna loggar.

Nya försök

Anslutsfel, timeout och svar 408, 425, 429 eller 5xx kan leda till upp till sju försök totalt, med intervaller på 1, 5 och 15 minuter samt 1, 6 och 24 timmar. Retry-After respekteras upp till 24 timmar. Andra 4xx-fel avslutar leveransen.

Separation

Status-webhooks är svar från WPP Marketing. För att skicka kommersiella butikshändelser, använd Events API.

Vill du följa leveranser och fel i ditt system?

Konfigurera en URL i panelen, välj statusar och följ leveranser i webhooks-rapporten.

Konfigurera webhooks