Pytania o Voice — z odpowiedziami.

Bird Voice łączy systemy telefoniczne i aplikacje z siecią telekomunikacyjną. Korzystaj z łączy SIP, połączeń w przeglądarce i sekwencji połączeń lub podłącz środowisko uruchomieniowe głosu AI. Śledź połączenia poprzez ich rekordy, sesje i zdarzenia.

Utwórz obszar roboczy, przygotuj łącze gotowe do połączeń i tożsamość dzwoniącego, a następnie włącz destynację, którą chcesz przetestować. Czas konfiguracji zależy od dostępu, weryfikacji i podłączanego klienta. Przewodnik po pierwszym połączeniu prowadzi przez kontrolowane połączenie w przeglądarce.

Trzy rzeczy po Twojej stronie: trunk SIP z autoryzacją Twojego sprzętu (według zakresu IP lub klucza API), zweryfikowany identyfikator dzwoniącego (numer, który prezentujesz jako dzwoniący) oraz włączony kraj docelowy. Bird przypisuje routing do Twojego workspace — to czwarty warunek, realizowany po stronie Bird.

Nie. Użyj telefonu w przeglądarce lub kompatybilnego softphone'a, PBX lub aplikacji SIP. Dopasuj obsługiwany transport, uwierzytelnianie i ustawienia mediów do konfiguracji łącza.

Tak. Możesz wykonywać połączenia z aplikacji Phone w panelu, korzystając z WebRTC.

Za połączenie, według stawki zależnej od kraju docelowego. Każda stawka ma przyrost rozliczeniowy: minimalny czas naliczany, a następnie krok, do którego jest zaokrąglany. Stawka z jednominutowym minimum i sześciosekundowymi krokami naliczy za 10-sekundowe połączenie pełną minutę.

Czas rozliczeniowy biegnie od momentu odebrania połączenia przez wywoływany numer do momentu zakończenia połączenia. Sprawdź opublikowane składniki stawek dla swojego przypadku użycia; wynajem numeru i inne skonfigurowane usługi są rozliczane oddzielnie od czasu odebranego połączenia.

Przedpłacone, z portfela Twojej organizacji. Bird sprawdza saldo przed wybraniem numeru przez operatora, więc połączenie, na które nie wystarcza środków, jest odrzucane z góry z powodu insufficient_balance, zamiast być rozliczane po fakcie.

Tak. Dla każdej organizacji obowiązuje dzienny limit wydatków na połączenia głosowe, który resetuje się na początku każdego dnia UTC. Po jego przekroczeniu połączenia są odrzucane z kodem daily_spend_exceeded. Kwota zależy od Twojego planu, a Bird może ją podnieść na życzenie.

Otwórz połączenie w rejestrze połączeń. Koszt pojawia się w rekordzie po jego wycenie, z pełną precyzją, bez podatku. Aby zobaczyć sumy dla wielu połączeń, wyeksportuj przefiltrowaną listę połączeń jako CSV ze strony Calls lub sprawdź faktury i zużycie.

Trzy limity: ile połączeń możesz mieć jednocześnie (połączenia współbieżne), ile nowych połączeń możesz rozpocząć na sekundę (połączenia na sekundę) i ile możesz wydać na głos w ciągu dnia UTC (dzienny limit wydatków). Obowiązujące limity zależą od konfiguracji Twojego konta.

Połączenie jest odrzucane na etapie zestawiania, zanim operator zostanie wybrany. Rekord połączenia wskazuje, który limit został osiągnięty: concurrent_calls_exceeded, calls_per_second_exceeded lub daily_spend_exceeded. Twój system telefoniczny otrzymuje SIP 503.

Skontaktuj się ze wsparciem, podając oczekiwany ruch, destynacje i wydatki, aby poprosić o przegląd limitów. Potwierdź zatwierdzone limity przed zwiększeniem ruchu produkcyjnego.

Sprawdź, jaki powód wskazuje rekord połączenia. Dialer może osiągnąć calls_per_second_exceeded, będąc daleko od limitu połączeń równoległych, ponieważ te dwa limity są niezależne. Zmniejsz szybkość wybierania i ponów próbę; natychmiastowe ponowienie daje tę samą odpowiedź.

