AnmeldenKostenlose Testphase starten
Meta Tech Provider

Eine Nummer.App und API, gleichzeitig.

Coexistence ist Metas offizieller Modus, um die WhatsApp Business App und die Cloud API gleichzeitig unter einer Nummer zu betreiben. Das Team antwortet weiterhin vom Telefon aus, mit denselben Chats und demselben Verlauf, während Software über dieselbe Leitung sendet und empfängt.

EasyCoexistence verbindet die Nummer und überwacht anschließend die Verbindung.

Kostenlose Testphase starten3 Tage kostenlos. Bis zum Ende der Testphase wird nichts berechnet.
+1 415 555 0188
WhatsApp Business AppDas Team antwortet vom Telefon aus, wie bisher
Cloud APIIhre Systeme oder ein KI-Assistent, auf derselben Leitung
Beide Oberflächen sehen denselben Verlauf. Was die API sendet, erscheint in der App, und was das Team in der App tippt, kommt als smb_message_echoes-Ereignis an. So antwortet Software nie über einen Menschen hinweg, der bereits geantwortet hat.
Standardmäßig keine NachrichtenspeicherungBusiness App + Cloud APIMCP für Claude und ChatGPTIn 2 Minuten live

Die Entscheidung, die es früher gab und heute nicht mehr gibt

Coexistence ist keine neue API. Es ist das Ende einer Weggabelung, die fast jedes kleine Unternehmen davon abgehalten hat, irgendetwas zu automatisieren.

VorherEine Nummer, eine Wahl
Bei der App bleiben

Das Team antwortet vom Telefon aus. Nichts lässt sich automatisieren, anbinden oder messen.

Keine API
Zur API migrieren

Software erreicht die Nummer. Die Business App funktioniert darauf nicht mehr, und das Team muss das Werkzeug wechseln.

Keine App
JetztEine Nummer, beides
Eine Nummer
WhatsApp Business AppCloud API

Meta verbindet die Cloud API mit einer Nummer, die die WhatsApp Business App weiterhin nutzt. Beide Oberflächen sind auf derselben Leitung aktiv, und jede sieht, was die andere sendet.

Wer eine Nummer so betreibt

Zwei Gruppen, die von derselben Funktion Gegensätzliches wollen. Deshalb zählt die Verbindung mehr als jedes Dashboard darüber.

Behält das TelefonEin Unternehmen mit einer Nummer

Ein kleines Team, eine Nummer auf dem Lieferwagen oder am Schaufenster, und Abende, an denen dieselben vier Fragen beantwortet werden. Niemand soll ersetzt werden. Bestätigungen, Erinnerungen und die erste Antwort nach Feierabend sollen ohne einen Menschen passieren, während das Telefon für alles andere weiter funktioniert.

Viele Nummern, ein KontoEine Agentur, Beratung oder Entwickler

Viele Kunden, jeder mit einer Nummer, die niemand migrieren oder anfassen darf. Diese Nummern müssen für die selbst gebauten Systeme erreichbar sein, und die nächste muss sich ohne Verkaufsgespräch hinzufügen lassen. Coexistence ist der einzige offizielle Weg zu einer Nummer, die das Personal des Kunden noch von Hand beantwortet.

Wie eine Nummer auf beidem landet und wohin die Nachrichtenereignisse gehen

