WhatsApp-Nummern verwalten

Öffnen Sie Numbers, um Ihre WhatsApp-Nummern, deren Verbindungsstatus und die zugehörigen Geschäftskonten zu sehen. Um eine Nummer hinzuzufügen, folgen Sie Nummer verbinden.

Die WhatsApp-Numbers-Seite in Bird mit Nummernstatus und zugehörigen Geschäftskonten

Verbindungsstatus prüfen

Status	Nächster Schritt
Preparing	Warten Sie, während Bird eine Nummer verifiziert, die Ihr Workspace hält.
Pre-verified	Wählen Sie Finish setting up, um sie über Meta zu verbinden.
Pending	Warten Sie, während Bird die Nummer bei Meta registriert.
Connected	Ihre Nummer ist sendebereit.
Failed	Öffnen Sie die Nummer, um den Fehlergrund zu prüfen.

Wählen Sie bei verification_code_not_received oder verification_rate_limited auf der Seite der Nummer Try again. Unter Fehler bei der Vorverifizierung finden Sie Hinweise zum Zeitpunkt für einen erneuten Versuch. Bei anderen Einrichtungsfehlern trennen Sie die fehlgeschlagene Nummer, bevor Sie sie erneut verbinden.

Eine verbundene Nummer prüfen

Öffnen Sie eine Nummer, um Quality rating, Messaging limit und Send rate zu sehen. Diese Werte stammen von Meta. Not rated bedeutet, dass Meta noch nicht genügend Verlaufsdaten hat, um die Nummer zu bewerten.

Verwenden Sie Business profile, um den Anzeigenamen, die Beschreibung, die Adresse und das Profilbild zu aktualisieren, die Empfänger sehen. Der Bereich Activity zeigt die Sendeaktivität.

Das Geschäftskonto prüfen

Wählen Sie das Konto in der Spalte WABA, um den WhatsApp Business Account zu prüfen, dem die Nummer gehört.

Ein WhatsApp Business Account in Bird mit Prüfstatus, Unternehmensverifizierung und Kontodetails

Business verification beeinflusst den Zugang zu Funktionen wie eigenen Authentifizierungstemplates.
Marketing Messages API zeigt, ob Meta das Konto für seine Marketing-Zustellungsoptimierungen akzeptiert hat. Marketing-Nachrichten können vor dem Onboarding gesendet werden, aber GIF-Header erfordern es.
Last read from WhatsApp zeigt, wann Bird diese Details zuletzt aktualisiert hat.

Ein Workspace kann mehrere Geschäftskonten haben. Prüfen Sie das Konto, das mit der Nummer verknüpft ist, von der Sie senden möchten.

Nummern über die API auslesen

Verwenden Sie einen API-Schlüssel mit whatsapp_management-Lesezugriff. Nummern auflisten gibt eine cursorbasierte Seite Ihrer Nummern zurück:

for await (const number of bird.whatsapp.numbers.list({ limit: 25 })) {
  console.log(number.id, number.phone_number, number.status);
}

for number in client.whatsapp.numbers.list(limit=25):
    print(number.id, number.phone_number, number.status)

for number, err := range client.Whatsapp.Numbers.List(ctx, bird.WhatsappNumbersListParams{Limit: 25}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(number.Id, number.PhoneNumber, number.Status)
}

foreach ($bird->whatsapp->numbers->list() as $number) {
    echo $number->getId(), ' ', $number->getPhoneNumber(), ' ', $number->getStatus(), PHP_EOL;
}

curl -sS "https://us1.platform.bird.com/v1/whatsapp/numbers?limit=25" \
  -H "Authorization: Bearer $BIRD_API_KEY"

Nummer lesen liefert Status, Qualitätsbewertung und Sendelimits. Weitere Leseendpunkte:

Endpunkt	Gibt zurück
Nummernprofil	Beschreibung, Adresse und Websites.
Nummernereignisse	Änderungen an Einrichtung, Status, Qualität, Limit und Anzeigename, neueste zuerst.
Geschäftskonten	Die WhatsApp Business Accounts des Workspace.
Geschäftskontodetails	Kontoprüfung, Unternehmensverifizierung, Marketing-Onboarding und Meta-Integritätsstatus.

meta_synced_at datiert die zuletzt von Meta gelesenen Werte. Bei Standardnummern fehlt es. meta_health_status fehlt, bis Bird das Konto gelesen hat. Das Feld waba einer Nummer enthält Metas Konto-ID.

Während der Einrichtung kann status den Wert preparing oder awaiting_signup haben. Das Feld next beschreibt die nächste Aktion, und finish_setup_url öffnet den Browserschritt. type ist ein offenes Enum bei Events – behandeln Sie unbekannte Werte, ohne abzubrechen.

Verwenden Sie das Dashboard oder CLI, um eine Nummer zu verbinden, umzubenennen oder zu trennen; diese Aktionen sind nicht Teil der öffentlichen API oder SDKs. Die CLI-Befehle sind bird whatsapp numbers create|update|delete und bird whatsapp numbers profile update. Das Erstellen einer Verbindung gibt finish_setup_url zurück, weil Metas Zustimmungsschritt einen Browser erfordert.

Nachrichten empfangen

Nachrichten an Ihre verbundenen Nummern erscheinen im WhatsApp-Log. Die Inbound-Metriken zeigen das Empfangsvolumen pro Nummer. Jede eingehende Nachricht öffnet das 24-Stunden-Kundenservicefenster für Freitextantworten.

Nummernoptionen

Für eine Nummer, die Ihr Workspace bei Bird hält, zeigt Nummer verbinden die automatische Verifizierung und die Meta-Einrichtung. Für eine Nummer bei einem anderen Anbieter wählen Sie I have my own number und empfangen Metas SMS oder den Sprachcode selbst. Nutzen Sie den unterstützten Migrationspfad oder den zulässigen Koexistenzpfad für Business-Apps bei einer bestehenden Registrierung. Geben Sie eine Phone registration PIN nur ein, wenn die Nummer bereits eine auf WhatsApp hat.

Standardnummern senden unterstützte Templates, ohne dass Sie eine eigene Nummer verbinden müssen.