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 und eine andere Nummer wählen |
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 also 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.
Reserviert der Check die Nummer?
Nein. Er verbindet die Nummer nicht mit Ihrem Workspace und reserviert sie nicht für den Kauf. Jemand anderes kann eine available-Nummer übernehmen, bevor Sie sie bestellen.
Prüfen Sie den Kandidaten, den Sie kaufen möchten, statt eine ganze Liste durchzugehen.
Verwenden Sie einen Idempotency-Key wieder, wenn Sie denselben Check erneut versuchen. 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.
Kann ich eine Nummer prüfen, die ich bereits besitze?
Nein. Der Precheck ist für Nummern gedacht, die Sie bei Bird kaufen möchten. Er gilt weder für eine Nummer, die Sie bereits besitzen, noch für Koexistenz-Nummern. Verbinden Sie eine Nummer, die Sie bereits besitzen, über die Einrichtung eigener Nummern von Bird.
Diese Einrichtung kann eine Nummer nicht verbinden, solange deren private WhatsApp-Registrierung aktiv ist. Eine Nummer in der WhatsApp-Business-App verbinden Sie über die Koexistenz. Stellen Sie sicher, dass der Status der Nummer 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.
Die Antwort nicht als Reservierung behandeln.
Der Check reserviert oder verbindet die Nummer nicht. Bestellen Sie sie, solange die Antwort aktuell ist.
Schlüssel für erneute Versuche beim selben Check wiederverwenden.
Ein Idempotenz-Replay gibt die gespeicherte Antwort zurück. Diese Antwort beschreibt den früheren Check, nicht eine aktuelle Verfügbarkeitsgarantie.