Zum Inhalt springen
ASKO.CLOUDDocs

Schnellstart

In drei Schritten von der WhatsApp Business App zur API-Anbindung.

Was der Dienst macht

Mit Coexistence nutzen Sie dieselbe WhatsApp Business Nummer gleichzeitig in der WhatsApp Business App (auf dem Telefon) und in der offiziellen WhatsApp Cloud API von Meta. Ihr Team schreibt weiter in der App; Ihre Systeme empfangen und senden parallel über die API.

Wir stellen dafür bereit:

  • einen Verbindungslink, über den Sie Ihre Nummer mit der offiziellen Meta-Anmeldung verbinden,
  • Webhooks, die alle Ereignisse (eingehende Nachrichten, Status, in der App gesendete Nachrichten, Kontakte, Verlauf) an Ihr System weiterleiten,
  • eine REST-API unter https://coexistence.asko.cloud/api/v1,
  • einen MCP-Server unter https://coexistence.asko.cloud/api/mcp für Claude, ChatGPT, Cursor und andere KI-Werkzeuge.

Es gibt kein Kundenportal: Sie erhalten Ihren API-Schlüssel und Verbindungslinks von uns, alles Weitere steuern Sie per API oder MCP.

1. Nummer verbinden

  1. Öffnen Sie den Verbindungslink, den Sie von uns erhalten haben (oder erzeugen Sie einen mit POST /api/v1/connect-links).
  2. Klicken Sie auf Meta-Anmeldung laden und danach auf Mit Facebook verbinden.
  3. Melden Sie sich mit dem Facebook-Konto an, das Zugriff auf Ihr Meta Unternehmensportfolio hat, und wählen Sie „Bestehende WhatsApp Business App verbinden“.
  4. Scannen Sie den angezeigten QR-Code in der WhatsApp Business App und bestätigen Sie, ob Ihr Chatverlauf geteilt werden soll.

Voraussetzungen: WhatsApp Business App in Version 2.24.17 oder neuer, eine Nummer in einem von Meta unterstützten Land und ein Facebook-Konto mit Administratorrechten im Unternehmensportfolio.

2. Webhook einrichten

Legen Sie einen Endpunkt an, an den wir eingehende Ereignisse senden:

curl -X POST https://coexistence.asko.cloud/api/v1/webhooks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://ihr-system.example.com/whatsapp","events":["messages","smb_message_echoes"]}'

Die Antwort enthält einmalig das Signatur-Geheimnis (whsec_…). Wie Sie Signaturen prüfen, steht unter Webhooks.

Tipp: Richten Sie den Webhook vor dem Verbinden ein. Dann starten Kontakt- und Verlaufssynchronisation automatisch und nichts geht verloren.

3. Nachricht senden

curl -X POST https://coexistence.asko.cloud/api/v1/numbers/PHONE_NUMBER_ID/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"491701234567","type":"text","text":{"body":"Hallo aus der API"}}'

Die PHONE_NUMBER_ID liefert GET /api/v1/numbers. Freie Texte sind nur innerhalb von 24 Stunden nach der letzten Nachricht des Kontakts möglich – danach eine freigegebene Vorlage verwenden.