Zum Inhalt springen
ASKO.CLOUDDocs

Coexistence verstehen

Was Meta erlaubt, was nicht – und wie Sie Verbindungsabbrüche vermeiden.

Was gleich bleibt

  • Ihr Team nutzt die WhatsApp Business App wie gewohnt – Chats und Verlauf bleiben auf dem Telefon.
  • Nachrichten aus der App bleiben kostenlos und öffnen kein Kundenservice-Fenster der API.
  • Nachrichten, die in der App gesendet werden, erhalten Sie als smb_message_echoes.

Einschränkungen durch Meta

  • Gruppen: funktionieren in der App, sind per API nicht sichtbar oder versendbar.
  • Durchsatz: fest 20 Nachrichten pro Sekunde.
  • Broadcast-Listen: bestehende werden schreibgeschützt, neue können nicht erstellt werden.
  • Deaktiviert in Einzelchats: selbstlöschende Nachrichten, „Einmal ansehen“, Live-Standort.
  • Verknüpfte Geräte: beim Verbinden werden alle Begleitgeräte abgemeldet; WhatsApp für Windows und WearOS werden nicht unterstützt. Unterstützte Geräte können neu verknüpft werden; Nachrichten von nicht unterstützten Geräten erzeugen keine Webhooks.
  • Katalog, Bestellungen, Zahlungen, Anrufe bleiben in der App.
  • Gelegentlich meldet Meta eine Nachricht als „nicht unterstützt“ (Fehler 131060), z. B. die allererste Nachricht eines Kontakts – die Nachricht ist dann in der App sichtbar.

Kontakte und Verlauf synchronisieren

Nach dem Verbinden gibt es ein 24-Stunden-Fenster, um einmalig Kontakte (smb_app_state_sync) und den Verlauf (history, bis zu 180 Tage, ohne Gruppen) zu übertragen. Der Verlauf kommt in Phasen (0: Tag 0–1, 1: Tag 1–90, 2: Tag 90–180) und in Abschnitten; progress: 100 bedeutet vollständig. Medien im Verlauf erscheinen als media_placeholder, für die letzten 14 Tage folgen die Medien-IDs separat. Hat das Unternehmen das Teilen des Verlaufs abgelehnt, kommt ein history-Ereignis mit Fehlercode 2593109.

Eine erneute Synchronisation ist nur möglich, wenn die Nummer getrennt und neu verbunden wird.

Verbindung halten

Meta trennt die API-Verbindung, wenn die WhatsApp Business App etwa 14 Tage nicht geöffnet wurde. Öffnen Sie die App regelmäßig auf dem Haupttelefon. Wir prüfen den Status laufend und senden bei einer Trennung ein connection_status-Ereignis mit Grund.

Trennen

Die Verbindung trennen Sie in der App unter Einstellungen → Konto → Business-Plattform. Meta erlaubt für Coexistence-Nummern keine Abmeldung per API.