Wykonywanie połączeń
Twoja centrala PBX wysyła SIP INVITE do domeny SIP trunka, aby wykonać połączenie. Bird sprawdza żądanie, kieruje je do operatora i przekazuje dźwięk. Ta strona opisuje wymagania wstępne, pola żądania, uwierzytelnianie i koszty.
Zanim wykonasz połączenie
Cztery rzeczy muszą być gotowe, w dowolnej kolejności, a trzy z nich ustawiasz sam:
- Trunk przyjmujący Twój ruch. Utwórz trunk SIP i włącz połączenia wychodzące. Dodaj zakresy IP swojego sprzętu, dozwolony klucz API lub jedno i drugie. Klienci, którzy nie mogą przechowywać długotrwałego sekretu, mogą użyć poświadczenia sesji.
- Zweryfikowany identyfikator dzwoniącego. Zarejestruj prezentowany numer i przeprowadź połączenie weryfikacyjne, czyli sposób, w jaki obszar roboczy potwierdza, że jest właścicielem prezentowanych numerów. Weryfikacja nie gwarantuje dostarczenia CLI od końca do końca ani zestawienia połączenia, jeśli CLI nie jest numerem pozyskanym przez Bird: zobacz zastrzeżenie dotyczące weryfikacji i dostarczania CLI.
- Włączony kraj docelowy. Włącz kraje, które obsługujesz, na stronie Destinations.
- Routing przypisany do Twojego obszaru roboczego. Bird konfiguruje to za Ciebie, wybierając, którzy operatorzy obsługują poszczególne kierunki. Dopóki nie jest to gotowe, połączenia są odrzucane z kodem routing_not_configured. To jeden z powodów opisanych w sekcji Odrzucone połączenia.
Czego Bird oczekuje w INVITE
Wyślij żądanie do domeny SIP swojego trunka na jednym z obsługiwanych portów. Dwa nagłówki zawierają wszystko, czego potrzebuje Bird:
| Nagłówek | Co Bird z nim robi |
|---|---|
| To | Wywoływany numer. Bird odczytuje jego kraj, aby wybrać operatora i wycenić połączenie |
| From | Numer prezentowany jako dzwoniący. Musi to być zweryfikowany identyfikator dzwoniącego w tym obszarze roboczym |
Używaj pełnych numerów międzynarodowych w formacie E.164: wiodący +, po którym następuje kod kraju i numer krajowy, w obu nagłówkach. Jest to format, w którym Bird zapisuje numer w rekordzie połączenia i którego oczekuje dopasowanie kierunku docelowego.
Poza tymi dwoma nagłówkami jest to zwykłe połączenie SIP, bez niestandardowych nagłówków w żadnym kierunku.
Uwierzytelnianie każdego połączenia
Przez co przechodzi połączenie, zależy od sposobu otwarcia trunka:
- Tylko lista dozwolonych adresów IP. Jedno żądanie. Bird dopasowuje adres źródłowy do listy i kieruje połączenie, bez żadnego wyzwania do odpowiedzi.
- Tylko dozwolone klucze API. Bird najpierw żąda od połączenia hasła, poprzez wymianę SIP Digest.
- Oba. Adres źródłowy jest sprawdzany, zanim Bird w ogóle wyśle wyzwanie, więc połączenie z adresu spoza listy jest odrzucane niezależnie od poświadczeń.
- Włączone poświadczenia sesji. Bird wysyła wyzwanie do połączenia bez względu na jego źródło, nawet z adresu spoza listy dozwolonych, a odpowiada na nie poświadczenie wydane minuty wcześniej. Sprzęt już dopuszczony przez listę dozwolonych adresów IP na trunku bez dozwolonych kluczy nadal łączy się bez wyzwania.
Jeśli trunk ma dozwolone klucze API, Twój system telefoniczny odpowiada hashem sekretu klucza API, a nie samym sekretem. Na tym polega uwierzytelnianie SIP Digest:
- Twoja centrala PBX wysyła INVITE.
- Bird odpowiada 407 Proxy Authentication Required jedną linią wyzwania na każdy algorytm oferowany przez trunk, domyślnie SHA-256, a potem MD5.
- Twoja centrala PBX ponownie wysyła INVITE z nagłówkiem Proxy-Authorization obliczonym z nazwą użytkownika bird i sekretem klucza API jako hasłem.
- Bird weryfikuje odpowiedź i kontynuuje routing.
Wyprzedzający nagłówek Proxy-Authorization jest wysyłany przed wyzwaniem, więc Twój sprzęt musi wybrać algorytm oferowany przez trunk. Jeśli trunk ma również listę dozwolonych adresów IP, żądanie musi nadal pochodzić z adresu na liście.
Bird odpowiada na nieudaną wymianę na warstwie SIP, więc próba jest odrzucana, zanim platforma utworzy rekord połączenia. Jeśli Twoje połączenia w ogóle nie pojawiają się w dzienniku połączeń, sprawdź poświadczenia, a nie routing.
Atestacja połączeń
Połączenia do Stanów Zjednoczonych i Francji zawierają atestację STIR/SHAKEN. Operatorzy używają tego podpisu przy oznaczaniu połączeń. Bird domyślnie stosuje poziom B bez dodatkowej konfiguracji. Skontaktuj się ze wsparciem, aby poprosić o poziom A.
Kiedy połączenie jest odrzucane
Bird sprawdza identyfikator dzwoniącego, kierunek docelowy, limity i saldo portfela przed wybraniem numeru u operatora. Odrzucenie dociera do Twojego systemu telefonicznego jako SIP 503; szczegółowa przyczyna pozostaje w uwierzytelnionym rekordzie połączenia. Otwórz połączenie w dzienniku połączeń lub zobacz odrzucone połączenia, aby poznać każdy powód i rozwiązanie.
Rozwiąż zarejestrowaną przyczynę przed ponowną próbą. Na przykład calls_per_second_exceeded trwa, dopóki nie zmniejszysz tempa wybierania.
Połączenia alarmowe nie są obsługiwane
Bird Voice nie obsługuje połączeń ze służbami ratunkowymi. Połączenie pod 112, 911, 999 lub dowolny inny numer alarmowy jest odrzucane na każdym trunku, w każdym kraju. Twój system telefoniczny musi łączyć się ze służbami ratunkowymi inną drogą.
To zachowanie nie zależy od Twojego planu, salda ani kierunków docelowych. Skonfiguruj system telefoniczny tak, aby kierował połączenia alarmowe przez usługę, która je obsługuje, np. lokalną linię PSTN, bramę lokalną lub innego dostawcę. Przetestuj tę trasę. Bird zwraca 503 dla odrzuconego połączenia alarmowego, umożliwiając systemowi telefonicznemu z alternatywną trasą wybranie jej.
Służby ratunkowe polegają na zarejestrowanej lokalizacji dzwoniącego, której Bird nie przechowuje dla trunka. Nie polegaj na trasie Bird w przypadku połączeń alarmowych.
Koszty i rozliczenia
Usługa głosowa jest opłacana z góry z portfela organizacji, tak jak pozostałe kanały:
- Czas rozliczeniowy biegnie od odebrania do zakończenia, niezależnie od tego, jak długo połączenie dzwoniło. Rekord połączenia pokazuje go obok Total duration, który biegnie od momentu odebrania połączenia przez Bird.
- Stawka zależy od kraju docelowego. Twój cennik wycenia każdy kraj w walucie portfela. Stawka definiuje minimalny czas rozliczeniowy i inkrement stosowany po tym minimum. Na przykład stawka z jednominutowym minimum i sześciosekundowymi inkrementami rozlicza 10-sekundowe połączenie jako jedną minutę.
- Portfel jest sprawdzany przed wybraniem numeru u operatora. Połączenie, którego Twoje saldo nie pokrywa, jest odrzucane z kodem insufficient_balance z góry, a nie obciążane później. Utrzymuj bufor lub włącz automatyczne doładowania.
- Obowiązuje dzienny limit wydatków na głos. Po jego przekroczeniu połączenia są odrzucane z kodem daily_spend_exceeded do początku następnego dnia UTC. Kwota zależy od Twojego planu.
- Koszt pojawia się przy połączeniu po jego wycenie, z pełną precyzją, netto bez podatku.
Aby zsumować wydatki ze wszystkich połączeń, wyeksportuj przefiltrowaną listę połączeń jako CSV ze strony Calls lub sprawdź swoje faktury i zużycie.
Następne kroki
| Strona | Co opisuje |
|---|---|
| Dziennik połączeń | Przeglądanie, filtrowanie i eksportowanie rekordów połączeń |
| Zdarzenia głosowe | Przesyłanie wyników połączeń do własnych systemów |
| Metody płatności i portfel | Doładowania, automatyczne doładowania i sposób obciążania portfela |
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.