Sign inGet Started

Identyfikatory dzwoniącego

Identyfikator dzwoniącego to numer, który Twój obszar roboczy może prezentować przy połączeniu wychodzącym. Bird sprawdza nagłówek SIP From każdego połączenia względem numerów Bird, które ten obszar roboczy może prezentować, oraz jego zweryfikowanych numerów zewnętrznych. Połączenia prezentujące niedozwolony numer są odrzucane.

Zarządzaj identyfikatorami dzwoniącego w sekcji Voice > Numbers, która zawiera listę wszystkich numerów dostępnych w Twoim obszarze roboczym dla połączeń głosowych. Numer kupiony od nas i numer zweryfikowany pojawiają się na tej samej liście, po jednym wierszu na numer. Numer spełniający oba warunki pojawia się raz. Numer kupiony od nas jest gotowy do prezentowania od razu po jego przypisaniu, bez połączenia weryfikacyjnego: samo posiadanie go jest dowodem. Poniższa procedura dotyczy numeru, który posiadasz u innego dostawcy.

Każdy wiersz pokazuje nazwę, numer i jego kraj, Provider, obsługiwane kierunki oraz przeznaczenie numeru. Numer oczekujący na kod ma status Verifying; numer, którego kod wygasł lub którego próby zostały wyczerpane, ma status Failed. Każda strona zawiera do 25 numerów. Wybierz wiersz, aby otworzyć stronę numeru.

Rejestracja numeru

  1. Wybierz Add number > Verify a number you own.
  2. Wprowadź numer w formacie E.164: wiodący +, kod kraju i numer krajowy. Numer można zarejestrować w obszarze roboczym tylko raz.
  3. Zapisz go. Połączenie weryfikacyjne zostanie natychmiast wykonane na ten numer.
  4. Odbierz połączenie i posłuchaj sześciocyfrowego kodu.
  5. Wprowadź kod w dashboardzie. Masz pięć prób, a zaakceptowany kod zmienia status na Verified.

Weryfikacja identyfikatora dzwoniącego nie obciąża Twojego obszaru roboczego opłatą za połączenie weryfikacyjne. Rejestracja nadal wymaga uprawnienia Voice management oraz zgody konta na rejestrację zweryfikowanych numerów. Nadaj nazwę numerowi na jego stronie. Zobacz Nadawanie nazwy numerowi.

Po weryfikacji sprawdź kraj, do którego zamierzasz dzwonić, w sekcji Voice > Destinations. Weryfikacja próbuje włączyć kraj zweryfikowanego numeru, ale niedostępne kraje lub nieudana aktualizacja ustawień mogą pozostawić go wyłączonym. Zweryfikowany identyfikator dzwoniącego i włączony kraj docelowy to osobne wymagania.

Rejestracja i weryfikacja przez API

Zarejestruj numer, aby rozpocząć połączenie weryfikacyjne, a następnie prześlij kod dla ID zwróconego przez rejestrację. Wyświetl listę identyfikatorów dzwoniącego, aby znaleźć numer zarejestrowany w panelu. Możesz też zmienić nazwę identyfikatora dzwoniącego lub go usunąć. Odczyty wymagają voice_management:read; rejestracja, weryfikacja, zmiana nazwy i usuwanie wymagają voice_management:write. Dokumentacja API zawiera przykłady SDK, Bird w wierszu poleceń oraz MCP.

Jeśli nie udało się rozpocząć pierwotnego połączenia weryfikacyjnego, przesłanie kodu może uruchomić kolejne połączenie na zarejestrowany numer. Twoja organizacja nadal musi spełniać wymagania rejestracji. Jeśli kod wygaśnie lub próby zostaną wyczerpane, usuń identyfikator dzwoniącego i zarejestruj numer ponownie. Spowoduje to nowe połączenie weryfikacyjne; następnie prześlij nowy kod dla ID zwróconego przez tę rejestrację. Jeśli kod zostanie zaakceptowany, ale aktywacja zwróci 412 lub 503, własność nadal jest potwierdzona, a identyfikator dzwoniącego ma stan verified z outbound_enabled: false. Kod 412 oznacza niekompletną weryfikację tożsamości, którą kończysz w panelu, albo ocenę lub odmowę kwalifikowalności, która wymaga kontaktu z pomocą techniczną. Kod 503 oznacza, że ocena kwalifikowalności jest w toku lub niedostępna, więc spróbuj ponownie później. Po rozwiązaniu problemu wyślij puste żądanie weryfikacji dla tego samego ID; nie usuwaj go i nie rejestruj ponownie.

Po weryfikacji sprawdź kierunki Voice i włącz kraj numeru, jeśli jest obsługiwany i jest to potrzebne. Weryfikacja próbuje go włączyć, ale pomyślna weryfikacja identyfikatora dzwoniącego może pozostawić kierunek wyłączony, a połączenia wychodzące do tego kraju zablokowane.

Jedna weryfikacja na raz

Rejestracja może zwrócić E21036, gdy dostawca weryfikacji ma już wyzwanie dla tego numeru przypisane do innego obszaru roboczego lub celu. Poczekaj, aż ta weryfikacja się zakończy lub wygaśnie, a następnie zarejestruj numer ponownie. Dowód uzyskany dla innego obszaru roboczego nie weryfikuje numeru w Twoim.

