Rozwiązywanie problemów z Voice

Zacznij od logu połączeń. Obecność wpisu i jego pola wskazują, które kroki sprawdzić.

Dla połączeń rozpoczętych przez API sprawdź najpierw odpowiedź Create Call i historię wykonań. Skorzystaj z rozwiązywania problemów z sekwencjami w sprawach podglądu, publikacji, ścieżek klawiatury i tras sekwencji dla połączeń przychodzących. Poniższe kontrole połączenia dotyczą połączeń przez trunki SIP.

Jeśli nie widzisz żadnych wpisów połączeń, najpierw sprawdź te elementy:

1. Jesteś we właściwym obszarze roboczym. Wpisy połączeń należą do obszaru roboczego, w którym znajduje się numer lub trunk. Przełącz się na niego, a następnie otwórz Voice > Legs.
2. Połączenie dotarło do Bird. W przypadku połączenia przychodzącego to operator dzwoniącego decyduje, dokąd trafi połączenie, a numer skierowany na trunk bez zapisanej bramki odrzuca połączenie, zanim powstanie wpis. W przypadku połączenia wychodzącego zobacz Połączenie wychodzące nie pojawia się w logu połączeń: odmowa przyjęcia nie pozostawia wpisu.
3. Filtry go nie ukrywają. Wyczyść filtr statusu i poszerz zakres dat.

Połączenie wychodzące nie pojawia się w logu połączeń

W przypadku połączenia realizowanego przez trunk SIP odmowa może nastąpić, zanim powstanie wpis. Sprawdź te częste przyczyny:

• Trunk nie obsługuje jeszcze połączeń wychodzących. Nowy trunk nie przepuszcza żadnych połączeń, dopóki nie włączysz na nim połączeń wychodzących, i odrzuca każdą próbę niezależnie od poświadczeń, jakie przedstawia połączenie.
• Trunk nie ma jeszcze sposobu na rozpoznanie Ciebie. Nowy trunk odrzuca każde połączenie, dopóki nie dodasz zakresu IP, dozwolonego klucza API lub poświadczeń sesji.
• Połączenie przyszło z adresu spoza listy dozwolonych IP trunka. Za NAT-em porównaj publiczny adres routera z listą dozwolonych IP trunka. Prywatny adres systemu telefonicznego nie dociera do Bird.
• Uwierzytelnianie hasłem nie powiodło się. Sprawdź, czy nazwa użytkownika to bird. Hasło musi być sekretem dozwolonego klucza API lub niewygasłym poświadczeniem sesji. Trunk musi też oferować algorytm Digest, którego użył Twój system telefoniczny.
• Połączenie było zaadresowane do domeny SIP, której Bird nie rozpoznaje. Twoje urządzenia muszą umieścić domenę SIP trunka w hoście Request-URI. Skopiuj domenę w całości ze strony trunka, zamiast ją składać ręcznie. Połączenie zaadresowane do innej nazwy hosta lub adresu Bird nie dociera do Twojego trunka.

Odpowiedź, którą otrzymują Twoje urządzenia, wskazuje, która kontrola się nie powiodła. 407 Proxy Authentication Required oznacza, że trunk żąda hasła; przy włączonych poświadczeniach sesji żąda go od każdego dzwoniącego. 403 Forbidden oznacza, że trunk nie przyjął połączenia: host Request-URI nie jest domeną SIP Twojego trunka, połączenia wychodzące są wyłączone, adres jest spoza listy dozwolonych albo hasło nie przeszło weryfikacji. 503 Auth Unavailable oznacza, że Bird nie mógł sprawdzić połączenia, więc spróbuj ponownie.

W przypadku połączenia sekwencji najpierw sprawdź, czy żądanie połączenia zostało zaakceptowane i czy istnieje przebieg. Podgląd w symulatorze nie wykonuje połączenia. Rzeczywisty test wymaga zapisanego szkicu lub aktywnej publikacji, uprawnień do zapisu dla zarządzania i połączeń Voice, uprawnionego identyfikatora dzwoniącego oraz włączonego kraju docelowego. Przewodnik po kreatorze sekwencji wyjaśnia te kontrole.

Połączenie jest odrzucone z powodem odrzucenia

