Zwei-Wege-Konversationen & Inbox

Messaging ist kein Fire-and-Forget. Wenn ein Kunde antwortet — auf eine SMS, eine WhatsApp-Nachricht, eine E-Mail — landet die Antwort in der Inbox, eingereiht in dieselbe Konversation und dasselbe Kontaktprofil wie alles, was Sie ihm gesendet haben.

Die Inbox

Inbox → Konversationen zeigt jeden offenen Thread über alle Kanäle. Jede Konversation zeigt die vollständige Historie (ausgehend und eingehend, alle Kanäle chronologisch verschachtelt), daneben die Kontaktkarte (Profil, Einwilligung, letzte Bestellungen) und ein Antwortfeld, das auf demselben Kanal sendet, den der Kunde verwendet hat. Konversationen haben einen Status (offen/geschlossen), sodass ein Team sie wie eine Warteschlange abarbeiten kann.

Eingehendes Routing

• SMS-Antworten kommen über die auf Ihrem Konto konfigurierten Nummern/Keywords an.
• WhatsApp-Antworten kommen über den Cloud-API-Webhook an.
• STOP-/Abmelde-Keywords werden vor der Inbox abgefangen: Der Kontakt wird sofort abgemeldet und das Compliance-Event wird erfasst — ohne Mensch in der Schleife, siehe Einwilligung.

Alles andere kann auch an Ihre eigenen Systeme weitergeleitet werden: Setzen Sie eine eingehende Webhook-URL (PUT /v1/webhook-secret/inbound-url) und jede eingehende Nachricht wird an Ihren Endpoint POSTet — so docken Buchungssysteme, Helpdesks und Bots an.

Die API

Die Konversations-API akzeptiert entweder einen API-Key (X-API-Key) oder eine Dashboard-Session (ein JWT aus POST /v1/auth/login) — eingehende Antworten müssen für eine serverseitige Integration lesbar sein, nicht nur für das Dashboard. Auflisten und Lesen eines Threads brauchen den read-Scope, Antworten braucht send, und das Ändern des Status einer Konversation braucht write; ein Key ohne den passenden Scope wird mit 403 insufficient_scope abgelehnt.

# Konversationen auflisten (nach Status filtern)
curl "https://api.wezend.com/v1/conversations?status=open" -H "X-API-Key: $WEZEND_API_KEY"

# Einen Thread lesen
curl "https://api.wezend.com/v1/conversations/cv_42/messages" -H "X-API-Key: $WEZEND_API_KEY"

# Antworten (geht auf dem Kanal der Konversation raus)
curl -X POST "https://api.wezend.com/v1/conversations/cv_42/reply" \
  -H "X-API-Key: $WEZEND_API_KEY" -H "Content-Type: application/json" \
  -d '{ "body": "Danke — Ihr neuer Termin ist Dienstag um 10:00 Uhr." }'

Eingehende Nachrichten werden ebenfalls als Events auf dem Kontakt ausgelöst, sodass eine Journey auf "Kunde hat geantwortet" verzweigen kann — die Grundlage für Bestätigungs-Flows ("Antworte JA zum Bestätigen").