Ein Carrier kann eine Nummer zum Kauf anbieten, auch wenn WhatsApp sie nicht akzeptiert. Prüfen Sie den Kandidaten vor der Bestellung, um nicht für eine Nummer zu bezahlen, die Sie über den vorgesehenen Setup-Flow nicht verbinden können.
Wie führe ich den Nummern-Precheck von Bird aus?
Verwenden Sie bird whatsapp numbers precheck mit der Kandidatennummer, bevor Sie sie kaufen.
bird whatsapp numbers precheck +31612345678Geben Sie die Nummer im internationalen Format mit führendem + und Ländercode an. Der API-Request überträgt sie in phone_number. Sie müssen die Nummer nicht bereits besitzen.
Der Endpunkt ist POST /v1/whatsapp/numbers/precheck. Verwenden Sie eine angemeldete CLI- oder MCP-Berechtigung mit whatsapp_management:write, wie in der Befehlsreferenz beschrieben.
| Flag | Was Sie damit prüfen können |
|---|---|
--example | Den Request-Body ohne Anmeldedaten |
--dry-run | Den aufgelösten Request ohne ihn zu senden |
--response-schema | Die Antwortfelder |
Ein MCP-Client ruft dieselbe Operation über whatsapp_numbers_precheck auf.
Was bedeuten available und unavailable?
available bedeutet, dass der Check zu diesem Zeitpunkt kein Hindernis für die Verbindung der Nummer gefunden hat. unavailable bedeutet, dass WhatsApp sie abgelehnt hat.
| Ergebnis | Was mit einem Kaufkandidaten zu tun ist |
|---|---|
available | Kaufprüfungen fortsetzen – das Ergebnis reserviert die Nummer nicht |
unavailable | Diesen Kandidaten überspringen; seine Registrierung prüfen, falls Sie ihn bereits besitzen |
Eine unavailable-Nummer ist möglicherweise bereits bei WhatsApp registriert oder eine Nummer, die WhatsApp nicht bedienen kann. Das Ergebnis unterscheidet diese Gründe nicht – leiten Sie keinen bestimmten Grund allein aus dem Ergebnis ab.
Ein Request-Fehler ist etwas anderes als ein unavailable-Ergebnis. Behandeln Sie den zurückgegebenen API-Fehler, bevor Sie den Kandidaten als ungeeignet einstufen.
Verändert der Check etwas?
Ja. Er sendet den Kandidaten an WhatsApp. Meta kann einen temporären Eintrag unter dem Business-Account von Bird erstellen.
Er verbindet die Nummer nicht mit Ihrem Workspace und reserviert sie nicht für den Kauf. Prüfen Sie nur den Kandidaten, den Sie tatsächlich kaufen möchten, denn das Durchlaufen einer Liste kann temporäre Einträge für ungenutzte Nummern hinterlassen.
Verwenden Sie einen Idempotency-Key erneut, wenn Sie denselben Check wiederholen. Innerhalb des dreistündigen Antwortfensters von Bird gibt derselbe Schlüssel die gespeicherte Antwort zurück, anstatt WhatsApp erneut zu fragen.
Der Idempotency-Replay-Antwort-Header kennzeichnet dieses Replay. Nach Ablauf des Antwortfensters kann derselbe Schlüssel einen neuen Check auslösen.
Wo passt der Check in den Kaufprozess einer Nummer?
Prüfen Sie die Carrier-Verfügbarkeit und die WhatsApp-Akzeptanz, bevor Sie die Nummernbestellung aufgeben.
- Suchen Sie mit
bird numbers available list --country-code US. - Prüfen Sie den ausgewählten Kandidaten erneut mit
bird numbers available get. - Führen Sie den WhatsApp-Precheck für diesen Kandidaten aus.
- Bestellen Sie erst nach
availablemitbird numbers orders create.
Ein 404 bei der Carrier-Verfügbarkeitsprüfung bedeutet, dass Sie einen anderen Kandidaten benötigen. Schließen Sie eine eventuell erforderliche Organisationsverifizierung im Dashboard ab, bevor Sie bestellen.
Eine pending-Bestellung erfordert weiterhin, dass der Carrier die Bereitstellung abschließt. Warten Sie, bis die Bestellung abgeschlossen ist, bevor Sie sich auf die Nummer verlassen.
Was ist, wenn ich die Nummer bereits besitze?
Nutzen Sie das Ergebnis, um die Verbindungsbereitschaft zu prüfen, statt eine Kaufentscheidung zu treffen.
Die Einrichtung eigener Nummern von Bird kann eine Nummer nicht verbinden, solange deren Consumer- oder WhatsApp-Business-App-Registrierung aktiv ist. Klären Sie diese Registrierung mit dem Kontoinhaber, bevor Sie die Verbindung versuchen.
Eine Nummer, die den Check besteht, muss den Verbindungsflow trotzdem abschließen. Stellen Sie sicher, dass ihr Status Connected erreicht, bevor Sie sie als Ihren gebrandeten Absender verwenden.
Von Bird verwaltete Absender sind eine separate Option für die verwalteten Authentifizierungs- und Utility-Templates. Sie versenden nicht Ihre Freitext-Inhalte und empfangen keine Kundenantworten in Ihrem Workspace.
Kurz gesagt
Vor dem Kauf prüfen.
Eine Nummernsuche stellt keine WhatsApp-Kompatibilität fest. Führen Sie den Precheck für den Kandidaten aus, den Sie kaufen möchten.
unavailable ohne erfundenen Grund interpretieren.
Die Nummer ist möglicherweise bereits registriert oder wird nicht unterstützt. Das Ergebnis unterscheidet diese Fälle nicht.
Den Precheck als schreibenden Vorgang behandeln.
Er sendet die Nummer an WhatsApp und kann einen temporären Eintrag erzeugen. Er reserviert oder verbindet die Nummer nicht.
Retry-Schlüssel für denselben Check wiederverwenden.
Ein Idempotenz-Replay gibt die gespeicherte Antwort zurück. Diese Antwort beschreibt den früheren Check, nicht eine aktuelle Verfügbarkeitsgarantie.