Vier Schritte. Der einzige, der das Telefon berührt, ist ein Scan, und der Schritt, der über Ihre Architektur entscheidet, ist der erste.

  1. Den Endpoint bereitstellen, bevor das Onboarding beginnt

    Meta verifiziert ein Ziel, bevor es dorthin zustellt. Es ruft Ihre URL mit einem GET auf, das hub.mode=subscribe, Ihr hub.verify_token und eine hub.challenge enthält, und Ihr Endpoint muss die rohe Challenge unverändert zurückgeben.

    Das Ziel muss HTTPS verwenden, und ein Verify-Token ist Pflicht. Wir prüfen beides, bevor der Aufruf erfolgt, sodass eine fehlerhafte URL schon bei uns scheitert, statt verbunden auszusehen und nichts zuzustellen.

    Voraussetzung
    Ein HTTPS-Endpoint, der hub.challenge auf Metas GET zurückgibt
    Dauer
    Etwa eine Minute
    Ergebnis
    Ein Ziel, das Meta in dem Moment verifizieren kann, in dem die Nummer verbunden wird
    Noch ist nichts verbunden. Hier entscheidet sich, wo Nachrichten ankommen.
    Anbieter im WegAuf deren Servern gespeichert
    Meta
    Deren PlattformEmpfängt und speichert Nachrichten
    SieEine Kopie, nach deren Zeitplan
    EasyCoexistenceNur Konfiguration
    Meta
    Ihr EndpointNoch nicht verifiziert
    WirWir legen die Route fest, wir liegen nicht darauf
  2. Metas Embedded Signup ausführen und in der App scannen

    Metas eigenes Pop-up öffnet sich. Sie wählen das Business Portfolio, das WhatsApp Business Account und die Nummer, die bereits in der WhatsApp Business App registriert ist, und bestätigen die Verbindung dann auf dem Telefon, indem Sie einen Code scannen.

    Hier entscheiden Sie auch, ob der bestehende Chatverlauf geteilt wird. Das ist eine einmalige Entscheidung beim Onboarding und lässt sich danach nicht mehr ändern. Die Business App funktioniert weiter, sobald der Scan abgeschlossen ist.

    Voraussetzung
    Zugriff auf das Business Portfolio und das Telefon mit der Nummer
    Dauer
    Zwei bis drei Minuten
    Ergebnis
    Die Cloud API, verbunden mit einer Nummer, die die App weiterhin nutzt
    Die zweite Oberfläche kommt hinzu. Die erste wird nicht entfernt.
    Nach einer MigrationEine Oberfläche
    Die Nummer
    Nur Cloud APIBusiness App auf dieser Nummer tot
    Nach CoexistenceZwei Oberflächen
    Die Nummer
    WhatsApp Business AppDieselben Chats und derselbe Verlauf
    Cloud APIAuf derselben Leitung
  3. Die Nachrichtenereignisse auf Ihr eigenes System richten

    Meta erlaubt einer App, zu überschreiben, wohin die Webhooks eines bestimmten WhatsApp Business Account zugestellt werden. Wir setzen dieses Override auf Ihre URL, wodurch die beiden Felder des Nachrichtenwegs, messages und smb_message_echoes, direkt von Meta an Sie gehen.

    Die operativen Felder behalten wir, denn daraus besteht das Monitoring: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update und phone_number_name_update. So bleibt das Dashboard nützlich, während Gesprächsinhalte uns nie berühren.

    Voraussetzung
    Der Endpoint aus Schritt eins, jetzt von Meta verifiziert
    Dauer
    Wird angewendet, sobald das Onboarding abgeschlossen ist
    Ergebnis
    Nachrichten, die von Meta direkt an Sie gehen, ohne uns im Nachrichtenweg
    Welche Ereignisse wohin gehen, sobald das Override aktiv ist.
    Operative EreignisseAn uns zugestellt
    account_updateÄnderungen des Verbindungsstatus
    phone_number_quality_updateQualität und Durchsatz
    account_review_updateErgebnisse von Prüfungen
    NachrichtenwegAn Sie zugestellt
    messagesAlles, was ein Kunde sendet
    smb_message_echoesWas das Team aus der App sendet
    Ihr ServerDirekt, nie über uns
  4. Aktiv bleiben und eine erneute Verbindung überstehen

    Meta trennt eine Coexistence-Nummer nach etwa vierzehn Tagen ohne Aktivität auf dem Hauptgerät. Diese Trennung lässt sich wieder verbinden, und wir erfassen sie als eigenen Status, statt sie wie einen Kunden zu behandeln, der gegangen ist.

    Was Teams überrascht, ist die Wirkung einer Trennung auf die Route. Meta speichert das Ziel als Override auf dem Abonnement unserer App für das Konto, deshalb deinstalliert ein PARTNER_REMOVED die App und nimmt das Override mit. Die erneute Verbindung stellt Senden und Monitoring wieder her, aber nicht Ihr Ziel. Wir setzen es automatisch neu, weil die erste Nummer, die diese Regel traf, sich sauber neu verband und still aufhörte, an den Server des Kunden zuzustellen.

    Voraussetzung
    Die App wird ab und zu auf dem Hauptgerät geöffnet
    Dauer
    Fortlaufend
    Ergebnis
    Eine überwachte Verbindung und eine Route, die eine erneute Verbindung übersteht
    Was eine erneute Verbindung von selbst wiederherstellt und was neu gesetzt werden muss.
    Von Meta wiederhergestelltAutomatisch
    SendenDie Cloud API funktioniert wieder
    Operative EreignisseDas Monitoring läuft weiter
    Mit der App verlorenMuss neu gesetzt werden
    Ihr Webhook-OverrideMit der App deinstalliert
    Zustellung an SieHört still auf
    Wir setzen es neuBei jeder erneuten Verbindung

