WhatsApp-API-Migration

Diese Anleitung erklärt, wie du eine Nummer, die bereits über die offiziellen WhatsApp-APIs (WhatsApp Business Platform) bei einem anderen Anbieter aktiv ist, mit Quoting24 verbindest, ohne die Nummer zu wechseln.

Der Bereich WhatsApp ist nur für Administratoren sichtbar.

Die Verbindung startet in Quoting24 immer an derselben Stelle: Einstellungen → WhatsApp → WhatsApp Business → Verbinden. Die Schaltfläche Verbinden öffnet die integrierte Registrierung von Meta (Embedded Signup). Danach ist Quoting24 der Anbieter, der die Nachrichten dieser Nummer empfängt und sendet. Vorgesehen ist die Verbindung über die offiziellen APIs, beschrieben in WhatsApp-Überblick.

Welches Vorgehen gilt

Meta kennt zwei Wege, eine Nummer zu verbinden, die bereits ein anderer Anbieter nutzt. Prüfe vor dem Klick auf Verbinden das Portfolio unter Meta Business Suite → Einstellungen → Konten.

Das siehst du in der Meta Business Suite	Das tust du
WhatsApp-Konten und Nachrichtenkonten (Messaging Accounts) getrennt	Aktuelles Modell: WhatsApp-Konto mit Quoting24 teilen. Die Nummer bleibt, wo sie ist.
Nur WhatsApp-Konten	Vorheriges Modell: Nummer mit einem SMS- oder Sprachanruf-Code migrieren.

Im aktuellen Modell lehnt Meta das Verschieben der Nummer von einem Konto zu einem anderen ab. Sie beim bisherigen Anbieter zu trennen macht sie nicht frei.

Was du vorbereitest

Administratorzugriff auf Quoting24.
Administratorzugriff auf das Meta-Portfolio (Business Manager), dem die Nummer gehört, mit dem Facebook-Benutzer, den du im Fenster Verbinden verwendest.
Die Nummer ist bereits auf den offiziellen APIs registriert. Kostenlose Testnummern von Meta lassen sich nicht migrieren.
Du kannst auf dieser Nummer eine SMS oder einen Sprachanruf empfangen, falls Meta einen Code verlangt.

Für die Migration des vorherigen Modells brauchst du zusätzlich:

einen bereits genehmigten Anzeigenamen, ohne offenen Antrag auf Namensänderung;
die Bestätigung in zwei Schritten (PIN) auf der Nummer ausgeschaltet, ohne die Nummer zu löschen oder das Konto zu schließen. Wenn du keinen Zugriff auf das WhatsApp-Konto hast, lässt du sie vom aktuellen Anbieter ausschalten.

Aktuelles Modell: Nummer mit Quoting24 teilen

Nutze dieses Vorgehen, wenn in der Meta Business Suite sowohl WhatsApp-Konten als auch Nachrichtenkonten erscheinen.

Lass die Nummer bis zum Schluss beim aktuellen Anbieter aktiv. Sie vorher zu entfernen, während Kundennachrichten ankommen, unterbricht den Empfang.

Öffne in Quoting24 Einstellungen → WhatsApp.
Klicke in der Zeile WhatsApp Business auf Verbinden und melde dich mit dem Administrator des Meta-Portfolios an.
Wähle die Nummer, die bereits beim anderen Anbieter registriert ist. Meta zeigt sie in der Liste und fordert keinen neuen Code an: Die Nummer ist bereits registriert.
Meta schlägt das Portfolio und das WhatsApp-Konto dieser Nummer vor. Bestätige die Freigabe für Quoting24.
Gib den Anzeigenamen der Nummer ein und fahre fort. Meta kann ihn nach der Aktivierung erneut prüfen.
Prüfe die angeforderten Berechtigungen (WhatsApp-Konto, Nachrichtenkonto und verknüpfte Ressourcen) und bestätige.
Schließe das Meta-Fenster. In Quoting24 steht die Zeile WhatsApp Business auf verbunden.

Meta legt für Quoting24 ein neues Nachrichtenkonto unter demselben WhatsApp-Konto an. Der bisherige Anbieter bleibt verbunden, bis du ihn entfernst.

Nachrichten in Quoting24 ankommen lassen

Das Teilen allein verschiebt eingehende Nachrichten nicht. Solange der bisherige Anbieter Partner bleibt, kann Meta sie weiter dorthin zustellen.

Wenn die Zeile WhatsApp Business in Quoting24 verbunden ist:

Öffne in der Meta Business Suite Einstellungen → Konten → Nachrichtenkonten, wähle das Konto, gehe zu Partner und entferne den Zugriff der App des bisherigen Anbieters.
Öffne Einstellungen → Konten → WhatsApp-Konten, wähle das Konto der Nummer, gehe zu Partner und entferne dort ebenfalls den Zugriff desselben Anbieters.
Öffne im selben WhatsApp-Konto Konversationsrouting (Conversation routing) und weise Quoting24 jeden Unterhaltungstyp zu.

In der Partnerliste kann der Name der mit Quoting24 verknüpften Meta-App stehen, nicht der Text „Quoting24“. Wenn nicht klar ist, welchen Zugriff du entfernen sollst, halte an und frage den Quoting24-Support, bevor du einen Partner entfernst.

Bleibt nur ein Partner übrig, schaltet Meta das Routing ab und stellt die Nachrichten an diesen Partner zu.

Was bei diesem Modell erhalten bleibt

Diese Angaben bleiben an der Nummer, weil das WhatsApp-Konto sich nicht ändert:

