Operator może oferować numer na sprzedaż nawet wtedy, gdy WhatsApp go nie zaakceptuje. Sprawdzenie kandydata przed zamówieniem pozwala uniknąć płacenia za numer, którego nie podłączysz w zamierzonym procesie konfiguracji.
Jak uruchomić wstępną weryfikację numeru w Bird?
Użyj bird whatsapp numbers precheck z numerem kandydata przed jego zakupem.
bird whatsapp numbers precheck +31612345678Podaj numer w formacie międzynarodowym z wiodącym + i kodem kraju. Żądanie API przekazuje go w phone_number. Nie musisz jeszcze być jego właścicielem.
Endpoint to POST /v1/whatsapp/numbers/precheck. Użyj zalogowanego CLI lub grantu MCP z whatsapp_management:write, zgodnie z wymaganiami dokumentacji poleceń.
| Flaga | Co pozwala sprawdzić |
|---|---|
--example | Treść żądania bez danych uwierzytelniających |
--dry-run | Rozwiązane żądanie bez jego wysyłania |
--response-schema | Pola odpowiedzi |
Klient MCP wywołuje tę samą operację przez whatsapp_numbers_precheck.
Co oznaczają available i unavailable?
available oznacza, że weryfikacja nie znalazła przeszkód do podłączenia numeru w danym momencie. unavailable oznacza, że WhatsApp odrzucił go.
| Wynik | Co zrobić z kandydatem do zakupu |
|---|---|
available | Kontynuuj weryfikację zakupu, pamiętając, że wynik nie rezerwuje numeru |
unavailable | Pomiń tego kandydata i wybierz inny numer |
Numer z wynikiem unavailable może być już zarejestrowany w WhatsApp lub może być numerem, którego WhatsApp nie obsługuje. Wynik nie rozróżnia tych przyczyn, więc nie wnioskuj żadnej z nich wyłącznie na podstawie rezultatu.
Błąd żądania to coś innego niż wynik unavailable. Obsłuż zwrócony błąd API, zanim uznasz kandydata za nieodpowiedniego.
Czy weryfikacja rezerwuje numer?
Nie. Nie podłącza numeru do Twojego obszaru roboczego ani nie rezerwuje go do zakupu. Ktoś inny może zająć numer z wynikiem available, zanim go zamówisz.
Sprawdzaj kandydata, którego zamierzasz kupić, zamiast przeglądać całą listę.
Używaj ponownie Idempotency-Key przy ponawianiu tego samego sprawdzenia. W trzygodzinnym oknie odpowiedzi Bird ten sam klucz zwraca zapisaną odpowiedź zamiast ponownie pytać WhatsApp.
Nagłówek odpowiedzi Idempotency-Replay identyfikuje to powtórzenie. Po zakończeniu okna odpowiedzi ten sam klucz może uruchomić nowe sprawdzenie.
Gdzie weryfikacja pasuje w procesie zakupu numeru?
Sprawdź dostępność u operatora i akceptację WhatsApp przed złożeniem zamówienia na numer.
- Wyszukaj za pomocą
bird numbers available list --country-code US. - Ponownie sprawdź wybranego kandydata za pomocą
bird numbers available get. - Uruchom wstępną weryfikację WhatsApp dla tego kandydata.
- Zamów dopiero po
available, używającbird numbers orders create.
Wynik 404 z ponownego sprawdzenia dostępności u operatora oznacza, że potrzebujesz innego kandydata. Przed zamówieniem przeprowadź wymaganą weryfikację organizacji w panelu.
Zamówienie pending nadal wymaga od operatora dokończenia prowizjonowania. Poczekaj na rozliczenie zamówienia, zanim zaczniesz polegać na numerze.
Czy mogę sprawdzić numer, który już posiadam?
Nie. Wstępna weryfikacja dotyczy numerów, które planujesz kupić od Bird. Nie służy do numeru, który już posiadasz; nie służy też do numerów w trybie coexistence. Numer, który już posiadasz, podłącz za pomocą konfiguracji własnego numeru w Bird.
Ta konfiguracja nie podłączy numeru, dopóki jego prywatna rejestracja w WhatsApp pozostaje aktywna. Numer używany w aplikacji WhatsApp Business podłącza się przez coexistence. Upewnij się, że status numeru osiągnie Connected, zanim użyjesz go jako swojego firmowego nadawcy.
Nadawcy zarządzani przez Bird to osobna opcja dla zarządzanych szablonów uwierzytelniających i użytkowych. Nie wysyłają Twoich dowolnych treści ani nie odbierają odpowiedzi klientów do Twojego obszaru roboczego.
W skrócie
Sprawdź przed zakupem.
Wyszukiwanie numerów nie potwierdza kompatybilności z WhatsApp. Uruchom wstępną weryfikację dla kandydata, którego zamierzasz kupić.
Interpretuj unavailable bez wymyślania przyczyny.
Numer może być już zarejestrowany lub nieobsługiwany. Wynik nie rozróżnia tych przypadków.
Nie traktuj odpowiedzi jak rezerwacji.
Weryfikacja nie rezerwuje ani nie podłącza numeru. Zamów go, póki odpowiedź jest aktualna.
Używaj tych samych kluczy ponownej próby dla tego samego sprawdzenia.
Powtórzenie z kluczem idempotentności zwraca zapisaną odpowiedź. Ta odpowiedź opisuje wcześniejsze sprawdzenie, a nie świeżą gwarancję dostępności.