Bestellung, Warenkorb, Zahlung, Versand, Stornierung oder Registrierung erfolgen im Ursprungssystem.
Events-API
Sende Ereignisse aus deinem Shop oder ERP, um Automatisierungen auf WhatsApp auszulösen.
Verwenden Sie die Events API, wenn Ihr eigenes System Warenkorb-, Bestell-, Zahlungs-, Versand-, Stornierungs- oder Kundenanlageinformationen an WPP Marketing melden muss.
Die Events API empfängt das kommerzielle Ereignis und verwendet die konfigurierten Automatisierungen. Um eine Nachricht direkt zu senden, verwenden Sie die Messaging API. Um Zustellung, Lesebestätigungen und Fehler zu verfolgen, verwenden Sie das Status-Webhooks.
Flow
Ihr System meldet das Ereignis. WPP Marketing entscheidet die Automatisierung.
Die Events API ist ideal für individuelle Shops, ERP-Systeme, Backoffices und Integrationen, die keinen Plug-and-Play-Connector haben.
Ihr Backend sendet das Ereignis mit Token, Kennung, Kunde, Werten und verfügbaren Links.
WPP Marketing prüft, ob für dieses Ereignis und diesen Kunden eine aktive Automatisierung vorhanden ist.
Der Kunde erhält WhatsApp-Nachrichten zur Wiederherstellung, Zahlung, Bestellung, Versand, Kampagne oder Nachverkauf.
Unterstützte kommerzielle Ereignisse.
Die endgültige Benennung und die Pflichtfelder müssen der Dokumentation der Events API entsprechen.
POST
cart.created
Erfasst Kaufabsicht und ermöglicht automatisierte Erste-Nachverfolgung.
Carrinho
POST
cart.abandoned
Löst Warenkorbwiederherstellung mit Erinnerung und Rückkehrlink aus, wenn verfügbar.
Recuperação
POST
order.created
Informiert über erstellte Bestellung oder ausstehende Zahlung für transaktionale Nachrichten.
Pedido
POST
order.paid
Bestätigt die Zahlung und ermöglicht eine Bestätigungsnachricht, Anweisungen und die nächsten Schritte.
Pagamento
POST
order.shipped
Sendet Versandaktualisierungen, Sendungsverfolgung oder logistischen Status, um manuelle Tickets zu reduzieren.
Envio
POST
order.cancelled
Erfasst die Stornierung der Bestellung, um die für dieses Ereignis konfigurierte Kommunikation auszulösen.
Cancelamento
POST
customer.created
Versorgt die Kontaktbasis für Begrüßungen, Beziehungsmanagement, Tags und Kampagnen.
Cliente
Empfohlene Daten
Je besser das Ereignis, desto besser die Automatisierung.
Die Events API muss ausreichend Daten erhalten, um den Kunden, den Kauf, den Betrag, den Status und nützliche Links für die Nachricht zu identifizieren.
Telefonnummer, Name, E‑Mail, Land und externe Kennung helfen bei der Duplikaterkennung und Segmentierung.
Nummer, externe ID, Gesamtbetrag, Währung, Status, Zahlungsmethode und Artikel machen die Nachricht hilfreicher.
Checkout-, Zahlungs-, Sendungsverfolgungs- oder Bestellseite können in automatischen Nachrichten verwendet werden.
Geben Sie external_id oder order.id an und halten Sie die Quelle stabil. Die Deduplizierung berücksichtigt Konto, normalisierte Quelle, Ereignistyp und externen Bezeichner. Wiederholte Ereignisse geben HTTP 200 mit dem Hinweis Duplicate event ignored zurück. Dieser Endpoint verwendet nicht den Idempotency-Key-Header der Messaging API.
HTTP 200 bestätigt die Verarbeitung des Ereignisses, nicht die Zustellung einer Nachricht. Zum Senden sind eine aktive Automatisierung für das Ereignis, gültige Kundendaten und eine konfigurierte Verbindung erforderlich. Verfolgen Sie die Nachricht über Berichte und Status-Webhooks.
Erstellen Sie eine Credential mit events:write und senden Sie Ereignisse vom Server. Halten Sie das Token aus dem Frontend und öffentlichen Repositories fern. Verwenden Sie customer.phone für die Telefonnummer und die Objekte customer und order wie im Beispiel und im OpenAPI-Vertrag.
Möchten Sie einen individuellen Shop oder ein ERP anbinden?
Öffnen Sie die Dokumentation der Events API, um Payloads, Authentifizierung und Beispiele zu prüfen, bevor Sie Produktionsereignisse senden.