Warum Teams eine Nummer so betreiben

  • Die Nummer behalten, die schon auf Lieferwagen, Belegen und der Website steht, samt dem mobilen Arbeitsablauf darum herum.
  • Versand über die API, Webhook-Verarbeitung und Templates hinzufügen, ohne jemanden in ein neues Werkzeug umzuziehen.
  • Den Nachrichtenverkehr aus dem gemeinsamen Posteingang eines Anbieters heraushalten, damit Gespräche nicht auf der Plattform eines anderen liegen.
  • Einer Agentur die Möglichkeit geben, viele Kundennummern in einem Konto zu führen, jede im eigenen Business Portfolio des Kunden verbunden.

Voraussetzungen und praktische Grenzen

  • Die Nummer muss bereits in der WhatsApp Business App aktiv sein. Eine Nummer in der normalen WhatsApp-App muss zuerst dorthin umziehen.
  • Das Teilen des bestehenden Chatverlaufs ist eine einmalige Entscheidung beim Onboarding und lässt sich danach nicht mehr ändern.
  • Gruppenchats sind bei Coexistence-Nummern von der API ausgeschlossen, bei jedem Anbieter.
  • Das Hauptgerät braucht regelmäßige Aktivität. Meta trennt die Verbindung nach etwa vierzehn Tagen ohne sie.
  • Metas Verifizierungs- und Abzeichenwege unterscheiden sich für Coexistence-Nummern, und die regionale Verfügbarkeit ändert sich mit Metas Richtlinien.
Freier Text0 bis 24 Stunden nach der letzten Nachricht des KundenNur Templatesdanach, bis der Kunde wieder schreibt
Die Uhr startet jedes Mal neu, wenn der Kunde etwas sendet. Diese Regel bricht Integrationen im Produktivbetrieb, weil Tests immer Sekunden nach einer Nachricht stattfinden, wenn freier Text noch funktioniert.

Was wir an Sie weiterleiten und was wir behalten

Meta erlaubt einer App, zu überschreiben, wohin ein WhatsApp Business Account seine Webhooks zustellt. Wir setzen dieses Override auf Ihre URL, wodurch sich die Ereignisse in zwei Teile aufteilen.

Direkt an Ihren Endpoint zugestelltDer Nachrichtenweg. Standardmäßig läuft er nie über uns.
  • messagesAlles, was ein Kunde an die Nummer sendet
  • smb_message_echoesWas Ihr Team aus der WhatsApp Business App sendet
An uns zugestelltDer operative Weg. Daraus besteht das Monitoring.
  • account_updateVerbindungsstatus: entfernt, abgemeldet, wieder verbunden, eingeschränkt
  • phone_number_quality_updateÄnderungen der Qualitätsbewertung und des Durchsatzes
  • account_alertsWarnungen, die Meta zum Konto auslöst
  • account_review_updateErgebnisse einer Prüfung durch Meta
  • business_capability_updateÄnderungen am Nachrichtenlimit und an Funktionen
  • phone_number_name_updateFreigaben und Ablehnungen des Anzeigenamens

Hat eine Nummer kein Override, fallen ihre Nachrichtenereignisse auf unseren Standard-Callback zurück, wo der Handler sie verwirft, ohne sie zu speichern. Das ist im Code erzwungen und nicht in einer Richtlinie versprochen: Für Gesprächsinhalte gibt es keinen Speicherpfad.

Die Vierzehn-Tage-Regel und was sie kaputt macht, ohne dass es jemand erwähnt

Meta trennt eine Coexistence-Verbindung nach etwa vierzehn Tagen ohne Aktivität auf dem Hauptgerät. Sie lässt sich wieder verbinden, deshalb speichern wir sie als eigenen Status, statt sie als Kunden zu zählen, der gegangen ist.

Die Folge, die Geld kostet, kommt danach. Das Ziel Ihrer Nachrichten ist keine Einstellung an der Nummer, sondern ein Override auf dem Abonnement unserer App für das WhatsApp Business Account. Eine Trennung deinstalliert die App, und das Override verschwindet mit ihr. Nach dem erneuten Verbinden funktioniert das Senden, das Monitoring funktioniert, und Nachrichten kommen nicht mehr auf Ihrem Server an, ohne dass irgendetwas einen Fehler meldet.

Wir setzen das Override bei jeder erneuten Verbindung neu. Dieses Verhalten gibt es, weil es passiert ist: Eine Nummer traf diese Regel, verband sich sauber neu und stellte still die Zustellung ein.