Nie. Trunk SIP łączy kompatybilny system telefoniczny z Bird. Dopasuj transport, uwierzytelnianie i ustawienia mediów trunka do używanego klienta.

Tak. Skonfiguruj każdy kierunek osobno. Połączenia przychodzące wymagają dodatkowo numeru obsługującego połączenia przychodzące, przypisanego do trunka, oraz bramki dostarczania.

Tak, jeśli jej środowisko uruchomieniowe obsługuje zarówno sygnalizację SIP, jak i połączenie audio. Aplikacja konwersacyjna steruje mową, modelem i akcjami biznesowymi; Bird zapewnia połączenie telefoniczne.

Numery wskazujące na ten trunk zaczynają odrzucać połączenia. Ponowne włączenie trunka nie przywraca ich poprzednich przypisań — sprawdź numery przed wznowieniem ruchu.

Bird Voice nie obsługuje połączeń alarmowych. Użyj usługi telefonicznej przeznaczonej do tego celu.

Trunk SIP to połączenie między Twoim systemem telefonicznym a Bird. SIP (Session Initiation Protocol) to protokół, którym systemy telefoniczne komunikują się w celu zestawiania połączeń, a trunk to linia, po której te połączenia przechodzą. Bird przydziela Twojemu workspace'owi adres trunku, a Ty kierujesz na niego swój system telefoniczny.

Większość workspace'ów potrzebuje tylko jednego. Utwórz więcej, gdy chcesz mieć osobne reguły dostępu per lokalizacja lub per system, ponieważ lista dozwolonych adresów IP, dozwolone klucze API i ustawienia Digest są konfigurowane osobno dla każdego trunku.

Domena SIP trunka (skopiowana ze strony trunka), nazwa użytkownika bird oraz hasło (sekret klucza API uprawnionego do korzystania z trunka). Wysyłaj połączenia na domenę SIP na porcie 5060 (UDP lub TCP) lub 5061 (TLS).

Tak, za pomocą listy dozwolonych adresów IP, dozwolonych kluczy API lub obu jednocześnie. Dodaj publiczne adresy, z których Twoje urządzenia wysyłają SIP, lub wymagaj uwierzytelniania każdego połączenia kluczem API przez SIP Digest. Oba ustawienia zaczynają obowiązywać od następnego połączenia.

Domena SIP trunku natychmiast przestaje przyjmować nowe połączenia. Połączenia już trwające są kontynuowane, a rekordy połączeń wykonanych przez ten trunk pozostają w rejestrze połączeń.

Twoja centrala PBX wysyła połączenie, Bird odpowiada wyzwaniem 407, a centrala ponownie wysyła połączenie z nagłówkiem Proxy-Authorization obliczonym na podstawie nazwy użytkownika bird i sekretu Twojego klucza API jako hasła. Centrala wysyła hash hasła, nigdy samo hasło.

SHA-256 i MD5. Bird oferuje domyślnie SHA-256 jako pierwszy i MD5 jako drugi, a Twoja centrala PBX wybiera pierwszy, który obsługuje. Jeśli Twój sprzęt obsługuje tylko MD5 i nieprawidłowo przetwarza wyzwanie zaczynające się od SHA-256, ustaw trunk wyłącznie na MD5.

Tak. Gdy trunk ma oba mechanizmy, adres źródłowy jest sprawdzany przed wyzwaniem Bird o hasło, więc połączenie z nieujętego na liście adresu jest odrzucane niezależnie od przesłanych poświadczeń.

Najpierw dodaj nowy klucz do trunka, przenieś swój sprzęt, a następnie unieważnij stary klucz. Unieważnienie lub usunięcie klucza natychmiast odbiera mu możliwość uwierzytelniania na każdym trunku, który go dopuszczał.

Identyfikator dzwoniącego to numer telefonu, który Twój obszar roboczy może prezentować jako numer dzwoniącego w połączeniach wychodzących. Bird sprawdza numer dzwoniącego ustawiony przez Twoje urządzenie w nagłówku From SIP przy każdym połączeniu względem tej listy dozwolonych tożsamości Twojego obszaru roboczego, w tym kwalifikujących się numerów w Bird i zweryfikowanych numerów zewnętrznych.

