WhatsApp

Wie funktioniert WhatsApp Embedded Signup?

Embedded Signup verbindet Ihre Meta-Business-Assets und Ihre WhatsApp-Nummer mit einem Anbieter, aber Verifizierung und Verbindungsaufbau können nach dem Schließen des Dialogs noch andauern.

Embedded Signup ist ein Meta-Ablauf, der innerhalb der Onboarding-Oberfläche eines Anbieters angezeigt wird. Damit kann Ihr Unternehmen Account- und Nummerneinrichtung autorisieren, ohne dem Anbieter Ihre persönlichen Meta-Anmeldedaten zu überlassen.

Wer sollte Embedded Signup starten?

Verwenden Sie den Meta-Login des Inhabers des Business-Portfolios oder eines Administrators mit der Berechtigung, dessen WhatsApp-Assets zu verwalten. Die Person, die den Ablauf durchführt, genehmigt, was der Anbieter verbinden darf.

Behalten Sie als Administrator die Kontrolle über den Meta-Account. Wenn Sie einen Anbieter bitten, sich als dieser Administrator auszugeben, riskieren Sie den Verlust der Kontrolle über Assets und Berechtigungen. Der Geschäftsinhaber sollte die Assets, Berechtigungen und Bedingungen im Meta-Dialog prüfen, bevor er bestätigt.

Welche Assets verbindet der Ablauf?

Der Ablauf kann ein Meta-Business-Portfolio, einen WhatsApp Business Account und eine Telefonnummer mit der Integration des Anbieters verbinden. Die genauen Auswahlmöglichkeiten hängen davon ab, ob Sie einen neuen Account erstellen oder einen bestehenden auswählen.

AssetVor dem Fortfahren bestätigen
Business-PortfolioDas Unternehmen und der Administrator sind korrekt
WhatsApp Business AccountDer Account ist derjenige, den Ihr Team betreiben möchte
TelefonnummerDie Nummer ist für das gewählte WhatsApp-Setup verfügbar
AnbieterverbindungDer Anbieter und der Workspace, die die Verbindung erhalten, sind korrekt

Der Anbieter kann die verbundenen Assets betreiben. Ihr Unternehmen bleibt verantwortlich für die Richtlinien des Accounts, die Kundeneinwilligung und den Nachrichteninhalt. Lesen Sie Metas WhatsApp-Business-Richtlinie, bevor Sie den Zugriff autorisieren.

Was passiert während des Ablaufs?

Der Anbieter öffnet Metas Embedded-Signup-Dialog in seinem Dashboard. Sie melden sich an, wählen oder erstellen die Business-Assets, geben die angeforderten Geschäftsdaten an und autorisieren die Anbieterverbindung.

Die Telefonverifizierung kann ein separater Schritt sein. Folgen Sie den Nummernprüfungen im Bird WhatsApp-Nummern-Leitfaden, bevor Sie starten, falls Sie unsicher sind, ob die Kandidatennummer verbunden werden kann.

Was ist nach dem Schließen des Dialogs noch unvollständig?

Wenn der Dialog geschlossen wird, können Verifizierung, Verbindung und Sendefähigkeit noch unvollständig sein. Der Browser-Ablauf ist abgeschlossen, aber Meta verarbeitet die Assets möglicherweise noch.

Der Abschlussvorgang von Bird ist nur über das Dashboard möglich. Ein Backend-Request kann die Zustimmung und Asset-Auswahl des Administrators nicht reproduzieren. Bauen Sie daher keine öffentliche API-Integration darauf auf.

Lesen Sie in Bird die Felder status, next und finish_setup_url der verbundenen Nummer. status ist ein offenes Enum. Es enthält awaiting_signup, banned, connected, deleted, disconnected, failed, flagged, migrated, pending, preparing, rate_limited und restricted; akzeptieren Sie auch unbekannte Werte. Das separate Feld error erklärt, warum die Verbindung zuletzt fehlgeschlagen ist. next meldet die nächste Aktion, solange die Verbindung unvollständig ist. Wenn die Anmeldung auf einen Browser-Schritt wartet, erscheint finish_setup_url nur für awaiting_signup; das Öffnen schließt den Dashboard-Ablauf ab, weil der Schritt nicht über die API ausgeführt werden kann. Fragen Sie die Ressource nach Abschluss des Ablaufs ab, anstatt die Weiterleitung als erfolgreichen Sendetest zu werten.

Markierte, eingeschränkte und gesperrte Zustände können den Sendezugriff einer verbundenen Nummer beeinflussen.

Wie prüfe ich die Anmeldebereitschaft?

Bestätigen Sie vor dem Ablauf:

  1. Der Administrator kann auf das korrekte Meta-Business-Portfolio zugreifen.
  2. Die Geschäftsdaten und die Account-Eigentümerschaft sind zur Prüfung bereit.
  3. Die Telefonnummer ist für diesen Verbindungspfad verfügbar.
  4. Der Anbieter-Workspace ist derjenige, der den Account erhalten soll.

Bestätigen Sie nach dem Ablauf den Account, den Nummernstatus, das Verifizierungsergebnis und einen echten Testversand. Halten Sie den Meta-Account-Inhaber und den Support-Kontakt des Anbieters für eine Wiederherstellung fest.

Kurz gesagt

  1. Bringen Sie den richtigen Administrator mit.

    Der Inhaber oder ein Administrator des Meta-Business-Portfolios muss die Zustimmungs- und Asset-Schritte abschließen.

  2. Bereiten Sie Nummer und Unternehmen vor.

    Halten Sie das Business-Portfolio, die WhatsApp-Business-Account-Details und eine Nummer für den Verbindungsablauf des Anbieters bereit.

  3. Rechnen Sie mit Arbeit nach der Anmeldung.

    Das Schließen des Dialogs bestätigt weder Verifizierung noch Nummernverbindung oder Sendebereitschaft. Folgen Sie dem gemeldeten Status.

  4. Halten Sie die Eigentümerschaft eindeutig.

    Prüfen Sie vor der Autorisierung, welches Business-Portfolio, welchen Account und welche Nummer der Anbieter verbindet.

Bauen Sie auf demselben Netzwerk auf.

Ein Test-API-Schlüssel steht Ihnen sofort zur Verfügung. Der Produktivbetrieb wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Starten Sie mit einem Kanal.
Fügen Sie die anderen hinzu, wenn Sie bereit sind.

Ein Test-API-Key steht Ihnen sofort zur Verfügung. Der Produktivzugang wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Sie nutzen Claude Code, Cursor oder Codex? Kopieren Sie einen Setup-Prompt und Ihr Agent installiert die Bird CLI und Skills für Sie. Wählen Sie Ihren:

Cursor