Bird odmówił połączenia przed wybraniem operatora, a powód wskazuje kontrolę, której połączenie nie przeszło. Otwórz połączenie i użyj linku w panelu odrzucenia do odpowiedniego ustawienia. Odrzucone połączenia wymieniają każdy powód i sposób naprawy.

caller_id_not_verified to powód, na który nowi klienci trafiają najczęściej, zwykle dlatego, że wpisują nazwę użytkownika Digest w miejscu identyfikatora dzwoniącego: to dwa różne pola.

Połączenie zakończyło się niepowodzeniem, a nie odrzuceniem

Failed to nie odmowa. Połączenie zostało podjęte i nie zadziałało, a SIP response zawiera zwrócony kod. 486 to numer zajęty, 404 to numer nieprzydzielony. Zazwyczaj wskazuje to na wybrany numer, a nie na Twoją konfigurację.

Połączenie odrzucone przez Bird ma status Rejected, a nie Failed, więc filtruj log po Rejected, gdy szukasz połączenia, które nie przeszło jednej z kontroli Bird.

Połączenie jest odrzucone bez powodu odrzucenia

W przypadku połączenia wychodzącego druga strona odmówiła go wprost, a SIP response zawiera jej kod.

W przypadku połączenia przychodzącego wybrany numer odrzucił połączenie, co nie narusza żadnej kontroli i dlatego nie podaje powodu. Otwórz połączenie i przeczytaj Inbound route: trasa reject oznacza numer ustawiony na odmowę albo numer bez własnej trasy, gdy domyślna trasa obszaru roboczego jest ustawiona na odrzucanie. Odbieranie połączeń omawia każdą przyczynę odrzucenia przychodzącego na podstawie trasy i powodu.

Osoba, do której dzwonisz, zobaczyła inny numer

Połączenie ma wpis i nie ma powodu odrzucenia, więc przeszło wszystkie kontrole Bird. Problem leży za Bird: operator docelowy podmienił identyfikator dzwoniącego albo odmówił połączenia, które go przedstawia. Ta sama przyczyna objawia się jako numer, który łączy się w jednym kraju, a w innym nigdy.

Weryfikacja dowodzi, że kontrolujesz identyfikator dzwoniącego. Nie zobowiązuje ona operatora dostarczającego połączenie do jego akceptacji, a operatorzy stosują własne krajowe reguły wobec numeru, który nie został pozyskany przez Bird. Sprawdź zastrzeżenie dotyczące weryfikacji i dostarczania CLI, które opisuje stosowane praktyki, w tym krajowe wymagania CLI, blokowanie na podstawie pochodzenia i listy numerów zabronionych do inicjowania połączeń.

Aby sprawdzić, jaki rodzaj numeru przedstawiłeś, otwórz go w Voice > Numbers i przeczytaj panel u góry jego strony. Numer kupiony od Bird pokazuje swoją subskrypcję, tak samo numer kupiony i dodatkowo zweryfikowany. Tylko numer posiadany gdzie indziej pokazuje samą weryfikację. Subskrypcja oznacza, że numer został pozyskany przez Bird, więc zastrzeżenie go nie dotyczy. Przedstawianie numeru pozyskanego przez Bird podnosi wskaźniki dostarczania i zakończenia połączeń na kierunkach, które odrzucają numer jedynie zweryfikowany.

Połączenie przychodzące nigdy nie dociera do Twojego systemu telefonicznego

Numer odebrał połączenie, ale dostarczenie się nie powiodło. Sprawdź w tej kolejności:

