WhatsApp Business API Koexistenzmodus: WhatsApp Business App neben der API verwenden

Der Koexistenzmodus ermöglicht es Ihnen, die WhatsApp Business App auf Ihrem Telefon gleichzeitig mit der WhatsApp Business Cloud API zu verwenden. Das bedeutet, Sie können Ihre vertraute WhatsApp Business App weiterhin für direkte Gespräche nutzen und gleichzeitig die erweiterten Funktionen der API wie Vorlagennachrichten, automatisierte Workflows und Massennachrichten über WhatsTeam einsetzen.

Was ist der Koexistenzmodus?

Der Koexistenzmodus ist eine von Meta eingeführte Funktion, die es ermöglicht, eine einzelne WhatsApp Business-Telefonnummer gleichzeitig mit der WhatsApp Business App und der WhatsApp Business Cloud API zu verbinden. Zuvor wurde durch die Registrierung einer Nummer bei der API die Verbindung zur WhatsApp Business App vollständig getrennt, sodass Unternehmen sich für das eine oder das andere entscheiden mussten.

Mit aktiviertem Koexistenzmodus:

• Ihre Telefonnummer bleibt in der WhatsApp Business App aktiv
• Dieselbe Nummer ist auch über WhatsTeam mit der Cloud API verbunden
• Empfangene Nachrichten werden sowohl an die App als auch an die API zugestellt
• Sie können Nachrichten sowohl von der App als auch von der API senden
• Geschäftsprofilinformationen werden über beide Verbindungen geteilt

Dies gibt Unternehmen die Flexibilität, schnelle, persönliche Gespräche direkt vom Telefon zu führen und gleichzeitig die Plattform von WhatsTeam für automatisierte Nachrichten, Teamzusammenarbeit und Kampagnenmanagement zu nutzen.

Warum den Koexistenzmodus verwenden?

Der Koexistenzmodus ist ideal für Unternehmen, die das Beste aus beiden Welten wollen. Hier sind drei häufige Szenarien, in denen er sinnvoll ist:

Szenario 1: Schrittweise Migration von der App zur API

Wenn Ihr Unternehmen die WhatsApp Business App genutzt hat und zur Cloud API migrieren möchte, ermöglicht der Koexistenzmodus einen schrittweisen Übergang. Sie können die API für automatisierte Nachrichten und Kampagnen nutzen und gleichzeitig die täglichen Gespräche über die App abwickeln. Dies vermeidet Unterbrechungen und gibt Ihrem Team Zeit, sich an die neue Plattform zu gewöhnen.

Szenario 2: Außendienst- und Büroteams arbeiten zusammen

Unternehmen mit Außendienstmitarbeitern (Vertriebsmitarbeiter, Lieferpersonal, Techniker vor Ort) benötigen oft die WhatsApp Business App für schnelle Kommunikation unterwegs. Gleichzeitig braucht das Büroteam die API zur Verwaltung von Kundensupport-Warteschlangen, zum Versand von Massenbenachrichtigungen und für Marketingkampagnen. Der Koexistenzmodus ermöglicht es beiden Teams, von derselben Nummer aus zu arbeiten, ohne sich gegenseitig zu stören.

Szenario 3: Persönliche Note mit Automatisierung

Einige Unternehmen möchten die persönliche Note beibehalten, indem sie VIP-Kunden oder hochwertige Gespräche über die App beantworten, während routinemäßige Nachrichten (Bestellbestätigungen, Terminerinnerungen, Versand-Updates) über die API automatisiert werden. Der Koexistenzmodus ermöglicht diesen hybriden Ansatz.

Wichtige Informationen

Bevor Sie den Koexistenzmodus aktivieren, sollten Sie einige wichtige Details zu Einschränkungen, Anforderungen, Preisen und Nachrichtensynchronisierung beachten.

Einschränkungen

• Nachrichtenverlauf: Wenn Sie die Koexistenz erstmals aktivieren, wird der bestehende Nachrichtenverlauf der WhatsApp Business App nicht zur API migriert und umgekehrt. Beide Systeme beginnen mit ihren eigenen Nachrichtenaufzeichnungen ab diesem Zeitpunkt
• Gruppen: Nachrichten, die in WhatsApp-Gruppen gesendet und empfangen werden, sind nur in der WhatsApp Business App sichtbar. Gruppennachrichten werden über die Cloud API nicht unterstützt
• Statusmeldungen: WhatsApp-Status (Stories) können nur über die WhatsApp Business App gepostet und angesehen werden, nicht über die API
• Anrufe: Sprach- und Videoanrufe sind nur über die WhatsApp Business App verfügbar. Die Cloud API unterstützt keine Anruffunktionen
• Broadcast-Listen: In der WhatsApp Business App erstellte Broadcast-Listen werden nicht zur API synchronisiert. Verwenden Sie stattdessen Vorlagennachrichten über die API für Massennachrichten
• Katalogverwaltung: Während sowohl die App als auch die API Kataloge unterstützen, kann es dauern, bis Änderungen in einem System im anderen sichtbar werden

