Voice

Czym jest głosowe API?

Głosowe API pozwala aplikacji konfigurować połączenia telefoniczne, sterować nimi lub je sprawdzać przez udokumentowany interfejs programistyczny.

Callback, menu głosowe i asystent głosowy wykorzystują różne części platformy telefonicznej.

Czym może sterować głosowe API?

Głosowe API może udostępniać konfigurację, sterowanie połączeniami i raportowanie, a zakres obsługiwanych operacji zależy od dostawcy.

Konfiguracja obejmuje trunki, tożsamości dzwoniącego, miejsca docelowe i routing numerów. Sterowanie połączeniami obejmuje zachowanie w trakcie rozmowy, np. komunikaty głosowe lub dane z klawiatury. Raportowanie zwraca status połączenia, czas trwania i inne zarejestrowane wyniki.

Dostawcy wyrażają sterowanie połączeniami w różny sposób. TwiML od Twilio na przykład opisuje akcje za pomocą instrukcji zwracanych do Twilio. Przeniesienie aplikacji oznacza więc zmapowanie jej zachowania i oczekiwań dotyczących callbacków, a nie tylko podmianę nazwy hosta.

Metoda odczytująca połączenie nie jest operacją, która je inicjuje.

Jak współpracują API i SIP?

API aplikacji może konfigurować lub sterować usługą, podczas gdy SIP nawiązuje pod spodem sesję telefoniczną.

SIP, protokół sygnalizacji połączeń, tworzy, modyfikuje i kończy sesje. Negocjuje sposób połączenia uczestników. RTP przenosi media w czasie rzeczywistym, takie jak audio.

Ścieżki mogą ulegać awariom niezależnie od siebie. Połączenie może dzwonić, podczas gdy ustawienie mediów lub ścieżka sieciowa uniemożliwia jednemu uczestnikowi słyszenie drugiego. Testuj audio w obu kierunkach, a także dzwonienie i rozłączanie.

PBX, czyli firmowa centrala telefoniczna kierująca połączenia, może zachować swoją obsługę połączeń, korzystając jednocześnie z trunków SIP dostawcy. Środowisko konwersacyjne może korzystać z podobnego połączenia, dostarczając jednocześnie własne narzędzia mowy i logiki biznesowej.

Co mogę odczytać o połączeniu?

Rekord połączenia identyfikuje próbę i raportuje jej zaobserwowany stan. Dostępne pola zależą od operacji i etapu połączenia.

  • Połączenie: czy połączenie zostało przyjęte, zadzwoniło i otrzymało odpowiedź.
  • Media: czy uczestnicy mogli się słyszeć i wchodzić ze sobą w interakcję.
  • Wynik biznesowy: czy zamierzona wizyta, callback lub zadanie wsparcia zostało zakończone.

Odebrane połączenie telefoniczne może trafić do osoby, na pocztę głosową lub do innego zautomatyzowanego systemu. Sam rekord połączenia nie jest w stanie udowodnić, że klient wykonał zadanie.

Zdarzenia pomagają aplikacji reagować na zmiany. Obsłuż duplikaty i opóźnione dostarczenia, a następnie uzgodnij brakujące lub niepewne aktualizacje ze stanem zarejestrowanym przez dostawcę.

Jak to zbudować z Bird?

Konfigurujesz połączenia wychodzące za pomocą trunku SIP, zweryfikowanego identyfikatora dzwoniącego i włączonego kraju docelowego.

Zmiany konfiguracji wymagają voice_management na poziomie zapisu.

Na trunku outbound_enabled musi mieć wartość true. domain to adres, z którym łączy się klient SIP. Uwierzytelnianie kluczem API umieszcza klucz w allowed_api_key_ids; klucz wymaga voice na poziomie zapisu. Aktualizacja tej listy zastępuje wszystkie wpisy, więc zachowaj klucze, których nadal używają inni klienci.

Identyfikator dzwoniącego wymaga status: verified, co potwierdza, że obszar roboczy zakończył połączenie weryfikacyjne. phone_number zawiera numer międzynarodowy, łącznie z początkowym +.

Kraj docelowy wymaga zarówno enabled: true, jak i status: available. Włączenie kraju nie sprawia, że nieobsługiwany cel staje się osiągalny.

Telefon przeglądarkowy wymaga również ustawienia session_credentials_enabled: true na trunku oraz wartości MD5 na liście digest_algorithms trunku.

Po połączeniu sprawdzasz status, rejection_reason i sip_response_code. Operacje listowania odcinków i odczytu odcinka zwracają te pola. Te operacje raportują próby połączeń. Twoja aplikacja SIP je inicjuje.

W przypadku menu głosowego konfigurujesz komunikaty i gałęzie klawiatury w podłączonej aplikacji. Środowisko głosowe AI dostarcza mowę, wnioskowanie i narzędzia biznesowe do prowadzenia rozmowy.

W skrócie

  1. API głosowe udostępniają różne operacje.

    Konfiguracja, sterowanie połączeniami i rekordy połączeń to osobne interfejsy. Operacja odczytu nie oznacza możliwości nawiązania połączenia.

  2. Sygnalizacja i audio mają oddzielne ścieżki.

    SIP nawiązuje i modyfikuje sesję. Media przenoszą to, co słyszą uczestnicy, więc sama udana sygnalizacja nie dowodzi, że audio działa.

  3. Odebrane połączenie nie dowodzi ukończenia zadania.

    Odebrane połączenie może trafić na pocztę głosową lub do innego systemu. Aplikacja, do której należy zadanie, potwierdza, czy zostało ono wykonane.

Zastosuj w praktyce.

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Uzyskaj brief wdrożeniowy

Buduj na tej samej sieci.

Testowy klucz API otrzymasz od razu. Dostęp produkcyjny odblokujesz po dodaniu metody płatności i zweryfikowaniu nadawcy.

Twój kolejny pomysł.
Gotowy do połączenia.