WhatsApp (Cloud API)

WeZend spricht mit WhatsApp über Metas offizielle Cloud API — kein Drittanbieter dazwischen. Sie bringen Ihr eigenes Meta-Business-Konto mit; WeZend übernimmt Versand, Empfang, Zustellbestätigungen und die Verkettung von Unterhaltungen.

Was Sie von Meta brauchen

1. Ein Meta-Business-Konto mit einer WhatsApp Business App.
2. Eine Phone Number ID und ein permanentes Access Token (in Metas Entwicklerkonsole unter WhatsApp → API Setup erstellt).

Kanal verbinden

Öffnen Sie Einstellungen → Kanäle → WhatsApp und fügen Sie die Phone Number ID und das Access Token ein. Per API:

curl -X PUT https://api.wezend.com/v1/channels/whatsapp \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone_number_id": "1045…", "access_token": "EAAG…" }'

Tragen Sie anschließend die Webhook-URL von WeZend (auf derselben Einstellungsseite angezeigt) in Metas Konsole ein, damit eingehende Nachrichten und Statusupdates die Plattform erreichen.

Die 24-Stunden-Regel (wichtig!)

WhatsApp unterscheidet zwei Arten von Nachrichten:

• Sitzungsnachrichten — freier Text und Medien, nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden an Sie erlaubt.
• Vorlagennachrichten — von Meta vorab genehmigt, erforderlich, um eine Unterhaltung zu starten oder nach 24 Stunden wieder aufzunehmen.

WeZend setzt dies automatisch durch: Außerhalb des Sitzungsfensters müssen Sendungen auf eine genehmigte Vorlage verweisen.

Versand

curl -X POST https://api.wezend.com/v1/messages/send \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+4512345678", "channel": "whatsapp", "message": "Deine Bestellung #1042 wurde versendet 🎉" }'

Anhänge nutzen media_url (zuerst über POST /v1/media hochladen). Eingehende Antworten landen in Posteingang → Unterhaltungen und lösen Ihre Webhooks aus, sodass Support-Tools und Bots in Echtzeit reagieren können.