Schlägt der Handshake in diesem Moment fehl, weil Ihr Server nicht erreichbar war oder sich das Token geändert hat, wird das in der Zeitleiste der Verbindung vermerkt und das Ziel bleibt erhalten statt verworfen zu werden. Es erneut zu speichern genügt, um es zu beheben.

Was still kaputtgeht und wie wir es bemerken

Die WhatsApp Business App funktioniert bei fast jedem der folgenden Ausfälle weiter, deshalb bemerkt es niemand. Diese prüfen wir, und so.

Die Nummer wurde getrenntWebhook, maßgeblich

Erkannt über Metas account_update-Webhook, genauer PARTNER_REMOVED, statt aus einem Feld abgeleitet, das auf false springt. Wir lesen dafür bewusst nicht is_on_biz_app, weil es bei Nummern ohne Coexistence zu Recht false ist und falsche Trennungen verursacht hat.

Die Verbindung war vierzehn Tage stillEigener Status

Metas Inaktivitätsregel für das Hauptgerät. Die Verbindung lässt sich wiederherstellen, deshalb wird sie als eigener Status erfasst und nicht als Kunde, der gegangen ist, und das erneute Verbinden stellt Senden und Monitoring wieder her.

Ihre Webhook-Route ist bei einer erneuten Verbindung verschwundenAutomatisch neu gesetzt

Das Ziel liegt als Override auf dem Abonnement unserer App für das Konto, deshalb deinstalliert eine Trennung es. Das Senden kommt beim erneuten Verbinden zurück, die Zustellung an Ihren Server nicht. Wir setzen das Override jedes Mal neu, weil eine Nummer, der genau das passiert ist, sich sauber neu verband und still die Zustellung einstellte.

Das Zugriffstoken funktioniert nicht mehrZwei Tokens, eine Antwort

Wir halten das Token des Kunden und unser eigenes System User token für dasselbe Konto. Wird eines abgelehnt, liest das andere das Konto und klärt, welches der beiden tatsächlich defekt ist. So sieht ein widerrufenes Token nicht mehr wie eine verlorene Nummer aus.

Die Qualität ist gesunkenAbgefragt

Regelmäßig bei Meta abgefragt. Eine RED-Bewertung markiert die Verbindung als beeinträchtigt, und Qualität, Messaging-Stufe und Durchsatzstufe werden bei jeder Prüfung gespeichert, damit ein Rückgang sichtbar ist, bevor er einen Versand kostet.

Eine Nummer zu verbinden und eine Nummer zu überwachen sind verschiedene Produkte. Das zweite ist der Grund, warum es dieses gibt.

2 minutes

Typische Dauer, um eine Nummer per Code-Scan aus der WhatsApp Business App zu verbinden.

24 hours

Wie lange die Antwort eines Kunden die Sitzung für Freitextantworten offenhält.

20 msg/s

Versanddurchsatz einer Coexistence-Nummer, von Meta festgelegt und nicht erhöhbar.

6 months

Wie viel Chatverlauf Meta beim ersten Verbinden einer Nummer mit der API synchronisiert.

Häufig gestellte Fragen

Muss mein Team aufhören, das Telefon zu verwenden?

Nein. Genau darum geht es bei Coexistence. Die WhatsApp Business App funktioniert mit derselben Nummer und denselben Unterhaltungen weiter, während die API parallel läuft.

Verliere ich meine bestehenden Unterhaltungen?

Nein. Sie bleiben in der App, und Meta synchronisiert beim Verbinden der Nummer ungefähr sechs Monate Verlauf mit der API. So hat die Software Kontext, statt leer zu starten.

Kann ich das rückgängig machen?

Ja. Eine Nummer kann getrennt werden, und die App funktioniert weiter wie zuvor. Durch das Verbinden wird an der Nummer selbst nichts dauerhaft geändert.

Ist das dasselbe wie die inoffiziellen WhatsApp APIs?

Nein, und dieser Unterschied entscheidet darüber, ob die Nummer bestehen bleibt. Coexistence ist Metas offizielle Funktion in der Cloud API. Inoffizielle Gateways steuern WhatsApp Web als verknüpftes Gerät. Das verstößt gegen die Bedingungen und führt dazu, dass Nummern gesperrt werden.

Bereit für den Start?

Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.

Kostenlose Testphase starten3 Tage kostenlos. Bis zum Ende der Testphase wird nichts berechnet.

Weiterlesen