Ta sama odmowa obejmuje numer zajęty z innego powodu: kod logowania lub weryfikacja Trust Hub już w trakcie dostarczania na ten numer. Jeśli żaden inny obszar roboczy nie weryfikuje tego numeru, to zazwyczaj jest przyczyna, a czas oczekiwania jest taki sam.

Weryfikacja zakończona w innym miejscu nie blokuje Cię: ten sam numer może być zweryfikowanym identyfikatorem dzwoniącego w więcej niż jednym obszarze roboczym, a każdy z nich potwierdza go osobno.

Statusy

StatusZnaczenie
PendingZarejestrowany, oczekuje na kod. Użyj Enter code w wierszu, aby dokończyć weryfikację
VerifiedKod został zaakceptowany. Numer może być prezentowany jako identyfikator dzwoniącego w połączeniach wychodzących
FailedKod wygasł lub próby zostały wyczerpane. Użyj Get a new code w wierszu, aby otrzymać nowe połączenie weryfikacyjne

Get a new code rejestruje numer ponownie i dzwoni na niego z nowym kodem. Jeśli pierwsze połączenie nigdy nie dotarło, a numer nadal ma status oczekujący, usuń identyfikator dzwoniącego i dodaj numer ponownie.

Jeśli odczytujesz te wartości z własnych narzędzi, dopasowuj te, które obsługujesz, a każdą inną traktuj jako status, którego nie obsługujesz, a nie jako błąd.

Zastrzeżenie dotyczące weryfikacji i dostarczania CLI

Bird wykonuje weryfikację CLI (Calling Line Identification), aby potwierdzić, że numer A jest prawidłowy i autoryzowany do użycia, zanim połączenia wychodzące będą mogły być realizowane z platformy. Ta weryfikacja zapewnia, że numer jest prawidłowy i pod kontrolą klienta.

Weryfikacja nie gwarantuje jednak dostarczenia CLI od końca do końca ani zestawienia połączenia, gdy CLI nie jest numerem pozyskanym przez Bird. Operatorzy tranzytowi i międzynarodowi stosują własne przepisy krajowe i polityki ruchu, które pozostają poza kontrolą Bird. Mogą one obejmować:

  • Ramy anty-spoofingowe i uwierzytelniania identyfikatora dzwoniącego (np. STIR/SHAKEN w USA, wytyczne Ofcom CLI w Wielkiej Brytanii)
  • Wymagania, aby CLI był numerem zarejestrowanym lokalnie lub numerem krajowym
  • Filtrowanie spamu i oszustw stosowane przez operatorów kończących połączenie
  • Ograniczenia dotyczące określonych kategorii ruchu, takich jak hazard, promocje finansowe, windykacja lub przekazy polityczne
  • Blokowanie połączeń międzynarodowych prezentujących krajowy CLI (ograniczenia "origin-based")
  • Listy zakazów inicjowania połączeń i blokowanie nakazane przez regulatorów

Z tych powodów Bird może zweryfikować CLI, ale nie może zagwarantować, że (1) CLI zostanie zachowany i wyświetlony stronie wywoływanej, ani że (2) połączenie zostanie zestawione przez trunki krajowe lub międzynarodowych partnerów i operatorów Tier 1. Aby zmaksymalizować dostarczalność CLI i wskaźniki realizacji połączeń, zalecamy korzystanie z numerów pozyskanych przez Bird, które są udostępniane i kierowane zgodnie z lokalnymi wymogami regulacyjnymi.

Nadawanie nazwy numerowi

Nazwa oznacza numer w dashboardzie i na liście Call from w dialerze. Nie jest wysyłana wraz z połączeniem.

Wybierz numer na liście Numbers, aby otworzyć jego stronę, a następnie ustaw Name i zapisz. Pozostaw pole puste, aby wyświetlać sam numer. Nadawanie nazwy działa przy dowolnym statusie i nie zmienia numeru ani jego weryfikacji.

Weryfikacja numeru, którego nie możesz odebrać

Ktoś musi odebrać połączenie weryfikacyjne i usłyszeć kod. Jeśli numer normalnie trafia do systemu bez obsługi, tymczasowo przekieruj go na telefon, który możesz odebrać, a potem przywróć oryginalne ustawienie. Skontaktuj się ze wsparciem, jeśli numer nie może odbierać połączeń.

Usuwanie identyfikatora dzwoniącego

Użyj Remove caller ID w wierszu numeru. Usunięcie weryfikacji odbiera ten dowód dla nowych połączeń. Numer przypisany do Twojego obszaru roboczego przez Bird może pozostać uprawniony dzięki swojemu przydziałowi; numer zewnętrzny, który traci swój dowód, jest odrzucany z komunikatem caller_id_not_verified. Połączenia już w toku są kontynuowane, a istniejące rekordy połączeń nie ulegają zmianie.

Następne kroki

StronaZakres
Wykonywanie połączeńCzego Bird oczekuje od INVITE, w tym nagłówka From
Trunki SIPTworzenie trunku i kontrola, które adresy i klucze mogą z niego korzystać

Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.