Przegląd numerów

Numer telefonu to nadawca Twoich wiadomości i połączeń. Bird sprzedaje numery w obsługiwanych krajach, a numer przypisany do Twojego obszaru roboczego może obsługiwać SMS, MMS lub głos w zależności od tego, co dany numer wspiera. Strona Numbers w dashboardzie pokazuje numery przypisane do Ciebie, a ten sam cykl życia jest dostępny przez API: wyszukaj, co jest w sprzedaży, zamów numer, sprawdź, co masz, i zwolnij to, czego już nie potrzebujesz.

Każdy przypisany do Ciebie numer ma kind i to on decyduje, co możesz z tym numerem zrobić.

Numer dedicated należy wyłącznie do Twojego obszaru roboczego. Kupiłeś go, ponosisz za niego miesięczną opłatę i możesz go zwolnić, gdy nie jest Ci już potrzebny. To właśnie daje zamówienie numeru.

Numer shared to krótki kod na infrastrukturze zarządzanej przez Bird. Otrzymujesz prawo do korzystania z niego zamiast go kupować, więc nie ponosisz własnej opłaty miesięcznej i nie możesz go zwolnić. Próba zwolnienia kończy się błędem E14002.

Dwa pola opisują, czym jest numer, i odpowiadają na różne pytania.

number_type to fizyczny rodzaj numeru: mobile, local, national, toll_free lub krótki kod. Decyduje o tym, jak numer zachowuje się w sieci, a w kilku krajach także jakich dokumentów wymaga.

capabilities to faktyczne możliwości numeru: sms, mms, voice lub ich kombinacja. Numer, który zawiera voice, obsługuje połączenia; numer bez niego nie. Filtruj wyniki wyszukiwania po możliwościach, gdy potrzebujesz konkretnej, i sprawdź to pole, zanim zaczniesz budować na numerze, który już masz.

Sam przypisany numer nie zawsze wystarczy, żeby z niego wysyłać. Niektóre kraje docelowe wymagają też zatwierdzonej rejestracji nadawcy, która jest osobnym zatwierdzeniem niezależnym od samego numeru.

status mówi, czy numer może obsługiwać ruch.

active oznacza, że numer jest przypisany do Ciebie i gotowy do użycia.

pending_ownership_registration oznacza, że numer jest przypisany do Ciebie i naliczana jest za niego opłata, ale dany kraj wymaga dokumentów potwierdzających prawo własności, które nie zostały jeszcze zaakceptowane. Pole ownership wskazuje, co jest jeszcze wymagane i które wywołanie to realizuje. Większość numerów nigdy nie wchodzi w ten stan, ponieważ większość krajów nie wymaga niczego: ich ownership to null.

released oznacza, że numer nie jest już do Ciebie przypisany.

Zamówienie numeru tworzy zlecenie i to zlecenie jest tym, co śledzisz. Większość kończy się w ramach żądania i od razu zwraca numer. Zlecenie, które musi czekać na operatora, wraca wciąż w toku, więc odpytujesz je, aż osiągnie completed lub failed.

Ma to znaczenie z dwóch powodów. Numer jest Twój dopiero po osiągnięciu przez zlecenie statusu completed, więc nic nie powinno zakładać, że numer istnieje wcześniej. Opłata konfiguracyjna, która została już pobrana, nie jest zwracana w przypadku niepowodzenia zlecenia, dlatego wyszukiwanie i zamówienie to osobne wywołania: wyszukiwanie pokazuje, co jest dostępne, zanim zdecydujesz się na zakup.