Anforderungen

Um den Koexistenzmodus zu nutzen, benötigen Sie:

• WhatsApp Business App: Die neueste Version, installiert auf Ihrem Telefon (Android oder iOS)
• WhatsApp Business Cloud API-Konto: Eingerichtet über den Embedded Signup-Flow von WhatsTeam
• Meta Business Manager: Ein verifiziertes Meta Business Manager-Konto
• Gleiche Telefonnummer: Die Nummer muss sowohl in der App als auch bei der API registriert sein
• Stabile Internetverbindung: Sowohl das Telefon als auch WhatsTeam müssen zuverlässigen Internetzugang haben

Preise

Der Koexistenzmodus selbst verursacht keine zusätzlichen Kosten. Es gelten jedoch die Standard-Preise der WhatsApp Business API:

• Über die API gesendete Nachrichten (über WhatsTeam) unterliegen Metas gesprächsbasierter Preisgestaltung
• Direkt über die WhatsApp Business App gesendete Nachrichten sind kostenlos (keine API-Gebühren)
• Eingehende Nachrichten werden sowohl an die App als auch an die API zugestellt, zählen aber für Abrechnungszwecke nur als ein Gespräch
• Ihr WhatsTeam-Plattformabonnement gilt wie üblich

Detaillierte Preisinformationen finden Sie in unserem WhatsApp Business API Preisleitfaden.

Hinweise zur Nachrichtensynchronisierung

Das Verständnis, wie Nachrichten zwischen App und API synchronisiert werden, ist entscheidend für die Verwaltung von Kundengesprächen:

• Eingehende Nachrichten: Wenn ein Kunde eine Nachricht sendet, wird sie gleichzeitig an die WhatsApp Business App und die Cloud API zugestellt
• Ausgehende Nachrichten von der App: Nachrichten, die Sie über die WhatsApp Business App senden, sind in der App sichtbar, werden aber nicht zur API synchronisiert. WhatsTeam wird diese Nachrichten nicht sehen
• Ausgehende Nachrichten von der API: Über WhatsTeam (API) gesendete Nachrichten werden an den Kunden zugestellt, sind aber nicht in der WhatsApp Business App sichtbar
• Lesebestätigungen: Wenn Sie eine Nachricht in der App lesen, wird die Lesebestätigung an den Kunden gesendet. Die API zeigt die Nachricht möglicherweise weiterhin als ungelesen an
• Tippindikatoren: Tippindikatoren aus der App werden nicht an die API weitergeleitet und umgekehrt

Best Practice: Legen Sie klare interne Richtlinien fest, welche Gespräche über die App und welche über die API abgewickelt werden, um doppelte Antworten oder verpasste Nachrichten zu vermeiden.

So aktivieren Sie den Koexistenzmodus

Folgen Sie diesen vier Schritten, um den Koexistenzmodus für Ihre WhatsApp Business-Nummer über WhatsTeam zu aktivieren.

Schritt 1: Embedded Signup abschließen

Wenn Sie Ihre WhatsApp Business-Nummer noch nicht über die Cloud API mit WhatsTeam verbunden haben, müssen Sie zuerst den Embedded Signup-Flow abschließen.

1. Melden Sie sich in Ihrem WhatsTeam-Dashboard an
2. Navigieren Sie zu Geräte > Gerät hinzufügen > WhatsApp Business API
3. Klicken Sie auf Mit Facebook verbinden, um den Embedded Signup-Flow zu starten
4. Folgen Sie den Anweisungen, um Ihren Meta Business Manager zu verbinden und ein WhatsApp Business Account auszuwählen oder zu erstellen

Schritt 2: Telefonnummer registrieren

Während des Embedded Signup werden Sie aufgefordert, Ihre Telefonnummer bei der Cloud API zu registrieren.

1. Geben Sie Ihre Geschäftstelefonnummer im internationalen Format ein
2. Wählen Sie Ihre bevorzugte Verifizierungsmethode (SMS oder Sprachanruf)
3. Geben Sie den erhaltenen Verifizierungscode ein
4. Warten Sie auf den Abschluss der Registrierung

Wichtig: Wenn Ihre Nummer derzeit in der WhatsApp Business App aktiv ist, wird eine Aufforderung angezeigt, ob Sie den Koexistenzmodus aktivieren möchten. Wählen Sie Ja, um Ihre Nummer sowohl in der App als auch bei der API aktiv zu halten.

Schritt 3: Koexistenz in WhatsTeam aktivieren

Sobald Ihre Nummer bei der Cloud API registriert ist, aktivieren Sie den Koexistenzmodus über die Geräteeinstellungen.

1. Gehen Sie in WhatsTeam zu Geräte und wählen Sie Ihr neu verbundenes WABA-Gerät
2. Öffnen Sie das Einstellungen-Panel des Geräts
3. Finden Sie den Koexistenzmodus-Schalter
4. Schalten Sie ihn auf Aktiviert
5. Bestätigen Sie die Aktion bei Aufforderung

Schritt 4: In Ihrer WhatsApp Business App bestätigen

