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 panelu 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 trunka, 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 połączenie to etap. 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
Każdy numer w Twoim obszarze roboczym ma w danej chwili jedną skonfigurowaną akcję dla połączeń przychodzących: dostarczenie połączenia do jednego z trunków SIP, przekierowanie go na zweryfikowany numer, uruchomienie opublikowanej sekwencji lub odrzucenie. Każdy nowy numer domyślnie odrzuca połączenia, więc nieskonfigurowany numer nie przyjmuje 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 dzwoniących: zakres IP lub klucz API dla własnego sprzętu, poświadczenia sesji dla przeglądarki lub CLI.
- Wybierz odpowiedni identyfikator dzwoniącego: użyj numeru, który Twój obszar roboczy posiada przez 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
| Strona | Do czego służy |
|---|---|
| Metrics | Liczba połączeń i wskaźnik odebranych w czasie, wyniki połączeń, czołowe kraje oraz podział na przychodzące i wychodzące. Zobacz Metryki Voice |
| Legs | Rekordy poszczególnych etapów dla połączeń w obszarze roboczym, z podsumowaniem użycia za miesiąc |
| Calls | Powiązane etapy i uczestnicy zgrupowani w jedno połączenie |
| Numbers | Wszystkie numery dostępne w obszarze roboczym do połączeń głosowych i co każdy z nich robi z połączeniem przychodzącym |
| SIP Trunks | Twoje trunki, ich domena SIP, kto może wysyłać na nie ruch i dokąd dostarczane są połączenia przychodzące |
| Destinations | Kraje, do których Twój obszar roboczy może dzwonić, domyślnie wyłączone |
| Sequences | Tworzenie, podgląd i publikowanie przepływów połączeń oraz przeglądanie ich wykonań |
| Phone | Pływający telefon, który wykonuje połączenia z przeglądarki przez jeden z Twoich trunków |
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 etapów: widok poszczególnych etapów na stronie Legs. Status, oba numery, trunk, przez który etap przyszedł, odpowiedź SIP, na której się zakończył, czasy odebrania i zakończenia, czas do rozliczenia i koszt. Filtruj wyniki, a następnie eksportuj je jako CSV.
- 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
Trzy limity obowiązują Twoje połączenia w obu kierunkach: ile połączeń może trwać jednocześnie, ile nowych połączeń na sekundę i ile możesz wydać na głos w ciągu doby UTC. Każdy jest ustawiany na poziomie organizacji, a wartości zależą od Twojego planu. Połączenie przekraczające którykolwiek z nich jest odrzucane przy zestawianiu, a jego rekord wskazuje, który limit został przekroczony, w sekcji Odrzucone połączenia.
Limit na sekundę to polityka voice_call w sekcji Limity żądań, która wyjaśnia też, jak ustalany jest Twój efektywny limit i jak poprosić o większą przepustowość.
Następne kroki
| Strona | Co opisuje |
|---|---|
| Wykonaj pierwsze połączenie | Od pustego obszaru roboczego do dzwoniącego telefonu |
| Phone | Dzwonienie z dashboardu, czego wymaga i co możesz robić w trakcie połączenia |
| Trunki SIP | Tworzenie trunku, szczegóły połączenia i kontrola, kto może wysyłać ruch |
| Wykonywanie połączeń | Czego Bird oczekuje na INVITE i ile kosztuje połączenie |
| Odbieranie połączeń | Wskazywanie numeru na trunk lub przekierowanie i co zostaje zapisane |
| Identyfikatory dzwoniących | Rejestrowanie numeru i potwierdzanie go połączeniem weryfikacyjnym |
| Kierunki docelowe Voice | Włączanie krajów, do których dzwonisz, i co oznacza wysokie ryzyko |
| Dziennik etapów | Przeglądanie, filtrowanie i eksportowanie rekordów etapów |
| Zdarzenia Voice | Trzy zdarzenia połączeń i ich payloady |
| Rozwiązywanie problemów | Diagnozowanie połączenia, które nie przechodzi, na podstawie jego objawu |
| Webhooki i zdarzenia | Konfiguracja endpointu, weryfikacja podpisu, ponawianie i powtórne odtwarzanie |
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.