WhatsApp Koexistenzmodus: Schritt-für-Schritt-Verbindungsanleitung

Zusammenfassung

Der Koexistenzmodus ermöglicht es Ihnen, die WhatsApp Business-Mobil-App und die WhatsApp Cloud API gleichzeitig mit derselben Telefonnummer zu verwenden. Das bedeutet, Sie können weiterhin direkt von Ihrem Telefon mit Kunden chatten und gleichzeitig die leistungsstarken API-Funktionen von WhatsTeam wie automatisierte Nachrichten, Chatbots, CRM-Integrationen und Massennachrichtenkampagnen nutzen.

Dieser Leitfaden führt Sie durch alles, was Sie vor der Aktivierung der Koexistenz wissen müssen, den schrittweisen Verbindungsprozess, Preisüberlegungen und Tipps zur Fehlerbehebung.

Wichtige Informationen vor dem Start

Der Koexistenzmodus ist eine leistungsstarke Funktion, bringt aber spezifische Verhaltensänderungen und Einschränkungen mit sich, die Sie vor der Aktivierung verstehen müssen. Lesen Sie diesen Abschnitt sorgfältig, um unerwartete Probleme nach der Integration zu vermeiden.


Wichtige Punkte zum Verständnis

• Die Koexistenz befindet sich derzeit in der Beta-Phase. Meta entwickelt diese Funktion aktiv weiter, was bedeutet, dass sich einige Verhaltensweisen im Laufe der Zeit ändern können.
• Beide Kanäle teilen dieselbe Nummer. Nachrichten, die über die Mobil-App und über die API gesendet werden, stammen beide von derselben Telefonnummer. Kunden sehen einen einzigen Gesprächsverlauf.
• API-Nachrichten haben Priorität. Wenn sowohl die Mobil-App als auch die API versuchen, auf dasselbe Gespräch zu antworten, wird die API-Antwort zugestellt und die Mobil-App-Antwort kann unterdrückt werden.
• Nicht alle Mobil-App-Funktionen bleiben erhalten. Einige Funktionen, die in der Mobil-App funktionieren, verhalten sich anders oder werden nicht mehr verfügbar, sobald die Koexistenz aktiviert ist.
• Die Abrechnung gilt für API-Nachrichten. Nachrichten, die über die WhatsApp Cloud API via WhatsTeam gesendet werden, unterliegen Metas gesprächsbasierter Preisgestaltung. Nachrichten, die direkt von der Mobil-App gesendet werden, bleiben kostenlos.

Funktionsänderungen nach der Integration

Sobald Sie den Koexistenzmodus aktivieren, werden folgende Funktionen in der WhatsApp Business-Mobil-App betroffen sein:

Nachricht bearbeiten und widerrufen

• Bearbeiten: Nachrichten, die von der Mobil-App gesendet wurden, können weiterhin innerhalb des Standard-15-Minuten-Bearbeitungsfensters von WhatsApp bearbeitet werden. Nachrichten, die über die API gesendet wurden, können jedoch nach der Zustellung nicht bearbeitet werden.
• Widerrufen (Für alle löschen): Nachrichten, die von der Mobil-App gesendet wurden, können wie gewohnt widerrufen werden. Nachrichten, die über die API gesendet wurden, können nicht über die Mobil-App-Oberfläche widerrufen werden.


Verschwindende Nachrichten

• Die in der Mobil-App konfigurierten Einstellungen für verschwindende Nachrichten gelten für das Gespräch. Nachrichten, die über die API gesendet werden, erben den Timer für verschwindende Nachrichten jedoch nicht automatisch.
• Wenn ein Kunde verschwindende Nachrichten von seiner Seite aktiviert, unterliegen alle Nachrichten im Gespräch (sowohl App als auch API) dem Timer.

Einmalig-Ansehen-Medien

• Einmalig ansehen Fotos und Videos, die von der Mobil-App gesendet werden, funktionieren für den Empfänger wie erwartet.
• Die API unterstützt derzeit nicht das Senden von Einmalig-Ansehen-Medien. Alle über die API gesendeten Medien werden als Standard-Medien (persistent) zugestellt.


Live-Standort

