Registreer in het dashboard een HTTPS-endpoint van uw systeem om callbacks te ontvangen.
Status-webhooks
Ontvang WhatsApp-berichtstatussen in uw systeem.
Stel een URL in om gestandaardiseerde gebeurtenissen voor aanmaak, bezorging, gelezen en fouten te ontvangen en bekijk de bezorggeschiedenis via de API, ongeacht de gekozen verbinding.
Flow
WPP Marketing informeert uw systeem wanneer de status verandert.
Status-webhooks zijn handig voor audits, reconciliatie, interne dashboards, support en regels in uw eigen systeem.
De webhook meldt het resultaat van een bericht; het is geen verzendverzoek. Gebruik de Messaging API om berichten te verzenden en de Events API om automatiseringen te activeren met ondersteunde commerciële gebeurtenissen.
Schakel alleen de statussen in die uw systeem moet verwerken om operationele ruis te voorkomen.
Aanmaken, bezorging, lezen of fout worden op dezelfde manier genormaliseerd, ongeacht de gekozen verbinding.
Je endpoint verwerkt de payload en de aflevergeschiedenis wordt beschikbaar in het dashboard en via GET /webhooks.
Beschikbare gebeurtenissen en controle van leveringen.
Alle vier gebeurtenissen gebruiken hetzelfde contract op elke verbinding, en de API maakt het mogelijk het resultaat van elke bezorgpoging op te vragen.
POST
MESSAGE_CREATED
Bericht is in de flow aangemaakt en kreeg een identificator voor tracking.
Criação
POST
MESSAGE_DELIVERED
Bericht is afgeleverd bij de ontvanger wanneer het kanaal bevestiging teruggeeft.
Entrega
POST
MESSAGE_READ
Bericht is gelezen wanneer ontvangstbevestiging beschikbaar is.
Leitura
POST
MESSAGE_ERROR
Bericht ondervond een fout tijdens het verzenden, valideren of verwerken.
Erro
GET
/webhooks
Bekijk bezorggeschiedenis met status, pogingen, HTTP‑respons en paginering. Vereist de scope webhooks:read.
Logs
Beste praktijken
Bereid uw endpoint voor op het ontvangen van herhaalde en niet-op-orde binnenkomende gebeurtenissen.
Webhooks zijn afleveringen tussen systemen. Je backend moet snel reageren, logs vastleggen en idempotent verwerken.
Registreer een openbare HTTPS-URL en schakel evenementen in het dashboard in. Het huidige contract stuurt geen HMAC-handtekening; configureer passende bescherming en validatie voor de ontvanger zonder een niet-bestaande handtekening aan te nemen.
Reageer met een HTTP 2xx binnen 15 seconden en verwerk langdurige taken in een interne wachtrij. Redirects worden niet gevolgd.
Gebruik het event-id, dat ook in Webhook-Id wordt gestuurd, om dubbele verwerking te voorkomen en gebeurtenissen buiten volgorde te accepteren. Webhook-Attempt geeft het pogingsnummer aan. Alleen ingeschakelde gebeurtenissen worden geregistreerd en verzonden.
Bekijk HTTP-pogingen en -reacties op GET /webhooks met webhooks:read. Voltooide, afgeleverde of definitief mislukte records worden 30 dagen bewaard. Bescherm persoonlijke gegevens en berichtinhoud in uw eigen logs.
Verbindingsfouten, time-outs en antwoorden 408, 425, 429 of 5xx kunnen in totaal tot zeven pogingen veroorzaken, met intervallen van 1, 5 en 15 minuten en 1, 6 en 24 uur. Retry-After wordt tot 24 uur gerespecteerd. Andere 4xx-fouten stoppen de levering.
Status-webhooks zijn antwoorden van WPP Marketing. Gebruik de Events API om commerciële winkelgebeurtenissen te verzenden.
Wilt u leveringen en fouten in uw systeem volgen?
Stel een URL in op het dashboard, kies de statussen en volg leveringen in het webhooks-rapport.