--- title: "Skonfiguruj trunk SIP do odbierania i wykonywania połączeń" description: "Połącz swoją centralę PBX lub SBC z Bird w tej kolejności: utwórz trunk, kieruj połączenia przychodzące do swoich bramek, włącz połączenia wychodzące i przetestuj oba kierunki." canonical: "https://bird.com/pl-pl/dokumentacja/guides/voice/sip-trunk-setup" --- # Skonfiguruj trunk SIP do odbierania i wykonywania połączeń Ta strona opisuje pełną konfigurację trunka w kolejności, jakiej wymaga panel. Jeśli pominięcie kroku daje widoczny objaw, krok go podaje, więc stronę możesz też wykorzystać jako listę kontrolną, gdy połączenie testowe się nie powiedzie. Znaczenie poszczególnych ustawień opisują strony [Trunki SIP](/docs/guides/voice/sip-trunks), [Odbieranie połączeń](/docs/guides/voice/receiving-calls) i [Wykonywanie połączeń](/docs/guides/voice/placing-calls). ## Zanim zaczniesz - Obszar roboczy Bird. Połączenia, numery i trunki należą do jednego obszaru roboczego, więc wykonaj wszystkie kroki w tym samym. - Publiczne adresy Twojego sprzętu: hosty, do których Bird ma kierować połączenia, oraz adresy, z których Twój sprzęt wysyła SIP. - Dla połączeń przychodzących: numer Bird w tym obszarze roboczym. Dla połączeń wychodzących: identyfikator dzwoniącego, czyli numer Bird w obszarze roboczym lub numer, który [zweryfikowano](/docs/guides/voice/caller-ids). - Numer Bird, którego `status` ma wartość `active`. Numer, który wciąż czeka na dokumenty potwierdzające własność lub na rejestrację, nie obsługuje połączeń przychodzących ani wychodzących: zobacz [Złóż dokumenty potwierdzające własność numeru](/docs/guides/numbers/ownership-paperwork). ## 1. Utwórz trunk Otwórz **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), wybierz **Add new SIP trunk**, wpisz nazwę i wybierz **Create trunk**. Nowy trunk nie obsługuje połączeń w żadnym kierunku, dopóki nie włączysz każdego z nich. ## 2. Włącz połączenia przychodzące W sekcji **Inbound calling** wybierz **Enable inbound**. Poniżej pojawi się sekcja **Inbound routing**. Jeśli pominiesz ten krok, nie skierujesz numerów na trunk, ponieważ trunka nie będzie na liście trunków numeru. ## 3. Dodaj bramy W sekcji **Inbound routing** otwórz kartę **Gateways** i wybierz **Add gateway** dla każdego adresu, na który Bird ma dostarczać połączenia: | Pole | Co wpisać | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Etykieta, którą rozpoznasz, na przykład `Primary SBC` | | **Host** | Nazwa hosta lub publiczny adres IP Twojego sprzętu, bez `sip:` i bez części użytkownika | | **Port** | Pozostaw puste, aby użyć domyślnego portu transportu, lub wpisz port, na którym nasłuchuje Twoje urządzenie | | **Transport** | UDP, TCP lub TLS, zgodnie z ustawieniami Twojego urządzenia | | **R-URI user part** | Sposób zapisu wybranego numeru w Request-URI. Domyślnie E.164 z `+` | | **Origination format** | Sposób zapisu numeru dzwoniącego. Domyślnie E.164 z `+` | | **Priority** | Miejsce bramki w grupie **All gateways (automatic)**: bramki z niższymi numerami dzwonią pierwsze, a bramki z równymi numerami dzielą się połączeniami. Domyślnie 0 | Jeśli Twoje urządzenie oczekuje numerów bez początkowego `+`, otwórz listę formatu i wybierz **Without the plus** albo prefiks międzynarodowy `00` lub `011`. Formaty numerów opisuje strona [Czego potrzebuje bramka](/docs/guides/voice/receiving-calls#what-a-gateway-needs). Bird przekazuje nagłówek `To` w takiej postaci, w jakiej wysłał go operator dzwoniącego. Jeśli Twoje urządzenie odczytuje wybrany numer z `To`, wybierz **Rewrite To user part** i zbuduj ten sam format co w **R-URI user part**. Bird zastąpi wtedy część użytkownika `To` w połączeniach do tej bramki. Twoja bramka musi przyjmować połączenia od Bird bez wyzwania SIP Digest, ponieważ Bird na nie nie odpowiada. ## 4. Wybierz grupę, w której są wyszukiwane bramki dla połączeń Bird dostarcza połączenie do grupy bramek. Każda bramka należy do grupy **All gateways (automatic)**, która próbuje bramek w kolejności ich wartości **Priority** na karcie **Gateways**, zaczynając od najniższej. Aby skonfigurować przez nią przełączanie awaryjne, nadaj bramce zapasowej wyższą wartość **Priority** niż bramce głównej. Jeśli karta **Groups** nie pokazuje grupy **All gateways (automatic)**, zapisany routing trunka zawiera w jej miejscu własną grupę, a **Priority** nie ustala kolejności w tej grupie; zobacz [Używanie grupy automatycznej](/docs/guides/voice/hunt-groups#use-the-automatic-group). Gdy do trunka, którego routingu nigdy nie zapisano, dodasz pierwszą bramkę, dashboard skieruje trasę domyślną na grupę **All gateways (automatic)**. Jeśli potrzebujesz innych czasów dzwonienia, wag lub tylko części bramek, utwórz własną grupę: na karcie **Groups** wybierz **Add group**, nadaj grupie nazwę i dla każdej bramki użyj **Add gateway to group**. Każdą kolejność, czas dzwonienia i moment zakończenia wyszukiwania opisuje strona [Przełączanie awaryjne i rozdzielanie połączeń przychodzących](/docs/guides/voice/hunt-groups). ## 5. Skieruj trasę domyślną na grupę Na karcie **Rules** znajdź **Default route** (**No rule above matched**). Ustaw **Then** na **Route to group** i wybierz swoją grupę. Wybierz **Review and save**, a następnie potwierdź. Trasa domyślna obsługuje każde połączenie, do którego nie pasuje żadna reguła, więc gdy reguł nie ma, obsługuje wszystkie połączenia. Jeśli jest ustawiona na **Reject**, te połączenia są odrzucane, zanim dotrą do Twojego sprzętu, nawet jeśli bramki są w grupie. Podczas przeglądu dashboard wyświetla ostrzeżenie **Calls never reach some gateways**, gdy bramka nie należy do żadnej grupy, do której reguła lub trasa domyślna kieruje połączenia. Usuń przyczynę tego ostrzeżenia przed testem. Ta trasa domyślna należy do trunka. Jest niezależna od ustawienia obszaru roboczego **Calls to numbers without their own route** na stronie **Numbers**, które określa, co dzieje się z numerami bez własnej trasy. ## 6. Skieruj swoje numery na trunk 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**. Wybierz trunk i zapisz. Numer bez własnej trasy korzysta z trasy domyślnej obszaru roboczego, która początkowo odrzuca połączenia. Aby od razu kierować wszystkie takie numery do tego trunka, ustaw **Calls to numbers without their own route** na ten trunk. Zobacz [Ustawianie trasy domyślnej](/docs/guides/voice/receiving-calls#set-a-default-route). Jeśli pominiesz ten krok, a trasa domyślna obszaru roboczego nadal odrzuca połączenia, połączenia przychodzące zostaną odrzucone, a w rekordzie połączenia pole **Inbound route** pokaże **Reject the leg**. ## 7. Włącz połączenia wychodzące i określ, kto może je wysyłać W sekcji **Outbound calling** wybierz **Enable outbound**. Pojawi się sekcja **Connection** z polem **SIP domain** trunka. Bird rozpoznaje Twój trunk po tej domenie, więc skopiuj ją w całości. Następnie dodaj co najmniej jeden sposób rozpoznawania Twojego sprzętu: - **Allowed IP addresses**: publiczne adresy, z których Twój sprzęt wysyła SIP. Za NAT użyj publicznego adresu routera. - **Allowed API keys**: dla sprzętu, który odpowiada na wyzwanie Digest, z nazwą użytkownika `bird` i sekretem klucza API jako hasłem. Dopóki połączenia wychodzące nie są włączone, trunk odrzuca każde połączenie wychodzące. Dopóki trunk nie potrafi rozpoznać Twojego sprzętu, połączenia są odrzucane, zanim powstanie rekord połączenia. Zobacz [Kontrolowanie, kto może wysyłać połączenia](/docs/guides/voice/sip-trunks#controlling-who-may-send-calls). ## 8. Skonfiguruj PBX lub SBC W swoim PBX lub SBC: - **Wysyłaj połączenia wychodzące na domenę SIP trunka.** Wpisz domenę SIP jako host w Request-URI. Użyj portu `5060` (UDP lub TCP) albo `5061` (TLS). Połączenie, którego host w Request-URI ma inną nazwę, zostanie odrzucone. - **Wybieraj numery w formacie międzynarodowym.** Wpisz wybierany numer w części użytkownika Request-URI jako `+` i kod kraju, na przykład `+442071234567`. Nie dodawaj prefiksu technicznego. Zobacz [Czego Bird oczekuje w INVITE](/docs/guides/voice/placing-calls#what-bird-expects-on-the-invite). - **Przedstawiaj uprawniony identyfikator dzwoniącego** w nagłówku `From`. - **Oferuj G.711** (A-law lub µ-law) i wysyłaj DTMF jako zdarzenia telefoniczne RFC 4733. Ta sama sekcja tamtej strony opisuje media. - **Zezwól na adresy Bird.** Jeśli Twoja zapora lub SBC akceptuje tylko adresy z listy, zezwól na adresy sygnalizacji i mediów regionu Twojego trunka, wymienione na stronie [Wymagania sieciowe trunków SIP](/docs/guides/voice/network-requirements). ## 9. Włącz kraje, do których dzwonisz Otwórz **Voice** > [**Destinations**](https://bird.com/dashboard/w/voice/destinations), zaznacz każdy kraj, do którego dzwonisz, i wybierz **Save changes**. Nowy obszar roboczy nie ma włączonego żadnego kraju, a połączenie do wyłączonego kraju jest odrzucane z kodem `destination_not_enabled`. Zobacz [Kierunki połączeń głosowych](/docs/guides/voice/destinations). ## 10. Przetestuj oba kierunki 1. **Przychodzące:** zadzwoń na swój numer Bird ze zwykłego telefonu, a następnie otwórz **Voice** > [**Legs**](https://bird.com/dashboard/w/voice/legs) w tym samym obszarze roboczym. 2. **Wychodzące:** wykonaj ze swojego sprzętu połączenie na dowolny osiągalny numer we włączonym kraju, prezentując jako identyfikator dzwoniącego swój numer Bird lub zweryfikowany numer. Nie potrzebujesz do tego drugiego numeru Bird. 3. Otwórz każdy odcinek połączenia. **Inbound route** pokazuje, co numer miał zrobić zgodnie z ustawieniami. Odrzucone połączenie pokazuje przyczynę, a gdy rozwiązaniem jest zmiana Twojego ustawienia, także link do tego ustawienia. Udane połączenie pokazuje **Answered**. Zachowaj **Leg ID**, jeśli kontaktujesz się z pomocą techniczną. Jeśli połączenia brakuje, zostało odrzucone lub nigdy nie dociera do Twojego sprzętu, skorzystaj z przewodnika [Rozwiązywanie problemów z połączeniami głosowymi](/docs/guides/voice/troubleshooting), który zaczyna od objawu. ## Dalsze kroki | Strona | Czego dotyczy | | -------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | [Trunki SIP](/docs/guides/voice/sip-trunks) | Wszystkie ustawienia trunku, uwierzytelnianie i Digest | | [Odbieranie połączeń](/docs/guides/voice/receiving-calls) | Trasy numerów, bramy, grupy i domyślna trasa obszaru roboczego | | [Nawiązywanie połączeń](/docs/guides/voice/placing-calls) | Czego Bird oczekuje w `INVITE` | | [Rozwiązywanie problemów z połączeniami głosowymi](/docs/guides/voice/troubleshooting) | Diagnozowanie połączenia na podstawie objawu | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/voice-api) (product) - [Voice overview](/docs/guides/voice/overview) (docs) [Get an implementation brief](/learn/workspace?topic=voice)