AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Wie Sie WhatsApp mit Embedded Signup und Coexistence in Ihr SaaS integrieren

Ein SaaS-Produkt fügt WhatsApp hinzu, indem es die bestehende Nummer jedes Kunden über Embedded Signup mit Coexistence verbindet, sodass die Nummer weiter in der WhatsApp Business App funktioniert. Mit der Partner API von easyCoexistence führt eine Connect-Session pro Kunde diesen Ablauf auf einer gehosteten Seite aus. Meta liefert die Nachrichten der Nummer an Ihre webhook_url, und Ihr Backend antwortet über die Cloud API mit dem eigenen Token des Kunden.

20 mps

Feste Durchsatzrate einer Nummer, die sowohl mit der WhatsApp Business App als auch mit der Cloud API genutzt wird.

2.24.17

Die älteste Version der WhatsApp Business App, mit der sich die Nummer eines Kunden über Coexistence verbinden lässt.

180 days

Wie weit zurück der Chatverlauf reicht, den Meta beim Onboarding teilen kann; er muss innerhalb von 24 Stunden synchronisiert werden.

24 hours

Das Kundenservice-Fenster von WhatsApp nach einer Nachricht oder einem Anruf des Nutzers; jede neue Nachricht setzt es zurück.

October 15, 2026

Das Datum, an dem Meta Embedded Signup v2 und v3 eingestellt hat; Integrationen wurden auf v4 umgestellt.

Aus welchen Teilen besteht eine WhatsApp-Integration?

Fünf, und easyCoexistence übernimmt den ersten und den letzten. Ihr Produkt behält die Gesprächslogik, das Postfach und alles, was Ihr Modell oder das Personal Ihrer Kunden schreibt, während Meta die Nachrichten zwischen der Nummer und Ihrem Server transportiert:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

Was ändert Coexistence für Ihre Kunden?

Sie behalten ihre Nummer und ihr Telefon. Die WhatsApp Business App läuft weiter neben der Cloud API, sodass das Personal am Telefon antwortet, während Ihr Produkt über die API antwortet. Was aus der App gesendet wird, erreicht Ihren Webhook als smb_message_echoes. Damit gehen drei Einschränkungen einher: Die Nummer sendet mit festen 20 Nachrichten pro Sekunde, nur die API kann Templates senden, und Meta trennt die Nummer, wenn das Telefon etwa 14 Tage inaktiv bleibt.

Wie sieht der Verbindungsschritt in Ihrem Produkt aus?

Ein Button „WhatsApp verbinden“ ruft von Ihrem Backend POST /connect-sessions auf, mit einer redirect_url, der ID Ihres Kunden als external_ref und webhook_url mit webhook_verify_token. So leitet Meta die Nummer ab der ersten Minute an Sie weiter. Der Kunde bestätigt auf der gehosteten Seite eine kurze Checkliste, durchläuft das Popup von Meta, scannt einen QR-Code mit der WhatsApp Business App und kehrt mit einer connection_id zu Ihnen zurück. Ob Sie Embedded Signup stattdessen aus Ihrer eigenen Tech-Provider-App ausführen, wird im Leitfaden zu Embedded Signup abgewogen.

Wie gelangen Nachrichten zu Ihrem Backend?

Direkt von Meta an die webhook_url, ohne Zwischenstation bei easyCoexistence und ohne gespeicherte Kopie. Das Feld messages enthält, was Kunden senden, und den Status dessen, was Sie senden. smb_message_echoes enthält, was das Personal aus der App sendet. Meta signiert jede Zustellung mit dem App-Secret von easyCoexistence, das nie weitergegeben wird, daher authentifiziert ein langes, zufälliges Secret im URL-Pfad die Zustellung. Zwei Nummern in einem WhatsApp Business Account teilen sich ein Ziel: Leiten Sie die Zustellung anhand von value.metadata.phone_number_id weiter.

Wie antwortet Ihr Backend und sendet Templates?

Mit der Graph API von Meta und dem Token des Kunden aus GET /connections/{id}?credentials=1, das außerdem den send_endpoint zurückgibt. Freitext wird innerhalb von 24 Stunden nach der letzten Nachricht der Person gesendet; danach nur ein Template, das Meta genehmigt hat:

  • Antwort: POST /<PHONE_NUMBER_ID>/messages mit type text, innerhalb des Fensters.
  • Template: derselbe Aufruf mit type template, einem Template-Namen und dessen Sprachcode.
  • Template anlegen: POST /<WABA_ID>/message_templates, danach den Status abfragen, da Prüfergebnisse nicht an Ihre webhook_url gelangen.
  • Medien: POST /<PHONE_NUMBER_ID>/media zum Hochladen; eingehende Medien kommen als ID, die mit demselben Token abgerufen wird.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

