# 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**](https://bird.com/dashboard/w/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](/docs/guides/voice/sip-trunks) z włączonym odbieraniem połączeń i co najmniej jedną bramką dostarczania. - **Do przekierowania:** [zweryfikowany identyfikator dzwoniącego](/docs/guides/voice/caller-ids), 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. 1. Otwórz **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), otwórz trunk i w sekcji **Inbound calling** wybierz **Enable inbound**. 2. 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. 3. Otwórz **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), otwórz numer i w sekcji **Inbound routing** wybierz **Deliver to a SIP trunk**. 4. 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. 1. Otwórz **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), otwórz numer i w sekcji **Inbound routing** wybierz **Forward to another number**. 2. 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ś. 3. 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](/docs/guides/voice/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**](https://bird.com/dashboard/w/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}`](/docs/api/reference/get-voice-call) i [`GET /v1/voice/calls`](/docs/api/reference/list-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](/docs/guides/voice/call-log#rejected-calls) 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](/docs/guides/voice/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](/docs/guides/voice/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](/docs/guides/voice/overview#limits) 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](/pricing/voice) 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](/docs/guides/voice/placing-calls#cost-and-billing) opisują, jak działają czas podlegający opłacie, stawki i portfel w obu kierunkach. ## Następne kroki | Strona | Zakres | | ---------------------------------------------------------------------- | ------------------------------------------------------------------------ | | [Trunki SIP](/docs/guides/voice/sip-trunks) | Tworzenie trunku, jego dwa kierunki oraz kontrola uprawnień do wysyłania | | [Identyfikatory dzwoniącego](/docs/guides/voice/caller-ids) | Rejestracja numeru i potwierdzenie kontroli nad nim | | [Dziennik połączeń](/docs/guides/voice/call-log) | Każde pole rekordu połączenia i każdy powód odrzucenia | | [Zdarzenia głosowe](/docs/guides/voice/events) | Otrzymywanie wyników połączeń wysyłanych do Twoich systemów | | [Rozwiązywanie problemów z głosem](/docs/guides/voice/troubleshooting) | Diagnozowanie połączenia, które nie dochodzi, na podstawie objawu | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/products/voice) (product) [Get an implementation brief](/learn/workspace?topic=voice)