Nach der Aktivierung der Koexistenz in WhatsTeam überprüfen Sie, ob die Verbindung in Ihrer WhatsApp Business App aktiv ist.

1. Öffnen Sie die WhatsApp Business App auf Ihrem Telefon
2. Gehen Sie zu Einstellungen > Verknüpfte Geräte
3. Sie sollten eine aktive API-Verbindung sehen
4. Überprüfen Sie, dass Sie weiterhin Nachrichten von der App senden und empfangen können

Ihre Koexistenz-Einrichtung ist nun abgeschlossen. Sie können sowohl die WhatsApp Business App als auch WhatsTeam gleichzeitig mit derselben Nummer verwenden.

So deaktivieren Sie den Koexistenzmodus

Wenn Sie den Koexistenzmodus nicht mehr nutzen möchten, können Sie ihn jederzeit deaktivieren. Dadurch wird die WhatsApp Business App von der geteilten Nummer getrennt, und nur die Cloud API-Verbindung bleibt aktiv.

Schritte zum Deaktivieren

1. In WhatsTeam: Navigieren Sie zu Geräte > wählen Sie Ihr WABA-Gerät > Einstellungen
2. Koexistenz ausschalten: Schalten Sie den Koexistenzmodus-Schalter auf Deaktiviert
3. Aktion bestätigen: Ein Bestätigungsdialog erscheint mit der Warnung, dass die WhatsApp Business App den Zugang zu dieser Nummer verliert. Klicken Sie auf Bestätigen
4. Auf dem Telefon überprüfen: Öffnen Sie die WhatsApp Business App und prüfen Sie Einstellungen > Verknüpfte Geräte. Die API-Verbindung sollte nicht mehr angezeigt werden
5. Auf Abschluss warten: Der Trennungsvorgang kann einige Minuten dauern, bis er vollständig verbreitet ist

Was passiert beim Deaktivieren

• Die WhatsApp Business App wird von der Nummer getrennt
• Die Nummer funktioniert weiterhin ausschließlich über die Cloud API und WhatsTeam
• Der Nachrichtenverlauf in der WhatsApp Business App bleibt auf dem Gerät, aber es werden keine neuen Nachrichten empfangen
• Alle zukünftigen Nachrichten sind nur über WhatsTeam zugänglich
• Sie können die Koexistenz später erneut aktivieren, indem Sie die Einrichtungsschritte erneut befolgen

Koexistenz erneut aktivieren

Wenn Sie die Koexistenz nach dem Deaktivieren erneut aktivieren möchten:

1. Öffnen Sie die WhatsApp Business App auf Ihrem Telefon
2. Möglicherweise müssen Sie Ihre Telefonnummer in der App erneut verifizieren
3. Befolgen Sie die oben beschriebenen Aktivierungsschritte in WhatsTeam
4. Bestätigen Sie die Verbindung auf Ihrem Telefon

Funktionsvergleich: Nur App vs. Nur API vs. Koexistenz

Die folgende Tabelle fasst die in jedem Modus verfügbaren Funktionen zusammen, um Ihnen bei der Entscheidung zu helfen, welche Konfiguration die richtige für Ihr Unternehmen ist.

Häufig gestellte Fragen

Kostet der Koexistenzmodus extra?

Nein. Der Koexistenzmodus selbst ist kostenlos. Die Standard-Gesprächsgebühren der WhatsApp Business API von Meta gelten für Nachrichten, die über die API gesendet werden. Nachrichten, die direkt über die WhatsApp Business App gesendet werden, verursachen keine API-Gebühren.

Kann ich die Koexistenz mit der normalen WhatsApp-App (nicht Business) verwenden?

Nein. Der Koexistenzmodus funktioniert nur mit der WhatsApp Business App. Die normale WhatsApp-App unterstützt keine Koexistenz mit der Cloud API.

Werden Kunden wissen, dass ich den Koexistenzmodus verwende?

Nein. Aus Sicht des Kunden ändert sich nichts. Er sieht dieselbe Nummer und dasselbe Geschäftsprofil, unabhängig davon, ob Sie über die App oder die API antworten.

Was passiert, wenn ich sowohl von der App als auch von der API antworte?

Der Kunde erhält beide Antworten. Es gibt keine eingebaute Deduplizierung. Deshalb ist es wichtig, interne Richtlinien festzulegen, welche Gespräche über welchen Kanal abgewickelt werden.

Kann ich Begleitgeräte mit dem Koexistenzmodus verwenden?

Ja, aber mit Einschränkungen. Begleitgeräte, die mit der WhatsApp Business App verbunden sind, funktionieren weiterhin, zeigen aber nur Nachrichten an, die über die App gesendet und empfangen wurden, nicht über die API.

Wird mein Nachrichtenverlauf übertragen, wenn ich die Koexistenz aktiviere?

Nein. Der bestehende Nachrichtenverlauf wird nicht zwischen App und API übertragen. Beide Systeme führen separate Nachrichtenaufzeichnungen ab dem Zeitpunkt, an dem die Koexistenz aktiviert wird.