1. Odczytaj trasę przychodzącą połączenia (Inbound route). Informuje ona, na który trunk lub przekierowanie numer wskazywał w momencie nadejścia połączenia. Trasa reject oznacza, że numer ma własną trasę ustawioną na odrzucanie albo nie ma własnej trasy, a domyślna trasa obszaru roboczego jest ustawiona na odrzucanie. Otwórz numer, aby sprawdzić, który przypadek zachodzi: numer ustawiony na odrzucanie ignoruje trasę domyślną. Numer, którego trunk został usunięty lub ma wyłączone połączenia przychodzące, wraca do trasy domyślnej, a trasa domyślna wskazująca na ten trunk wraca do odrzucania.
2. Sprawdź, czy trunk może dostarczać połączenia. Otwórz Inbound routing trunka. Bramka musi należeć do grupy, a Default route (lub reguła) musi kierować połączenia do tej grupy. Trasa domyślna ustawiona na Reject odrzuca każde połączenie bez powodu odrzucenia, a trunk bez zapisanej bramki odrzuca połączenie, zanim powstanie wpis. Usuń przyczynę ostrzeżenia Calls never reach some gateways, jeśli panel wyświetli je przy zapisywaniu.
3. Sprawdź adres bramki. Bird wybiera bramki grupy w kolejności ustawionej w grupie i rezygnuje, gdy żadna nie odpowiada. Potwierdź hosta URI SIP, jego port oraz to, że Twój system telefoniczny przyjmuje na nim połączenia od Bird.
4. W przypadku przekierowania sprawdź, czy cel jest nadal zweryfikowany. Cel przekierowania jest ponownie sprawdzany przy każdym połączeniu, więc usunięty identyfikator dzwoniącego zatrzymuje przekierowanie od tego momentu.
5. Sprawdź odpowiedź swoich urządzeń. Połączenie, które dotarło do Twojej bramki i zostało tam odrzucone, ma zwykle status Failed (odpowiedź 6xx jest widoczna jako Rejected), a SIP response zawiera kod Twoich urządzeń, np. 403 lub 412. Bird podjął próbę połączenia, więc poprawka leży po Twojej stronie: sprawdź, czy Twój SBC przyjmuje połączenia z adresów sygnalizacyjnych Bird oraz format numeru wysyłany przez bramkę.

Jeśli numer korzysta z Run a sequence, sprawdź powiązaną sekwencję i punkt wejścia połączenia zamiast trunka. Potwierdź aktywną publikację, punkt wejścia akceptujący puste dane oraz to, czy dzwoniący jest testerem szkicu. Sprawdź wynik przebiegu sekwencji i gałąź błędu. Zmiana szkicu nie zmienia wersji używanej przez zwykłych dzwoniących.

Telefon w przeglądarce nie dzwoni lub nie może wybrać numeru

Najpierw sprawdź status na dole telefonu:

1. Wybierz Online, aby otrzymywać połączenia. Grupa dzwonienia pomija członków, którzy mają status Offline, Busy, prowadzą już rozmowę lub mają status Not accepting calls po trzech kolejnych nieodebranych połączeniach. Twój status wyjaśnia każdy z nich.
2. Przejdź w tryb online, aby dzwonić. Telefon ze statusem Offline nie może wykonywać połączeń. Ze statusem Online, Busy i Not accepting calls jest to możliwe.
3. Przenieś połączenia do tej przeglądarki. W każdym obszarze roboczym możesz być online jednocześnie tylko na jednym urządzeniu i w jednej karcie. Status Offline · Active on another device oferuje przycisk Take over, a status Offline · Calls are handled in another tab oferuje przycisk Use here.
4. Sprawdź limit użytkowników online. Offline · Limit of users online reached oznacza, że w Twojej organizacji jest online tylu użytkowników, ilu ona dopuszcza. Zobacz Limit użytkowników online.
5. Włącz dźwięk. Po przeładowaniu strony przeglądarka może blokować dzwonek, dopóki nie wejdziesz w interakcję ze stroną. Menu statusu oferuje wtedy opcję Turn on sound.

Jeśli telefon jest online, a połączenie nadal do Ciebie nie dzwoni, odczytaj Inbound route połączenia w logu połączeń. Wskazuje ona grupę dzwonienia, do której trafiło połączenie, więc możesz sprawdzić, czy jesteś jej członkiem i czy numer kieruje połączenia do tej grupy.

Twój klient odpowiada MD5 i nie może się połączyć

Niektóre urządzenia źle obsługują wyzwanie zaczynające się od SHA-256. Ustaw trunk na tylko MD5.

Połączenia się zestawiają, ale dźwięk jest jednokierunkowy

Twój klient jest za NAT-em i jego media trafiają na adres prywatny. Włącz obsługę NAT lub STUN w kliencie.

Jeśli Twoje urządzenie jest osiągalne, a dźwięk nadal nie działa w jednym kierunku, sprawdź, czy zapora sieciowa przepuszcza adresy mediów Bird na portach UDP od 2500 do 32499.

Następne kroki