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.
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.
Das Team antwortet vom Telefon aus. Nichts lässt sich automatisieren, anbinden oder messen.
Keine APISoftware erreicht die Nummer. Die Business App funktioniert darauf nicht mehr, und das Team muss das Werkzeug wechseln.
Keine AppMeta 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.
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 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.
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.
Noch ist nichts verbunden. Hier entscheidet sich, wo Nachrichten ankommen. Anbieter im WegAuf deren Servern gespeichertDeren PlattformEmpfängt und speichert NachrichtenSieEine Kopie, nach deren ZeitplanEasyCoexistenceNur KonfigurationIhr EndpointNoch nicht verifiziertWirWir legen die Route fest, wir liegen nicht daraufMetas 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.
Die zweite Oberfläche kommt hinzu. Die erste wird nicht entfernt. Nach einer MigrationEine OberflächeNur Cloud APIBusiness App auf dieser Nummer totNach CoexistenceZwei OberflächenWhatsApp Business AppDieselben Chats und derselbe VerlaufCloud APIAuf derselben LeitungDie 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.
Welche Ereignisse wohin gehen, sobald das Override aktiv ist. Operative EreignisseAn uns zugestelltNachrichtenwegAn Sie zugestelltmessagesAlles, was ein Kunde sendetsmb_message_echoesWas das Team aus der App sendetIhr ServerDirekt, nie über unsAktiv 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.
Was eine erneute Verbindung von selbst wiederherstellt und was neu gesetzt werden muss. Von Meta wiederhergestelltAutomatischSendenDie Cloud API funktioniert wiederOperative EreignisseDas Monitoring läuft weiterMit der App verlorenMuss neu gesetzt werdenIhr Webhook-OverrideMit der App deinstalliertZustellung an SieHört still aufWir 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.
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.
messagesAlles, was ein Kunde an die Nummer sendetsmb_message_echoesWas Ihr Team aus der WhatsApp Business App sendet
account_updateVerbindungsstatus: entfernt, abgemeldet, wieder verbunden, eingeschränktphone_number_quality_updateÄnderungen der Qualitätsbewertung und des Durchsatzesaccount_alertsWarnungen, die Meta zum Konto auslöstaccount_review_updateErgebnisse einer Prüfung durch Metabusiness_capability_updateÄnderungen am Nachrichtenlimit und an Funktionenphone_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.
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.
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.
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.
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.
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.
Typische Dauer, um eine Nummer per Code-Scan aus der WhatsApp Business App zu verbinden.
Wie lange die Antwort eines Kunden die Sitzung für Freitextantworten offenhält.
Versanddurchsatz einer Coexistence-Nummer, von Meta festgelegt und nicht erhöhbar.
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.