Dodaj numer w międzynarodowym formacie E.164 i przejdź przez proces weryfikacji. Odbierz połączenie weryfikacyjne i wpisz kod w panelu. Sprawdź status numeru, aby upewnić się, że jest gotowy do wykonywania połączeń.

Jeśli próby się wyczerpały, użyj opcji Get a new code w wierszu danego numeru, aby otrzymać nowe połączenie weryfikacyjne. Jeśli numer wciąż oczekuje na kod, usuń identyfikator dzwoniącego i dodaj numer ponownie.

Przygotuj się na odebranie połączenia weryfikacyjnego w systemie, który odbiera połączenia na ten numer. Jeśli numer nie może odebrać połączenia weryfikacyjnego, skontaktuj się ze wsparciem w sprawie dostępnych metod potwierdzenia własności.

Od tego momentu każde połączenie prezentujące ten numer jest odrzucane z błędem caller_id_not_verified. Połączenia już w toku są kontynuowane, a zapisy połączeń, które używały tego numeru, pozostają bez zmian.

Oszustwa telekomunikacyjne polegają na wybieraniu drogich krajów, do których nigdy nie zamierzałeś dzwonić. Włączone kraje to te, w których możesz generować koszty — wyłączenie pozostałych ogranicza Twoje ryzyko w przypadku włamania do systemu telefonicznego.

Znajdź kraj na stronie Destinations za pomocą pola wyszukiwania (wyszukuje po nazwie lub dwuliterowym kodzie) i przełącz jego przełącznik. Zmiana obowiązuje od tego momentu.

Połączenia do krajów wysokiego ryzyka są drogie, a operator numeru, na który dzwonisz, otrzymuje część kosztów. To kraje, które atakujący obiera za cel po włamaniu do systemu telefonicznego. Pozostaw je wyłączone, chyba że prowadzisz tam działalność, i sprawdź stawkę przed włączeniem.

Skontaktuj się ze wsparciem technicznym, aby odblokować go dla Twojego konta. Available oznacza, że możesz go włączyć; Not supported oznacza, że Bird nie może obecnie realizować połączeń do tego kraju z Twojego konta.

Dostępny kraj może nadal mieć określone miejsca docelowe, do których routing jeszcze nie dociera. Udostępnij ID połączenia wsparciu, aby zbadać pokrycie destynacji i przyczynę odrzucenia.

Dwa nagłówki: To (wybierany numer) i From (numer prezentowany jako dzwoniący, który musi być uprawnioną tożsamością dzwoniącego). Oba muszą być pełnymi numerami międzynarodowymi w formacie E.164 — początkowy znak +, po którym następują kod kraju i numer krajowy. Niestandardowe nagłówki nie są potrzebne.

STIR/SHAKEN umożliwia dostawcom podpisywanie informacji o tożsamości dzwoniącego. Atest odzwierciedla, co dostawca może zweryfikować na temat dzwoniącego i numeru. Nie gwarantuje, że operator docelowy połączy rozmowę ani usunie etykietę spamu.

Otwórz połączenie w dzienniku połączeń. Twój system telefoniczny widzi zwykły SIP 503, ale konkretny powód trafia do rekordu połączenia, gdzie tylko Ty możesz go odczytać. Panel nad szczegółami wskazuje przyczynę i prowadzi do ustawienia, które ją naprawia.

Dopiero gdy przyczyna zostanie usunięta. Połączenie odrzucone z powodu calls_per_second_exceeded otrzyma tę samą odpowiedź, dopóki nie zmniejszysz szybkości wybierania. Przeczytaj powód odrzucenia przed ponowieniem próby.

Nie. Oznacza to, że połączenie zostało nawiązane. Połącz potwierdzone zdarzenie biznesowe, takie jak rezerwacja lub rozwiązana sprawa, aby ocenić powodzenie zadania.

Aktywne połączenie nie zakończyło naliczania. Odczytaj końcowy rekord po zakończeniu połączenia i cyklu naliczania; brak wartości nie oznacza zerowej ceny.