• Live-Standortfreigabe von der Mobil-App an Kunden funktioniert wie erwartet.
• Die API unterstützt nicht den Empfang oder die Anzeige von Live-Standortdaten. Wenn ein Kunde seinen Live-Standort teilt, ist er in der Mobil-App sichtbar, aber nicht über die API/das WhatsTeam-Dashboard.

Broadcast-Listen

• Broadcast-Listen, die in der Mobil-App erstellt wurden, bleiben funktionsfähig.
• Für großangelegte Nachrichtenübermittlung wird jedoch dringend empfohlen, stattdessen die Kampagnenfunktionen von WhatsTeam zu verwenden, da diese Zustellverfolgung, Analysen und Vorlagenverwaltung bieten.


Anforderungen

Bevor Sie den Koexistenzmodus aktivieren, stellen Sie sicher, dass Sie alle folgenden Anforderungen erfüllen:


1. WhatsApp Business App: Sie müssen die WhatsApp Business App verwenden (nicht die Standard-Verbraucher-WhatsApp-App). Die App muss auf die neueste Version aktualisiert sein, die in Ihrem App Store verfügbar ist.

2. Telefonnummer: Die Telefonnummer muss aktiv in der WhatsApp Business App registriert sein. Löschen oder deregistrieren Sie die Nummer nicht, bevor Sie diesen Prozess starten.

3. Meta Business Account: Sie benötigen ein Meta Business Account (ehemals Facebook Business Manager). Falls Sie keines haben, wird es während des Embedded Signup-Prozesses erstellt.

4. WhatsTeam-Konto: Sie benötigen ein aktives WhatsTeam-Konto. Registrieren Sie sich unter whats.team, falls Sie noch keines haben.

5. Administratorberechtigungen: Sie müssen Administratorzugang zum Meta Business Account haben, das mit dem WhatsApp Business Account verknüpft wird.

6. Automatische Antworten deaktivieren: Schalten Sie alle automatisierten Antworten in der WhatsApp Business App aus (Abwesenheitsnachrichten, Begrüßungsnachrichten), um Konflikte mit API-Automatisierungen zu vermeiden.

7. Stabile Internetverbindung: Sowohl Ihr Telefon (für die Mobil-App) als auch Ihr Computer (für den Einrichtungsprozess) benötigen eine zuverlässige Internetverbindung.

8. Moderner Browser: Verwenden Sie Chrome, Firefox oder Edge mit aktivierten Pop-ups für den Meta-Anmeldeflow.

Schritt-für-Schritt-Verbindungsanleitung

Befolgen Sie diese 18 Schritte sorgfältig, um Ihre WhatsApp Business-Nummer über den Koexistenzmodus mit WhatsTeam zu verbinden.

Schritt 1: Bei WhatsTeam anmelden

Öffnen Sie Ihren Browser und gehen Sie zu whats.team. Melden Sie sich mit Ihren WhatsTeam-Anmeldedaten an. Falls Sie noch kein Konto haben, erstellen Sie zuerst eines.


Schritt 2: Zu WhatsApp-Verbindungen navigieren

Gehen Sie nach der Anmeldung über das linke Seitenleisten-Navigationsmenü zu Einstellungen. Klicken Sie dann auf WhatsApp-Verbindungen, um Ihre aktuellen Verbindungen anzuzeigen und eine neue hinzuzufügen.

Schritt 3: Neue Nummer verbinden klicken

Klicken Sie auf der Seite WhatsApp-Verbindungen auf die Schaltfläche Neue Nummer verbinden. Dadurch wird der Embedded Signup-Flow gestartet.

