Mit Webhooks können Sie eingehende WhatsApp-Nachrichten und Zustellberichte automatisiert an Ihr eigenes System weiterleiten. seven.io sendet dabei HTTP-POST-Anfragen an eine von Ihnen definierte URL.
Webhook-URL konfigurieren
- Melden Sie sich unter dashboard.seven.io an.
- Navigieren Sie zu Einstellungen > Webhooks.
- Fügen Sie eine neue Webhook-URL hinzu oder bearbeiten Sie eine bestehende.
- Geben Sie die URL Ihres Endpunkts ein (muss HTTPS unterstützen).
- Wählen Sie die gewünschten Event-Typen aus.
- Speichern Sie die Konfiguration.
Stellen Sie sicher, dass Ihr Endpunkt erreichbar ist und auf eingehende POST-Anfragen mit einem HTTP-Statuscode 200 antwortet.
Event-Typen
Eingehende Nachricht (wa_mo)
Wird ausgelöst, wenn ein Nutzer eine WhatsApp-Nachricht an Ihre Nummer sendet. Der Webhook enthält unter anderem:
- Absendernummer
- Nachrichteninhalt (Text, Medien, Standort etc.)
- Zeitstempel
- Nachrichtentyp
Zustellberichte
Wird ausgelöst, wenn sich der Zustellstatus einer von Ihnen gesendeten Nachricht ändert. Mögliche Status:
- sent - Nachricht wurde an WhatsApp übergeben
- delivered - Nachricht wurde dem Empfänger zugestellt
- read - Nachricht wurde vom Empfänger gelesen
- failed - Zustellung ist fehlgeschlagen
Payload-Format
Die Webhook-Daten werden als JSON im Body der POST-Anfrage übermittelt. Ein Beispiel für eine eingehende Textnachricht:
{
"event": "wa_mo",
"from": "491701234567",
"to": "491709876543",
"timestamp": "2026-01-15T10:30:00Z",
"message": {
"type": "text",
"text": "Hallo, ich habe eine Frage zu meiner Bestellung."
}
}Bei Mediennachrichten enthält das Payload zusätzliche Felder wie die Medien-URL, den MIME-Typ und optional eine Bildunterschrift.
Empfehlungen
- Antworten Sie schnell - Ihr Endpunkt sollte innerhalb weniger Sekunden antworten. Verarbeiten Sie aufwändige Logik asynchron.
- Prüfen Sie die Absenderadresse - Validieren Sie eingehende Anfragen, um sicherzustellen, dass sie von seven.io stammen.
- Implementieren Sie Fehlerbehandlung - Loggen Sie fehlgeschlagene Webhook-Aufrufe, um Probleme frühzeitig zu erkennen.
API-Dokumentation
Detaillierte Informationen zu allen verfügbaren Webhook-Events, Payload-Feldern und Konfigurationsmöglichkeiten finden Sie in der API-Dokumentation auf seven.io.