Zweryfikuj podpis, deduplikuj na podstawie identyfikatora webhooka i toleruj dostarczanie w zmienionej kolejności. Uzgodnij końcowy wynik z rekordem połączenia.

Sprawdź kierunek i filtry raportu jawnie. Struktura ruchu i naliczane składniki mogą się różnić.

Połącz naliczone połączenia i ich sesje z potwierdzonymi wynikami w swojej aplikacji. Uwzględnij każdy odpowiedni odcinek połączenia i użyj spójnego okresu oraz definicji ukończenia.

Pięć: Answered (numer docelowy odebrał), No answer (dzwoniło bez odpowiedzi), Failed (połączenie nie zostało zrealizowane — Bird je odrzucił lub operator je nie obsłużył), Rejected (operator odrzucił połączenie wprost) i Unknown (nie udało się ustalić wyniku).

Oba pojawiają się jako Failed. Rozróżnia je powód odrzucenia: tylko odmowa Bird go zawiera. Nieudane połączenie z powodem odrzucenia wskazuje na ustawienie po Twojej stronie lub po stronie Bird; połączenie bez powodu odrzucenia zwykle wskazuje na wybierany numer.

Tak. Zakładka Live na stronie Calls wyświetla aktualnie trwające połączenia na Twoich trunkach wraz z liczbą. Połączenie na żywo jest wyświetlane jako Ringing (oczekiwanie na odebranie przez drugą stronę) lub In progress (połączone). Zakładka odświeża się co kilka sekund.

Całkowity czas trwania biegnie od momentu, gdy Bird otrzymał żądanie połączenia, do rozłączenia. Czas rozliczeniowy biegnie od odebrania do rozłączenia. Różnica to czas dzwonienia, którego nikt nie odebrał — duża różnica oznacza, że warto sprawdzić, co wybierasz. Nieodebrane połączenia nie mają czasu odebranego połączenia. Sprawdź odpowiednią kartę stawek, aby poznać pozostałe składniki i opłaty za połączenie.

Na trzy sposoby: pobierz CSV ze strony Calls (eksportuje wszystkie rekordy pasujące do bieżących filtrów, nie tylko widoczną stronę), odczytaj je przez API za pomocą klucza API z uprawnieniem voice:read lub użyj Bird CLI poleceniem bird voice list.

Trzy: voice_call.initiated (Bird zaakceptował połączenie i rozpoczął routing), voice_call.answered (numer docelowy odebrał) i voice_call.ended (połączenie zakończone, wraz z wynikiem). Połączenie bez odpowiedzi nigdy nie emituje zdarzenia answered.

Użyj zdarzenia zakończenia, aby odczytać zgłoszony status i czasy trwania, a następnie uzgodnij końcowy wynik z rekordem połączenia. Publikacja zdarzenia może się nie powieść, a żądanie odrzucone przed przyjęciem może nie mieć rekordu połączenia ani zdarzeń. Brak aktualizacji nie oznacza, że połączenie jest nadal aktywne.

Tak. Dostarczanie nie jest uporządkowane, więc zdarzenie answered może dotrzeć do Ciebie po ended. Sortuj według pola timestamp i pozwól, aby później dostarczone zdarzenie z wcześniejszym znacznikiem czasu zostało odrzucone.

Deduplikuj na podstawie nagłówka HTTP webhook-id. Ponowienie dostarczenia lub sygnalizacji może powtórzyć zdarzenie. To samo połączenie i etap cyklu życia zachowują swoją tożsamość webhooka. Uzgodnij brakującą aktualizację z rekordem połączenia.

Znajdują się w rekordzie połączenia, nie w zdarzeniu. Status failed w voice_call.ended nie informuje, czy spowodował go Bird, czy operator. Otwórz połączenie w dzienniku połączeń, aby zobaczyć powód odrzucenia — koszt pojawia się tam po wycenieniu połączenia.