Telefonnummer
Anzeigename
Qualitätsbewertung
Messaging-Limits
Status Official Business Account, falls er bereits aktiv war

Templates gehören zum Nachrichtenkonto, nicht zur Nummer. Das für Quoting24 angelegte Konto startet leer: Templates des bisherigen Anbieters müssen in Quoting24 neu angelegt und von Meta erneut genehmigt werden.

Solange sie nicht genehmigt sind:

kannst du aus Quoting24 nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden frei antworten;
gibt es in Broadcast API keine Modelle zur Auswahl.

Chats, die in der bisherigen Software gespeichert sind, werden keine Tickets in Quoting24. Nachrichten, die nach der Verbindung ankommen, werden Tickets. Chats, die bereits auf dem Telefon des Kunden liegen, bleiben in der WhatsApp-App des Kunden.

Vorheriges Modell: Nummer migrieren

Nutze dieses Vorgehen nur, wenn in der Meta Business Suite nur WhatsApp-Konten erscheinen.

Bestätigung in zwei Schritten ausschalten

Bitte den aktuellen Anbieter, die PIN der Nummer auszuschalten, oder tu es selbst im Meta-Portfolio, wenn du Zugriff hast.

Nummer und Konto müssen aktiv bleiben. Entfernt wird nur die Bestätigung in zwei Schritten.

Nummer aus Quoting24 verbinden

Öffne in Quoting24 Einstellungen → WhatsApp.
Klicke in der Zeile WhatsApp Business auf Verbinden und melde dich als Administrator des Meta-Portfolios an.
Wähle ein neues WhatsApp-Konto erstellen. Mit diesem Schritt verschiebt Meta die bereits vorhandene Nummer: Es ist keine zweite Nummer.
Gib denselben Anzeigenamen ein, der für diese Nummer bereits genehmigt ist.
Gib dieselbe Nummer ein. Meta weist darauf hin, dass sie bereits bei einem WhatsApp-Business-Konto oder einem anderen Anbieter registriert ist.
Fordere den Code per SMS oder Sprachanruf an und gib ihn ein.
Schließe die übrigen Schritte im Meta-Fenster ab.

Die Verschiebung ist in der Regel nach wenigen Minuten abgeschlossen. In Quoting24 wechselt die Zeile WhatsApp Business auf verbunden. Währenddessen kann der Empfang für einige Minuten aussetzen.

Was bleibt und was neu angelegt wird

An der Nummer bleiben:

Anzeigename
Qualitätsbewertung
Status Official Business Account
Messaging-Limits

In Quoting24 werden neu angelegt:

die Templates, die erneut eingereicht und von Meta genehmigt werden müssen, bevor du außerhalb des 24-Stunden-Fensters schreibst und bevor du Broadcast API nutzt;
die Kampagnen des bisherigen Anbieters;
der Chatverlauf dieser Software, der nicht importiert wird. Neue Nachrichten kommen als Tickets an.

Nummer bereits in Koexistenz bei einem anderen Anbieter

Wenn dieselbe Nummer bei einem anderen Anbieter gleichzeitig über die WhatsApp-Business-App und die APIs genutzt wird, hängt die API-Verbindung die App auf dem Telefon nicht von allein wieder an.

Erstelle ein Backup der Chats in der WhatsApp-Business-App.
Registriere dieselbe Nummer in der privaten WhatsApp-App: Die Nummer verlässt die Business-App.
Registriere sie erneut in der WhatsApp-Business-App.
Klicke in Quoting24 bei WhatsApp Business auf Verbinden und schließe die Koexistenz ab, wie in WhatsApp Coexistence beschrieben: in der App Einstellungen → Verknüpfte Geräte → Gerät verknüpfen, dann den von Quoting24 gezeigten QR-Code scannen.

Um die Nummer nur auf die APIs zu bringen, ohne App auf dem Telefon, nutze das Vorgehen des Meta-Modells, das du oben geprüft hast.

Nach der Verbindung

Neue Nachrichten der Nummer werden in Quoting24 zu Tickets.
Außerhalb von 24 Stunden nach der letzten Nachricht des Kunden schreibst du mit einem genehmigten Template. Die Regeln des offiziellen Kanals stehen in WhatsApp-Überblick.
Kampagnen legst du in Broadcast API an, sobald die Templates in Quoting24 verfügbar sind.
Um die WhatsApp-Business-App auf derselben Nummer weiter zu nutzen, brauchst du WhatsApp Coexistence.
Gruppen und Broadcast-Listen der App wechseln nicht auf die APIs.

Wenn das Vorgehen stoppt

Meta lehnt das Verschieben der Nummer ab. Das Portfolio liegt auf dem aktuellen Modell: Geh zurück zum Teilen und lass die Nummer beim bisherigen Anbieter registriert, bis Quoting24 verbunden anzeigt.
Der SMS- oder Sprachanruf-Code kommt nicht an. Im vorherigen Modell ist die Bestätigung in zwei Schritten noch aktiv. Schalte sie aus und klicke erneut auf Verbinden.
Der Anzeigename blockiert die bisherige Migration. Meta akzeptiert den Wechsel nur mit genehmigtem Namen und ohne ausstehende Namensänderung.
Quoting24 ist verbunden, aber Nachrichten kommen nicht an. Im aktuellen Modell zeigt das Routing noch auf den bisherigen Anbieter. Prüfe Partner und Konversationsrouting, bevor du die Nummer trennst.
Wenn der zu entfernende Partner nicht erkennbar ist, kontaktiere den Quoting24-Support mit der Nummer und der ID des Meta-Portfolios.