Kann Ihr Produkt die bestehenden Chats des Kunden importieren?

Einmalig, bei der Verbindung. Ist auf der Session eine webhook_url gesetzt, bittet easyCoexistence Meta, die Kontakte der Nummer und, wenn der Kunde in der App zustimmt, bis zu 180 Tage Chatverlauf zu senden. Diese kommen als smb_app_state_sync- und history-Webhooks an. Meta erlaubt dies nur innerhalb von 24 Stunden nach der Verbindung, daher sollte der Endpoint bereits antworten, bevor der Link verschickt wird. Der Leitfaden zum Chatverlauf beschreibt die Payloads.

Wer bezahlt Meta für die Nachrichten?

Ihr Kunde. Meta stellt die Nachrichten, die Ihr Backend über die API sendet, dem eigenen WhatsApp Business Account des Kunden in Rechnung, mit einer Zahlungsmethode, die er dort hinterlegt. Ein Unternehmen ohne Zahlungsmethode kann keine Marketing-Templates senden. easyCoexistence berechnet Ihrem Konto pro verbundener Nummer und berechnet nie Nachrichten oder schlägt Aufschläge auf die Preise von Meta.

Was passiert, wenn eine Nummer wegfällt?

Ihre Events-URL erhält connection.disconnected mit dem Grund von Meta, sofern dieser bekannt ist. PRIMARY_INACTIVITY ist die 14-Tage-Regel, und eine neue Connect-Session für diesen Kunden bringt dieselbe Nummer zurück. connection.token_missing bedeutet, dass die Nummer ohne das Token des Kunden verbunden wurde. Sie empfängt dann Nachrichten, kann aber nicht senden, bis eine neue Session sie erneut verbindet.

Häufige Fehler

  • Den Verbindungslink senden, bevor Ihr Webhook-Endpoint antwortet. Der Verlaufsimport läuft einmalig, innerhalb von 24 Stunden nach der Verbindung, und Inhalte, die gesendet werden, bevor Ihre URL funktioniert, gehen verloren.
  • Nach Ablauf des Fensters mit Freitext antworten. Sobald 24 Stunden seit der letzten Nachricht der Person vergangen sind, kommt nur noch ein genehmigtes Template durch.
  • Eine Kampagne von einer Nummer mit voller Geschwindigkeit starten. Eine Coexistence-Nummer sendet mit 20 Nachrichten pro Sekunde, also stellen Sie die Sendungen jeder Nummer mit dieser Rate in eine Warteschlange.
  • Erwarten, dass das Personal Templates vom Telefon aus sendet. In Coexistence sendet nur die API sie, also bauen Sie den Versand von Templates in Ihr Produkt ein.
Mit EasyCoexistence

easyCoexistence fügt WhatsApp mit Embedded Signup von Meta und Coexistence auf einer gehosteten Seite in Ihr SaaS ein, die Ihren Namen zeigt. Ihre Kunden behalten ihre Nummer und die WhatsApp Business App, Meta liefert die Nachrichten an Ihren Server, und Ereignisse erreichen Sie signiert. Dieselbe API verbindet Instagram, Facebook, TikTok, YouTube, LinkedIn, und weitere Kanäle kommen laufend hinzu. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Kann ein Kunde eine Nummer verbinden, die bei einem anderen WhatsApp-API-Anbieter liegt?

Nicht, solange sie dort liegt. Die gehostete Checkliste verlangt eine Nummer ohne anderen API-Anbieter oder Automatisierungstool, der Kunde trennt sie also zuerst beim bisherigen Anbieter.

Kann mein SaaS für seine Kunden WhatsApp-Templates senden?

Ja, über die Cloud API mit dem Token jedes Kunden: Erstellen Sie das Template im WhatsApp Business Account des Kunden, warten Sie auf die Prüfung durch Meta und senden Sie es dann.

Liest easyCoexistence die WhatsApp-Nachrichten meiner Kunden?

Nein. Meta liefert die Nachrichten einer Nummer direkt an die webhook_url, die Sie setzen. Eine Nummer ohne webhook_url fällt auf den Callback von easyCoexistence zurück, wo Nachrichten verworfen werden, ohne gespeichert zu werden.

Was kostet easyCoexistence pro WhatsApp-Nummer?

US$ 9 bis US$ 0.75 pro Nummer und Monat, gestaffelt nach der Gesamtzahl Ihrer Verbindungen, mit 3 Tagen kostenloser Testphase. Die Nachrichtengebühren von Meta gehen an den WhatsApp Business Account jedes Kunden.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am