Odbieranie połączeń
Numer przypisany do Twojego obszaru roboczego może obsłużyć połączenie przychodzące na jeden z trzech sposobów: dostarczyć je do jednego z Twoich trunków SIP, przekierować na zweryfikowany numer lub odrzucić. Sposób obsługi to ustawienie na numerze, a numer ma dokładnie jedno ustawienie naraz.
Każdy numer zaczyna z ustawieniem odrzucania, więc numer, którego nikt nie skonfigurował, odprawia dzwoniących zamiast nie mieć żadnej odpowiedzi.
Wymagania wstępne
Zanim skierujesz numer na sposób obsługi:
- Numer, który może odbierać połączenia. Otwórz Voice > Numbers i sprawdź w kolumnie Directions, czy jest oznaczenie przychodzące. Numer zarejestrowany jako identyfikator dzwoniącego od innego operatora nie odbiera tu połączeń: ten operator kieruje połączenia na niego, więc nie ma on ustawienia obsługi.
- Do dostarczania na trunk: trunk SIP z włączonym odbieraniem połączeń i co najmniej jedną bramką dostarczania.
- Do przekierowania: zweryfikowany identyfikator dzwoniącego, na który chcesz przekierować.
- Aby zmienić ustawienie przez API lub CLI: klucz API z uprawnieniem voice_management na poziomie zapisu. To uprawnienie obejmuje konfigurację głosową; uprawnienie voice obejmuje ruch połączeń i statystyki, więc odczyt dziennika połączeń wymaga tego drugiego.
Dostarczanie połączeń do trunku SIP
Dostarczanie wybiera Twój własny system telefoniczny pod adresami zadeklarowanymi na trunku. Najpierw włącz kierunek przychodzący, bo numer można skierować tylko na trunk, który już przyjmuje połączenia przychodzące.
- Otwórz Voice > SIP Trunks, otwórz trunk i w sekcji Inbound calling wybierz Enable inbound.
- Dodaj co najmniej jedną bramkę w tej samej sekcji. Trunk bez bramki odrzuca każde połączenie przychodzące na numery, które obsługuje.
- Otwórz Voice > Numbers, otwórz numer i w sekcji Inbound routing wybierz Deliver to a SIP trunk.
- Wybierz trunk i kliknij Save. Na liście pojawiają się tylko trunki z włączonym odbieraniem połączeń.
Kolumna Used for na liście Numbers pokazuje wtedy numer jako dostarczany do tego trunku, a strona trunku wyświetla numery, które obsługuje.
Czego wymaga bramka
Bramka to jeden adres, na który dostarczane jest połączenie, oraz sposób, w jaki ten peer oczekuje zapisu dwóch numerów połączenia:
| Ustawienie | Opis |
|---|---|
| SIP URI | Host Twojego systemu telefonicznego z opcjonalnym portem, na przykład sip:pbx.example.com:5060. Podaj sam host: URI zawierające część użytkownika zostanie odrzucone |
| Priority | Kolejność, w jakiej próbowane są bramki, od najniższej wartości |
| Destination format | Sposób zapisu numeru docelowego dla tego peera. Domyślnie E.164 |
| Origination format | Sposób zapisu numeru dzwoniącego dla tego peera, w nagłówku P-Asserted-Identity dostarczonego połączenia. Domyślnie E.164 |
Bramki o tym samym priorytecie dzielą połączenia równomiernie i przy danym połączeniu dowolna z nich może być wypróbowana jako pierwsza. Aby przełączyć dostarczanie na drugi adres, nadaj tej bramce wyższy numer priorytetu: zostanie wypróbowana, gdy pierwsza nie odpowie.
Oba formaty numerów to szablony z jednym symbolem zastępczym {number}, który oznacza numer bez wiodącego +. Format docelowy jest umieszczany przed hostem URI SIP, więc 1234#{number} dostarcza połączenie do +31201234567 jako sip:1234#31201234567@pbx.example.com:5060. Domyślna wartość obu to +{number}, czyli E.164. Format niezawierający żadnego {number} wysyła każdy numer obsługiwany przez trunk na jeden stały adres.
Warning: turning inbound calling off on a trunk, or deleting the trunk, puts every number pointing at it back on reject. Turning inbound back on does not restore them, so each number has to be pointed at a trunk again.
Przekierowanie połączeń na inny numer
Przekierowanie odbiera połączenie przychodzące i wykonuje drugie połączenie na zweryfikowany numer, a następnie łączy oba.
- Otwórz Voice > Numbers, otwórz numer i w sekcji Inbound routing wybierz Forward to another number.
- Wybierz numer docelowy przekierowania. Na liście znajdują się Twoje zweryfikowane identyfikatory dzwoniącego, ponieważ przekierowanie może wskazywać tylko numer, którego kontrolę udowodniłeś.
- Wybierz, który numer przekierowane połączenie ma pokazywać jako dzwoniącego, a następnie kliknij Save.
Cel przekierowania jest sprawdzany w momencie ustawienia i ponownie przy każdym przekierowywanym połączeniu. Identyfikator dzwoniącego, który później usuniesz, zatrzymuje przekierowywanie zamiast kontynuować, a połączenia przychodzące są od tego momentu odrzucane.
Przekierowane połączenie dzwoni przez 45 sekund, zanim zostanie porzucone. To dłużej niż przy dostarczaniu na trunk, ponieważ po drugiej stronie jest zwykle telefon osoby, a nie system telefoniczny.
Przekierowanie wykonuje połączenie, więc do drugiego odcinka mają zastosowanie reguły wychodzące: przekierowanie do kraju, którego nie włączyłeś w sekcji Destinations, jest odrzucane z kodem destination_not_enabled.
Jedno przekierowanie, dwa rekordy połączeń
Przekierowane połączenie tworzy dwa rekordy z tym samym session_id:
| Rekord | Opis |
|---|---|
| Połączenie przychodzące | direction ma wartość inbound, a route podaje, że numer był ustawiony na przekierowanie, na jaki numer i jaki numer prezentował przekierowany odcinek |
| Połączenie przekierowane | direction ma wartość outbound, z numeru prezentowanego przez odcinek na numer docelowy przekierowania. Nie ma własnego route |
Pogrupuj je po session_id, aby zobaczyć całe połączenie. Rekord połączenia przychodzącego zawiera informację o tym, jak numer był skonfigurowany.
Wybór numeru prezentowanego przez przekierowane połączenie
Przekierowane połączenie może prezentować odbierającemu jeden z dwóch numerów, a wybór wpływa zarówno na to, co zobaczy, jak i na prawdopodobieństwo ingerencji operatora w połączenie:
- Numer dzwoniącego to własny numer dzwoniącego, więc telefon dzwoni tak, jakby osoba wybrała numer bezpośrednio, a połączenie można oddzwonić z dziennika. Ponieważ numer nie należy do Ciebie, niektórzy operatorzy, najczęściej w USA i częściach Europy, oznaczają takie połączenia jako niezweryfikowane, podmieniają numer lub je filtrują.
- Numer wybrany to numer, który wybrał dzwoniący, czyli jeden z Twoich. Odbierający widzi, na który z Twoich numerów zadzwoniono, a nie kto dzwoni.
Nie ma wartości domyślnej. Określ wybór przy każdym przekierowaniu ustawianym przez API lub CLI.
Dostępne wartości dla Twojego obszaru roboczego są podane na samym numerze, w forward_as_options w jego inbound_configuration. Prezentowanie numeru wybranego wymaga zatwierdzenia Twojego obszaru roboczego do wykonywania połączeń z numerów kupionych od nas, a to zatwierdzenie nie jest jeszcze dostępne, więc forward_as_options oferuje tylko numer dzwoniącego, a przekierowanie prezentuje własny numer osoby dzwoniącej. Ustawienie numeru wybranego jest odrzucane do tego czasu.
Przy odczycie forward_as to wartość faktycznie przenoszona przez połączenia, która może różnić się od ostatnio zapisanej.
Sprawdź, co numer zrobił z połączeniem
Rekord połączenia przychodzącego zawiera route obok statusu, a route to sposób obsługi ustawiony na numerze w momencie obsłużenia połączenia. Zmiana ustawienia numeru po fakcie nie zmienia informacji w rekordach wcześniejszych połączeń.
| route.type | Co zrobił numer |
|---|---|
| trunk | Połączenie zostało dostarczone na trunk SIP wskazany w trunk_id |
| forward | Połączenie zostało przekierowane na numer w forward_to, prezentując numer w forward_as |
| reject | Numer odrzucił połączenie |
route mówi, jak numer był ustawiony, a nie czy to zadziałało. Trasa trunk przy połączeniu, które nigdy nie zostało zestawione, oznacza numer skierowany na trunk, który nie przyjął połączenia, a status połączenia niesie informację o wyniku. route jest nieobecne przy połączeniach wychodzących i przy połączeniach zarejestrowanych przed wprowadzeniem tego pola.
W panelu otwórz połączenie z Voice > Calls i odczytaj wiersz Inbound route, który prowadzi do numeru, którego ustawienia o nim zdecydowały. Przez API pole route jest dostępne na GET /v1/voice/calls/{call_id} i GET /v1/voice/calls, a direction filtruje listę do połączeń przychodzących.
Diagnozowanie odrzuconego połączenia przychodzącego
Odrzucone połączenie przychodzące jest zapisywane ze statusem rejected. Dwie różne przyczyny go generują, a rejection_reason je rozróżnia:
- Odrzucone bez rejection_reason. Sam numer odrzucił połączenie. Połączenie nie naruszyło żadnej naszej reguły, więc nie podaje powodu, a route wskazuje, jak numer był ustawiony. Trasa reject to numer, którego nikt nigdzie nie skierował, lub numer celowo ustawiony na odrzucanie.
- Odrzucone z rejection_reason. Połączenie nie przeszło jednej z naszych kontroli przed dotarciem do Twojego systemu telefonicznego. Powód wskazuje kontrolę. Odrzucone połączenia zawierają listę wszystkich powodów i sposobów naprawy.
failed to inny status i nie oznacza odrzucenia: oznacza, że podjęto próbę połączenia i nie powiodła się, a sip_response_code zawiera odpowiedź, która wróciła.
Odczytaj route i rejection_reason razem, aby rozróżnić odrzucenia:
| route i powód | Przyczyna |
|---|---|
| reject, brak powodu | Numer nie jest skierowany na żaden sposób obsługi. Usunięcie trunku lub wyłączenie jego odbierania połączeń przywraca tu każdy numer, który na niego wskazywał, więc numer, który wcześniej działał, może się tu znaleźć |
| trunk, no_route_found | Numer jest skierowany na trunk, a ten trunk nie ma bramki, na którą mógłby dostarczyć połączenie. Dodaj bramkę na stronie trunku |
| forward, brak powodu | Cel przekierowania nie jest już zweryfikowanym identyfikatorem dzwoniącego. Zweryfikuj go ponownie w sekcji Caller IDs lub przekieruj na inny numer |
| forward, destination_not_enabled | Nie udało się wykonać drugiego odcinka do kraju celu przekierowania. Włącz ten kraj w sekcji Destinations |
Limity konta dotyczą też połączeń przychodzących: po przekroczeniu salda portfela, dziennego limitu wydatków na głos w organizacji lub limitów współbieżności i liczby połączeń na sekundę połączenie przychodzące jest odrzucane z odpowiednim powodem. Voice overview opisuje same limity.
Sprawdź koszt odebranego połączenia
Odbieranie połączeń jest płatne. Stawka zależy od kraju i typu numeru odbierającego i jest publikowana dla każdego kraju w sekcji Receiving calls na stronie cennika głosowego obok stawek za połączenia wychodzące.
Przekierowanie jest rozliczane jako dwa połączenia: przychodzące po stawce za odbiór i odcinek, który wykonujemy, po stawce wychodzącej dla numeru docelowego przekierowania. Pojedyncza opłata manipulacyjna jest naliczana raz za połączenie, a nie raz za odcinek.
Portfel jest sprawdzany przed dostarczeniem połączenia przychodzącego, więc saldo niewystarczające do jego pokrycia oznacza odrzucenie połączenia zamiast obciążenia Cię po fakcie. Koszty i rozliczenia opisują, jak działają czas podlegający opłacie, stawki i portfel w obu kierunkach.
Następne kroki
| Strona | Zakres |
|---|---|
| Trunki SIP | Tworzenie trunku, jego dwa kierunki oraz kontrola uprawnień do wysyłania |
| Identyfikatory dzwoniącego | Rejestracja numeru i potwierdzenie kontroli nad nim |
| Dziennik połączeń | Każde pole rekordu połączenia i każdy powód odrzucenia |
| Zdarzenia głosowe | Otrzymywanie wyników połączeń wysyłanych do Twoich systemów |
| Rozwiązywanie problemów z głosem | Diagnozowanie połączenia, które nie dochodzi, na podstawie objawu |
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.