Połączenie, którego Bird nie może przyjąć, jest odrzucane na warstwie SIP, zanim powstanie rekord. Sprawdź cztery rzeczy: trunk ma zakres IP lub klucz API zezwalający Twojemu urządzeniu, połączenie przyszło z adresu na liście dozwolonych IP trunku (za NAT jest to publiczny adres routera), dane uwierzytelniające Digest są poprawne (nazwa użytkownika bird, właściwy sekret klucza API, algorytm oferowany przez trunk) oraz domena SIP dokładnie odpowiada domenie trunku.

Otwórz połączenie w rejestrze połączeń. Panel nad szczegółami wskazuje przyczynę i zawiera link do ustawienia, które ją rozwiązuje. Siedem przyczyn, które możesz naprawić, to: source_not_allowed, caller_id_not_verified, destination_not_enabled, insufficient_balance, daily_spend_exceeded, concurrent_calls_exceeded i calls_per_second_exceeded.

Niektóre urządzenia nieprawidłowo obsługują wyzwanie rozpoczynające się od SHA-256. Ustaw algorytm Digest trunku na wyłącznie MD5, a Twoja centrala PBX otrzyma wyzwanie, które rozumie.

Sprawdź adresy mediów, reguły firewalla i obsługiwane kodeki. Częstą przyczyną jest NAT wysyłający media na nieosiągalny adres prywatny. Skonfiguruj obsługę NAT lub STUN w kliencie i zweryfikuj audio w obu kierunkach.

Może być. Bird obsługuje TLS na porcie 5061 dla sygnalizacji SIP, więc zestawienie połączenia jest szyfrowane podczas transmisji. UDP i TCP na porcie 5060 nie są szyfrowane. Wybierz transport odpowiadający Twoim wymaganiom bezpieczeństwa.

Każde zdarzenie jest podpisywane HMAC. Zweryfikuj podpis za pomocą sekretu swojego endpointu przed przetworzeniem danych i rotuj ten sekret z poziomu dashboardu, kiedy zajdzie taka potrzeba.

Rekordy głosowe podlegają skonfigurowanemu regionowi usługi. Sprawdź obowiązujące warunki przetwarzania danych i ich przechowywania dla swojego wdrożenia; samo routowanie punktów końcowych API nie opisuje każdej lokalizacji przetwarzania ani przechowywania.

Użyj dostępu głosowego z poziomem zapisu dla dozwolonego klucza do uwierzytelniania połączeń i dostępu głosowego do odczytu, aby czytać rekordy połączeń. Oddzielny zakres voice_management obejmuje konfigurację. Łącze stosuje również swoje skonfigurowane reguły dotyczące kluczy i źródeł.

Konkretna przyczyna trafia do rekordu połączenia, gdzie tylko Ty możesz ją odczytać. Zwracanie ogólnego 503 na warstwie SIP uniemożliwia osobie sondującej Twój trunk poznanie, jakie trunki, numery i kierunki istnieją.

Certyfikaty i dokumentacja bezpieczeństwa znajdują się w Trust Center pod adresem trust.bird.com. Umowa o przetwarzanie danych, polityka prywatności i zasady dopuszczalnego użytkowania są opublikowane na bird.com/legal. W przypadku ankiety dla dostawców zajmuje się tym Twój zespół opiekuna konta w Bird.

Sekwencja połączenia steruje komunikatami, wyborem klawiszy i nagrywaniem wewnątrz rozmowy telefonicznej. Przepływ automatyzacji koordynuje szerszy proces biznesowy. Trzymaj oba przepływy i ich decyzje o publikacji oddzielnie.

Tak. Połącz komunikat głosowy lub nagrany z wprowadzaniem z klawiatury i gałęziami dla rozpoznanych cyfr, przekroczenia czasu i niedopasowanego wejścia.

Nie. Zbieranie z klawiatury odczytuje cyfry DTMF. Agent głosowy z językiem naturalnym wymaga środowiska konwersacyjnego z własnym przetwarzaniem mowy i zarządzaniem kolejnością wypowiedzi.

Połączenia korzystające z opublikowanej wersji zachowują jej niezmienną treść. Nowe połączenia używają nowo opublikowanej wersji. Testowe połączenia robocze odczytują ostatnio zapisaną sekwencję przy każdym przejściu i mogą uwzględniać edycje wersji roboczej.

