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; zbadaj jego rejestrację, jeśli już go posiadasz |
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 coś zmienia?
Tak. Wysyła kandydata do WhatsApp. Meta może utworzyć tymczasowy wpis na koncie biznesowym Bird.
Nie podłącza numeru do Twojego obszaru roboczego ani nie rezerwuje go do zakupu. Sprawdzaj tylko kandydata, którego zamierzasz kupić, bo przeglądanie całej listy może pozostawić tymczasowe wpisy dla nieużywanych numerów.
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.
Co jeśli już posiadam ten numer?
Użyj wyniku do zbadania gotowości do podłączenia, a nie do podjęcia decyzji zakupowej.
Konfiguracja własnego numeru w Bird nie może połączyć numeru, dopóki jego rejestracja w aplikacji konsumenckiej lub WhatsApp Business pozostaje aktywna. Rozwiąż tę rejestrację z właścicielem konta przed próbą połączenia.
Numer, który przejdzie weryfikację, nadal musi przejść proces podłączania. Upewnij się, że jego status osiągnie Connected, zanim użyjesz go jako swojego firmowego nadawcy.
Nadawcy zarządzani przez Bird to osobna opcja dla zarządzanych szablonów uwierzytelniania 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.
Traktuj wstępną weryfikację jak operację zapisu.
Wysyła numer do WhatsApp i może utworzyć tymczasowy wpis. Nie rezerwuje ani nie podłącza numeru.
Używaj ponownie kluczy ponawiania 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.