WPP Marketing
Taal en valuta
Inloggen
Casestudy's Pakketten
Zoeken op site
Taal en valuta
Events-API

Stuur events van je winkel of ERP om automatiseringen in WhatsApp te activeren.

Gebruik de Events API wanneer uw eigen systeem een winkelwagen, bestelling, betaling, verzending, annulering of klantaanmaak aan WPP Marketing moet melden.

De Events API ontvangt het commerciële event en gebruikt de geconfigureerde automatiseringen. Om een bericht direct te verzenden, gebruik de Messaging API. Om levering, leesbevestigingen en fouten te volgen, gebruik de status-webhooks.

Flow

Uw systeem meldt het evenement. WPP Marketing bepaalt de automatisering.

De Events API is ideaal voor aangepaste winkels, ERP-systemen, backoffices en integraties die geen plug-and-play-connector hebben.

01 Gebeurtenis vindt plaats

Bestelling, winkelwagen, betaling, verzending, annulering of registratie vindt plaats in het bronsysteem.

02 Systeem verzendt payload

Je backend stuurt het evenement met token, identificatie, klant, waarden en beschikbare links.

03 Regel wordt geëvalueerd

WPP Marketing controleert of er een actieve automatisering is voor dat evenement en die klant.

04 Bericht verzonden

De klant ontvangt WhatsApp-berichten voor herstel, betaling, bestelling, verzending, campagne of nazorg.

Ondersteunde commerciële gebeurtenissen.

De uiteindelijke naamgeving en verplichte velden moeten voldoen aan de documentatie van de Events API.

POST cart.created

Registreert aankoopintentie en maakt initiële follow-up-automatiseringen mogelijk.

Carrinho
POST cart.abandoned

Activeert winkelwagenherstel met een herinnering en terugkeerlink wanneer beschikbaar.

Recuperação
POST order.created

Meldt bestelling aangemaakt of in afwachting van betaling voor transactionele berichten.

Pedido
POST order.paid

Bevestigt betaling en maakt een bevestigingsbericht, instructies en volgende stappen mogelijk.

Pagamento
POST order.shipped

Verstuurt verzendupdates, tracking of logistieke status om handmatige tickets te verminderen.

Envio
POST order.cancelled

Registreert de annulering van de bestelling om de voor dit evenement geconfigureerde communicatie te activeren.

Cancelamento
POST customer.created

Voedt de contactendatabase voor welkomstberichten, relatiebeheer, tags en campagnes.

Cliente
Aanbevolen gegevens

Hoe beter het evenement, hoe beter de automatisering.

De Events API moet voldoende gegevens ontvangen om de klant, aankoop, bedrag, status en nuttige links voor het bericht te identificeren.

Klant

Telefoonnummer, naam, e‑mail, land en externe identifier helpen bij deduplicatie en segmentatie.

Bestelling

Nummer, externe ID, totaal, valuta, status, betaalmethode en items maken het bericht nuttiger.

Links

Checkout-, betaal-, tracking- of bestelpagina kan worden gebruikt in automatische berichten.

Idempotentie

Geef external_id of order.id op en houd de bron stabiel. Deduplificatie houdt rekening met account, genormaliseerde bron, gebeurtenistype en externe identifier. Herhaalde gebeurtenissen geven HTTP 200 terug met de melding Duplicate event ignored. Deze endpoint gebruikt niet de Idempotency-Key-header van de Messaging API.

Antwoord

HTTP 200 bevestigt dat het evenement is verwerkt, niet dat een bericht is afgeleverd. Verzenden vereist een actieve automatisering voor het evenement, geldige klantgegevens en een geconfigureerde verbinding. Volg het bericht via rapporten en status-webhooks.

Beveiliging

Maak een credential met events:write en verstuur events vanaf de server. Houd de token buiten de frontend en openbare repositories. Gebruik customer.phone voor het telefoonnummer en de customer- en order-objecten zoals in het voorbeeld en het OpenAPI-contract.

Wil je een aangepaste winkel of ERP koppelen?

Open de documentatie van de Events API om payloads, authenticatie en voorbeelden te valideren voordat je productie-evenementen verzendt.

Swagger openen