Nie. Oznacza przyjęte zlecenie. Śledź dzwonienie, odebranie i końcowy wynik połączenia oddzielnie i wiąż niepewne ponowienia z tą samą operacją.

Nie. Menu telefoniczne opiera się na predefiniowanych wyborach, takich jak cyfry na klawiaturze. Głosowa rozmowa z AI interpretuje język i generuje odpowiedzi w ramach konwersacyjnego środowiska uruchomieniowego. Oba podejścia nadal wymagają pełnego projektu routingu połączeń i obsługi wyników.

Środowisko uruchomieniowe obsługujące SIP może połączyć się przez Bird, jeśli jego sygnalizacja, uwierzytelnianie i obsługa mediów są kompatybilne. Zwaliduj integrację prawdziwym połączeniem w obu kierunkach, zanim przekierujesz ruch.

Nie. MCP pozwala autoryzowanemu agentowi programowemu obsługiwać narzędzia konta. Głosowy agent na żywo potrzebuje dodatkowo audio, przetwarzania mowy, zarządzania kolejnością wypowiedzi i aplikacji konwersacyjnej.

Podłącz te akcje przez autoryzowane narzędzia swojej aplikacji. Traktuj zwracany przez nie status jako źródło prawdy i wymagaj odpowiedniego potwierdzenia od klienta przed dokonaniem zmiany.

Mierz nawiązanie i zakończenie połączenia oddzielnie od powodzenia zadania. Śledź potwierdzony wynik biznesowy, współczynnik eskalacji i zaobserwowane przyczyny niepowodzeń — sam transkrypt ani odebrane połączenie nie dowodzą konwersji.

Nie. Skonfiguruj trasę przychodzącą numeru. Trasa odrzucająca to jawny wynik, a nie automatyczne połączenie z zespołem lub agentem.

Tak, przez aplikację połączeniową lub środowisko uruchomieniowe SIP, które skonfigurujesz do jego obsługi. Numer, trunk przychodzący, brama i środowisko uruchomieniowe konwersacji — każdy z tych elementów musi być gotowy.

Sprawdź oba skorelowane odcinki połączenia. Sprawdź zweryfikowany numer docelowy przekierowania, włączone miejsce docelowe, dostępny routing i obowiązujące limity konta.

Nie. Trasa rejestruje wybrane zachowanie obsługi. Status połączenia i powiązane zdarzenia informują, czy to zachowanie się powiodło.

Przekierowanie tworzy odcinek wychodzący oprócz odcinka przychodzącego. Sprawdź opublikowane stawki i końcowe rozliczone składniki połączenia.

Nie. Telefon w panelu korzysta z przeglądarki i skonfigurowanego łącza Bird SIP.

Telefon w panelu wykonuje połączenia wychodzące. Kieruj połączenia przychodzące do systemu telefonicznego lub aplikacji przeznaczonej do ich odbierania.

Tak. Używaj klawiatury do wybierania tonów DTMF, np. w menu IVR lub przy wyborze numeru wewnętrznego.

Są realizowane i rozliczane jako połączenia Voice. Sprawdź opublikowane stawki dla danego kierunku i szczegóły końcowego rekordu połączenia.

Nie. Bird Voice nie obsługuje połączeń alarmowych.

Nie. Nagrywanie jest jawnym elementem skonfigurowanego przepływu. Zdecyduj, które obsługiwane źródło przechwycić oraz kiedy przechwytywanie się rozpoczyna i kończy.

Przechwytywanie audio i transkrypcja to oddzielne operacje. Żądaj transkrypcji tam, gdzie jest potrzebna, i sprawdzaj wynik jej przetwarzania.

Tak. Przetwarzanie mowy może zakończyć się po rozmowie telefonicznej. Traktuj wynik połączenia i stan przetwarzania artefaktów jako odrębne rzeczy.

Nie. Sesja może obejmować kilka odcinków połączenia, a każdy może mieć własne artefakty. Sprawdź źródłowe połączenie i identyfikator przechwycenia.

Traktuj ją jako dowód z rozmowy. Potwierdź rezerwację, zmianę zamówienia lub płatność w systemie biznesowym, który wykonał daną akcję.