Przegląd Voice

Bird Voice umożliwia wykonywanie połączeń na numery telefonów i odbieranie połączeń na posiadanych numerach. Podłącz system telefoniczny przez SIP, zadzwoń z przeglądarki lub użyj kreatora sekwencji, aby uruchomić zapisany przepływ połączenia. Bird łączy połączenia z publiczną siecią telefoniczną, czyli PSTN.

Połączenie między Twoim systemem telefonicznym a Bird to trunk SIP. SIP (Session Initiation Protocol) zestawia połączenia między systemami telefonicznymi. Bird przydziela Twojemu obszarowi roboczemu adres trunku, którego Twój system telefoniczny używa do połączeń wychodzących do sieci telefonicznej, a Bird używa w drugą stronę do dostarczania połączeń przychodzących na Twoje numery.

Nie potrzebujesz systemu telefonicznego, żeby wykonać pierwsze połączenie: telefon w dashboardzie wykonuje je bezpośrednio z przeglądarki, przez jeden z Twoich trunków.

Możesz też zbudować sekwencję w dashboardzie i uruchomić ją przez API Create Call. Sekwencja obsługuje komunikaty, wybory na klawiaturze i kierowanie połączenia po odebraniu go przez odbiorcę.

Jak wykonywane jest połączenie

Twój system telefoniczny wysyła SIP INVITE na adres trunku, aby rozpocząć połączenie. Bird sprawdza identyfikator dzwoniącego, kraj docelowy, limity i stan portfela, zanim skontaktuje się z operatorem. Jeśli połączenie przejdzie pomyślnie, Bird kieruje je i przekazuje dźwięk. Każde zestawienie to etap (leg). Gdy etap się zakończy, Bird zapisuje jego rekord w Voice > Legs i emituje voice_call.ended zdarzenie.

Połączenie, które nie przejdzie weryfikacji, jest odrzucane, zanim operator zostanie zaangażowany, a konkretny powód trafia do rekordu etapu. Wykonywanie połączeń opisuje, co Bird odczytuje z każdego połączenia, a Odrzucone połączenia wymienia każdy powód odrzucenia i co z nim zrobić.

Jak odbierane jest połączenie przychodzące

Numer należący do Twojego obszaru roboczego ma w danym momencie jedną odpowiedź, ustawioną na samym numerze lub, gdy numer jej nie ma, pobraną z domyślnej trasy obszaru roboczego: dostarczenie połączenia do jednego z Twoich trunków SIP, przekierowanie na zweryfikowany przez Ciebie numer, uruchomienie opublikowanej sekwencji, dzwonienie do grupy dzwonienia osób dostępnych online w telefonie przeglądarkowym lub odrzucenie. Domyślna trasa jest początkowo ustawiona na odrzucenie, więc numer, którego nikt nie skonfigurował, odrzuca dzwoniących.

Gdy połączenie przychodzi, Bird sprawdza limity konta i portfel tak samo jak przy połączeniu wychodzącym, a następnie stosuje odpowiedź ustawioną na numerze i zapisuje ją w rekordzie połączenia. Odbieranie połączeń opisuje wskazywanie numeru na odpowiedź, co przekierowanie prezentuje osobie odbierającej i jak odczytać odmowę.

Przed pierwszym połączeniem

Dla połączeń przez własny sprzęt SIP przygotuj poniższe elementy. Połączenia przez API wymagają spełnienia warunków wstępnych Create Call.

• Utwórz trunk SIP, włącz połączenia wychodzące i zezwól na ich wykonywanie: użyj zakresu adresów IP lub klucza API dla własnego sprzętu, a danych uwierzytelniających sesji dla przeglądarki lub CLI.
• Wybierz dozwolony identyfikator dzwoniącego: użyj numeru, który Twój obszar roboczy ma w Bird, lub zarejestruj numer zewnętrzny i potwierdź go połączeniem weryfikacyjnym.
• Włącz kierunki docelowe: włącz kraje, do których dzwonisz.

Wykonaj pierwsze połączenie przeprowadzi Cię przez wszystkie trzy wymagania i zakończy się prawdziwym połączeniem.

Odczytywanie rekordów połączeń wymaga voice:read; wykonywanie połączeń wymaga voice:write. Zarządzanie trunkami, trasami numerów, identyfikatorami dzwoniących i sekwencjami korzysta z uprawnień voice_management. Dostęp do strony nie daje uprawnień do zmiany jej ustawień ani do wykonania płatnego połączenia.

Aplikacja Voice w dashboardzie

Widoczność

Połączenie może składać się z wielu etapów. Dziennik zawiera jeden rekord na etap, niezależnie od tego, czy połączenie zostało zestawione, wygasło bez odpowiedzi, czy zostało odrzucone. Przekierowane lub wielostronne połączenia mogą więc mieć kilka wpisów:

• Dziennik odcinków: widok poszczególnych odcinków na stronie Legs. Zawiera status, oba numery, trunk, przez który przyszedł odcinek, odpowiedź SIP, którą się zakończył, czas odebrania i zakończenia, czas podlegający rozliczeniu oraz koszt. Przefiltruj dziennik, a następnie wyeksportuj pasujące rekordy do CSV. CSV zawiera czasy trwania i czas podlegający rozliczeniu, ale nie ma kolumny kosztów; sprawdź opłaty w sekcji Zużycie, wydatki i faktury.
• Zdarzenia Voice: voice_call.initiated, voice_call.answered i voice_call.ended dostarczane na Twój endpoint, dzięki czemu Twoje systemy dowiadują się o połączeniu bez odpytywania.

Dokumentacja API wymienia obsługiwane publiczne kontrakty HTTP i metody SDK. Dokumentacja CLI i dokumentacja narzędzia MCP opisują ich opublikowane operacje. Te interfejsy mogą udostępniać różne operacje; akcja w dashboardzie lub polecenie CLI samo w sobie nie ustanawia publicznej metody SDK.

Limity

Połączenia w obu kierunkach podlegają trzem limitom: liczby jednoczesnych połączeń, liczby nowych połączeń na sekundę i wydatków na połączenia głosowe w ciągu doby według UTC. Twój plan Voice określa limity jednoczesnych połączeń i połączeń na sekundę dla Twojej organizacji: w modelu płatności za użycie obowiązują wartości domyślne, a wyższe plany Voice je zwiększają. Dzienny limit wydatków działa inaczej. Każdy obszar roboczy ustawia własny limit w Voice > Spend limit, a dla poszczególnych krajów w Voice > Destinations, do maksymalnej wartości dla Twojej organizacji; najwyższe plany Voice zwiększają tę wartość. Połączenie przekraczające którykolwiek z limitów jest odrzucane podczas zestawiania, a jego rekord wskazuje przekroczony limit opisany w sekcji Odrzucone połączenia. Wartości dla każdego planu znajdziesz na stronie cennika Voice; przejdź na wyższy plan w Billing and payments > Overview.

Limit czasu trwania połączenia na platformie wynosi 4 godziny. Bird rozłącza obie strony połączenia, które osiągnie ten czas, więc zaplanuj dłuższą sesję jako więcej niż jedno połączenie. Czas połączenia, które uruchamia sekwencję połączenia, liczy się od momentu, gdy Bird je zaakceptuje lub odbierze, więc oczekiwanie na wybranie numeru i dzwonienie wykorzystują część z 4 godzin. Sekcja Statusy wyjaśnia, jak takie połączenie jest widoczne w dzienniku.

Limit na sekundę to polityka voice_call opisana w sekcji Limity żądań, która wyjaśnia też, jak ustalany jest Twój efektywny limit i jak go podnieść.

Następne kroki