![placeholder:whatsapp-coexistence-beta-07](WhatsTeam-Verbindungsseite, die die hervorgehobene Schaltfläche „Neue Nummer verbinden" zeigt)

Schritt 4: Koexistenzmodus auswählen

Wenn Sie aufgefordert werden, einen Verbindungstyp zu wählen, wählen Sie Koexistenz (Beta). Diese Option ermöglicht es, dass Ihre Nummer in der WhatsApp Business-Mobil-App aktiv bleibt und gleichzeitig über die API zugänglich ist.

![placeholder:whatsapp-coexistence-beta-08](Auswahlbildschirm für den Verbindungstyp mit hervorgehobener Option „Koexistenz Beta" unter den verfügbaren Optionen)

Schritt 5: Facebook-Anmeldung

Ein Meta-Anmelde-Popup-Fenster wird angezeigt. Geben Sie Ihre Facebook-Anmeldedaten ein und melden Sie sich an. Wenn Sie die Zwei-Faktor-Authentifizierung für Ihr Facebook-Konto aktiviert haben, schließen Sie auch diesen Verifizierungsschritt ab.

Schritt 6: Berechtigungen gewähren

Nach der Anmeldung wird Meta Sie bitten, WhatsTeam Berechtigungen zu gewähren. Überprüfen Sie die Berechtigungsliste sorgfältig und stellen Sie sicher, dass alle Kontrollkästchen ausgewählt sind:

• Ihr WhatsApp Business Account verwalten
• Die Telefonnummern Ihres WhatsApp Business Accounts verwalten
• Nachrichten in Ihrem Namen senden und empfangen

Klicken Sie auf Weiter, um diese Berechtigungen zu gewähren.


Schritt 7: Geschäftsportfolio auswählen oder erstellen

Wählen Sie ein bestehendes Meta-Geschäftsportfolio aus dem Dropdown oder erstellen Sie ein neues, indem Sie auf Neu erstellen klicken. Geben Sie Ihren Firmennamen und Details ein, wenn Sie ein neues Portfolio erstellen.


Schritt 8: WhatsApp Business Account erstellen

Wählen Sie Neues WhatsApp Business Account erstellen oder wählen Sie ein bestehendes. Bei Neuerstellung geben Sie an:

• Einen Anzeigenamen für Ihr Unternehmen
• Ihre Geschäftskategorie
• Eine Beschreibung Ihres Unternehmens

Schritt 9: Telefonnummer eingeben

Geben Sie die Telefonnummer ein, die derzeit in Ihrer WhatsApp Business-Mobil-App aktiv ist. Achten Sie darauf, die Landesvorwahl einzuschließen (z. B. +1 für die Vereinigten Staaten, +34 für Spanien).


Schritt 10: Eigentümerschaft verifizieren

WhatsApp sendet einen Verifizierungscode an Ihre Nummer. Sie können wählen, ihn zu erhalten per:

• SMS: Eine Textnachricht mit einem 6-stelligen Code.
• Sprachanruf: Ein automatischer Anruf, der den Code vorliest.

Geben Sie den Code in das Verifizierungsfeld ein.

Schritt 11: Koexistenz-Kopplung bestätigen

Nach der Verifizierung erkennt das System, dass die Nummer in der WhatsApp Business App aktiv ist, und bestätigt die Koexistenz-Kopplung. Sie sollten eine Bestätigungsnachricht sehen, die angibt, dass die Nummer im Koexistenzmodus verbunden wird.


Schritt 12: Verbindungseinstellungen überprüfen

Überprüfen Sie alle Verbindungseinstellungen vor dem Abschluss:

• Firmenname und Anzeigename
• Telefonnummer
• Verbindungsmodus (Koexistenz)
• Zugehöriges Meta-Geschäftsportfolio

Schritt 13: Allgemeine Geschäftsbedingungen akzeptieren

Lesen und akzeptieren Sie die Nutzungsbedingungen der WhatsApp Business API und die Plattformbedingungen von WhatsTeam. Diese umfassen Nachrichtenrichtlinien, Datenverarbeitung und Nutzungsrichtlinien.

Schritt 14: Einrichtung abschließen

Klicken Sie auf die Schaltfläche Einrichtung abschließen, um den Verbindungsprozess abzuschließen. Das System verarbeitet Ihre Anfrage, was typischerweise 30 Sekunden bis 2 Minuten dauert.


Schritt 15: Verbindung im Dashboard überprüfen

Nach Abschluss der Einrichtung werden Sie zum WhatsTeam-Dashboard weitergeleitet. Ihre neue Verbindung sollte mit dem Status Verbunden und einem Koexistenz-Label erscheinen.


Schritt 16: Testnachricht senden

Senden Sie vom WhatsTeam-Dashboard aus eine Testnachricht, um zu überprüfen, ob die API-Verbindung funktioniert:

1. Gehen Sie zu Nachrichten oder Chat.
2. Starten Sie ein neues Gespräch mit einer Testnummer.
3. Senden Sie eine einfache Textnachricht.
4. Überprüfen Sie, ob die Nachricht zugestellt wird und die Antwort empfangen wird.

Schritt 17: Überprüfen, ob die Mobil-App weiterhin funktioniert

Öffnen Sie die WhatsApp Business App auf Ihrem Telefon und bestätigen Sie:

• Die App funktioniert weiterhin normal.
• Sie können weiterhin Nachrichten senden und empfangen.
• Ihre bestehenden Gespräche sind intakt.
• Sie können über die API gesendete Nachrichten sehen (sie können mit einer leichten Verzögerung erscheinen).


Schritt 18: API-Automatisierungen konfigurieren

Da nun beide Kanäle verbunden sind, konfigurieren Sie Ihre API-Automatisierungen in WhatsTeam:

1. Richten Sie bei Bedarf Chatbot-Flows ein.
2. Konfigurieren Sie automatische Antwortregeln (diese überschreiben alle automatischen Antworten auf App-Ebene).
3. Richten Sie Benachrichtigungs-Webhooks für eingehende Nachrichten ein.
4. Konfigurieren Sie die Agentenzuweisungen Ihres Teams.


Preise

Der Koexistenzmodus folgt dem Standard-Preismodell der WhatsApp Business API mit einigen wichtigen Unterscheidungen:


API-Nachrichten (über WhatsTeam)

• Geschäftsinitiierte Gespräche: Es gelten die Standard-Meta-Preise basierend auf der Gesprächskategorie (Marketing, Utility, Authentifizierung oder Service).
• Benutzerinitiierte Gespräche: Derzeit kostenlos für die ersten 1.000 Gespräche pro Monat. Danach gelten die Standard-Gesprächstarife.
• Vorlagennachrichten: Müssen vorab genehmigte Vorlagen verwenden und werden zum Tarif für geschäftsinitiierte Gespräche abgerechnet.

Mobil-App-Nachrichten

• Direkte App-Nachrichten: Nachrichten, die direkt über die WhatsApp Business-Mobil-App gesendet werden, verursachen keine API-Gebühren.
• Wichtiger Hinweis: Wenn eine API-Automatisierung auf ein Gespräch antwortet, das über die Mobil-App initiiert wurde, wird diese automatisierte Antwort als API-Gespräch abgerechnet.

WhatsTeam-Plattformgebühren

WhatsTeam-Plattformgebühren werden separat von Metas gesprächsbasierter Preisgestaltung berechnet. Besuchen Sie whats.team/pricing für aktuelle Plandetails und enthaltene Nachrichtenvolumen.

Fehlerbehebung

Konflikte bei automatischen Antworten

Das häufigste Problem im Koexistenzmodus sind widersprüchliche automatische Antworten zwischen der WhatsApp Business-Mobil-App und den API-Automatisierungen von WhatsTeam.


Symptome

• Kunden erhalten doppelte Antworten: eine von der automatischen Antwort der App und eine von der API-Automatisierung.
• Antworten widersprechen sich (z. B. unterschiedliche Geschäftszeiten oder unterschiedliche Informationen).
• Der Gesprächsablauf wirkt für den Kunden unzusammenhängend.

Lösung

1. Alle automatischen Antworten in der WhatsApp Business App deaktivieren:

   • Öffnen Sie die App und gehen Sie zu Einstellungen > Business-Tools.
   • Schalten Sie die Abwesenheitsnachricht aus.
   • Schalten Sie die Begrüßungsnachricht aus.
   • Entfernen oder deaktivieren Sie alle Schnellantworten, die automatisch ausgelöst werden könnten.

2. Automatisierungen in WhatsTeam zentralisieren:

   • Konfigurieren Sie alle automatisierten Antworten über das WhatsTeam-Dashboard.
   • Dies stellt eine einzige Quelle der Wahrheit für alle automatisierten Interaktionen sicher.

3. Ihr Team schulen:

   • Wenn Teammitglieder die Mobil-App zum manuellen Antworten verwenden, stellen Sie sicher, dass sie zuerst das WhatsTeam-Dashboard prüfen, ob eine API-Automatisierung bereits geantwortet hat.
   • Legen Sie klare Protokolle fest, wer über welchen Kanal antwortet.

Nachrichten erscheinen nicht in der Mobil-App

Wenn über die API gesendete Nachrichten nicht in der Mobil-App sichtbar sind:

• Stellen Sie sicher, dass die WhatsApp Business App auf die neueste Version aktualisiert ist.
• Überprüfen Sie die Internetverbindung Ihres Telefons.
• Erzwingen Sie das Schließen und Neuöffnen der App.
• Warten Sie bis zu 30 Sekunden, da es eine kurze Synchronisierungsverzögerung geben kann.

Verbindungsabbrüche

Wenn die Koexistenz-Verbindung unerwartet abbricht:

• Überprüfen Sie das WhatsTeam-Dashboard auf Verbindungsstatus-Warnungen.
• Stellen Sie sicher, dass Sie sich nicht von WhatsApp Business auf Ihrem Telefon abgemeldet haben.
• Stellen Sie sicher, dass das Telefon mit dem Internet verbunden ist.
• Wenn das Problem weiterhin besteht, verbinden Sie sich über das WhatsTeam-Dashboard erneut, ohne die Nummer aus der Mobil-App zu löschen.

Häufig gestellte Fragen

1. Werde ich meinen Nachrichtenverlauf verlieren, wenn ich die Koexistenz aktiviere?

Nein. Ihr bestehender Nachrichtenverlauf in der WhatsApp Business-Mobil-App bleibt intakt. Der Koexistenzmodus löscht oder modifiziert Ihre bestehenden Gespräche nicht. Nachrichten, die vor der Aktivierung der Koexistenz über die API gesendet wurden, erscheinen jedoch nicht rückwirkend in der Mobil-App.


2. Wie funktioniert das 24-Stunden-Nachrichtenfenster in der Koexistenz?

Das 24-Stunden-Nachrichtenfenster gilt nur für API-Nachrichten. Wenn ein Kunde Ihnen eine Nachricht sendet, öffnet sich ein 24-Stunden-Fenster, in dem Sie frei über die API antworten können, ohne eine Vorlage zu verwenden. Nach dem Schließen des Fensters müssen Sie eine genehmigte Vorlagennachricht verwenden, um das Gespräch über die API erneut zu initiieren. Nachrichten, die direkt von der Mobil-App gesendet werden, unterliegen nicht dieser Fensterbeschränkung.

3. Was passiert mit laufenden Gesprächen, wenn ich die Koexistenz aktiviere?

Laufende Gespräche in der Mobil-App werden normal fortgesetzt. Sobald die Koexistenz aktiv ist, werden neue eingehende Nachrichten sowohl in der Mobil-App als auch im WhatsTeam-Dashboard sichtbar sein. Sie können wählen, von welchem Kanal aus Sie antworten. Wenn eine API-Automatisierung konfiguriert ist, antwortet sie automatisch, es sei denn, Sie haben spezifische Regeln festgelegt, um dies zu verhindern.

4. Werden Nachrichten in Echtzeit zwischen der Mobil-App und der API synchronisiert?

Nachrichten werden mit einer sehr kurzen Verzögerung synchronisiert, typischerweise unter 5 Sekunden. Eingehende Nachrichten von Kunden erscheinen in der Mobil-App und im WhatsTeam-Dashboard nahezu gleichzeitig. Ausgehende Nachrichten, die von einem Kanal gesendet werden, erscheinen innerhalb weniger Sekunden im anderen Kanal. Einige Metadaten (wie Lesebestätigungen, die von der App ausgelöst werden) werden jedoch möglicherweise nicht an das API-Dashboard weitergegeben.


5. Kann ich die Koexistenz deaktivieren und zum Nur-Mobil-App-Modus zurückkehren?

Ja. Sie können die API-Verbindung jederzeit vom WhatsTeam-Dashboard trennen, ohne Ihre Mobil-App zu beeinträchtigen. Gehen Sie zu Einstellungen > WhatsApp-Verbindungen, wählen Sie die Nummer und klicken Sie auf Trennen. Ihre WhatsApp Business App wird nach der Trennung weiterhin normal funktionieren. Beachten Sie, dass alle API-Automatisierungen, Chatbot-Flows und Integrationen nach der Trennung nicht mehr funktionieren.