ThunderPhone v3 już działa.Uruchom samodzielnie, od 2¢/min.Przeczytaj komunikat

Contact centers

Połącz z Five9

Przekierowuj połączenia Five9 do agenta ThunderPhone przez SIP za pomocą AI Agent Connect i odbieraj je z powrotem z nagłówkami routingu odczytywanymi przez skrypt IVR.

Skrypt IVR Five9 przekazuje rozmówcę do agenta wraz ze szczegółami połączenia z Five9. Gdy agent zakończy rozmowę, rozłącza ją z nagłówkami routingu w komunikacie SIP BYE, które skrypt odczytuje do zmiennych połączenia, aby skierować rozmówcę dalej.

Zanim zaczniesz

  • Agent ThunderPhone i organizacyjny klucz API.
  • Dodatek Five9 AI Agent Connect. Five9 ogranicza go do akredytowanych dostawców AI, a zespół wdrożeniowy Five9 go konfiguruje: importuje szablon skryptu IVR dostawcy, tworzy zmienne połączenia i wskazuje dostawcę w module Transfer zewnętrzny skryptu. ThunderPhone nie znajduje się jeszcze na liście akredytowanych dostawców Five9: przed uwzględnieniem tego w planach skontaktuj się z zespołem obsługi konta Five9 lub pomocą techniczną ThunderPhone.

1. Utwórz punkt końcowy SIP

Moduł Transferu zewnętrznego Five9 wybiera numer telefonu, a nie adres SIP, a integracje Five9 innych dostawców uwierzytelniają Five9 według adresu źródłowego, a nie hasła. Utwórz więc punkt końcowy ip_allowlist z numerem, który Five9 będzie wybierać, jako numerem do wybierania przychodzącego (zobacz Platformy wybierające numer telefonu):

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "name": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs: zakresy sygnalizacji SIP centrów danych Five9, uzyskane od Five9. Każdy musi być publicznym zakresem IPv4 o prefiksie /16 lub węższym (IPv6 /48 lub węższym).
  • dial_in_numbers: numer, który będzie wybierał skrypt Five9, zapisany w formie wysyłanej przez Five9. Nie musi być prawdziwym numerem telefonu. Nie może być już używany w ThunderPhone jako numer telefonu ani w innym punkcie końcowym: w takim przypadku zwracany jest kod 409.

Adresy Five9 są współdzielone przez wszystkich jego klientów, więc każdy inny klient Five9, który wybierze ten numer, połączy się z Twoim agentem. Wybierając numer, użyj długiego numeru, którego nikt nie odgadnie (do 15 cyfr), upewnij się, że Five9 wysyła go do ThunderPhone, a nie do sieci telefonicznej, i nie publikuj go.

2. Wysyłaj połączenia z kontekstem

Poproś zespół wdrożeniowy Five9 o:

  • Wysyłanie połączeń z modułu Transfer zewnętrzny do sip:+14155550188@sip.thunderphone.com, z numerem zarówno w identyfikatorze URI żądania, jak i nagłówku To. Moduł pobiera numer, a domenę SIP dostawcy umieszcza w nagłówku.
  • Wysyłanie ich przez TLS (port 5061) lub TCP (port 5060). Punkt końcowy odrzuca UDP, a Five9 nie publikuje informacji o używanym transporcie, więc upewnij się, że nie jest to UDP.
  • Włączenie Powrót po połączeniu zewnętrznym, aby skrypt był kontynuowany po rozłączeniu przez agenta (Five9 zezwala na maksymalnie 3600 sekund połączenia zewnętrznego).

Przewodnik Five9 wymienia wysyłane wartości (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name i inne), ale nie nazwy ich nagłówków. Integracje Five9 innych dostawców AI dokumentują je na poziomie protokołu jako X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign i X-AgentID; sprawdź je podczas pierwszego połączenia testowego. Każda z nich trafia do promptu jako zmienna, na przykład {{sip_x_callcampaign}}. X-CallID jest przechowywany jako external_call_id połączenia.

3. Odbierz połączenie z powrotem

Agent zwraca połączenie: żegna się i rozłącza, a BYE zawiera cztery nagłówki odczytywane przez skrypt Five9. Dodaj ten numer transferu (zobacz Dodawanie numeru transferu):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType i X-RouteValue informują skrypt, dokąd skierować rozmówcę, tutaj do umiejętności Support. Wartości X-RouteType dokumentowane przez innych dostawców obejmują SkillTransfer, PhoneTransfer, Hangup i DispositionOnly; uzgodnij te wartości z osobą utrzymującą skrypt. W przypadku kilku miejsc docelowych dodaj po jednym wpisie return dla każdego miejsca, z inną nazwą i wartością X-RouteValue.
  • X-RouteReason zawiera etykietę intencji agenta, taką jak billing_dispute.
  • X-CustomMetaData zawiera identyfikator przekazania. BYE zawiera go również jako X-TP-Handoff-Id, którego Five9 nie odczytuje.

Skrypt Five9 mapuje cztery nagłówki na zmienne połączenia. Aby uzyskać podsumowanie agenta, skonfiguruj skrypt tak, aby wywoływał wyszukiwanie przekazania za pomocą modułu IVR Zapytanie: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= po którym następuje call.call_id, z profilem autoryzacji wysyłającym Authorization: Bearer i Twój klucz API. Zobacz Wyszukiwanie przekazanego połączenia.

Przetestuj

Zadzwoń do skryptu IVR, poproś agenta o połączenie z osobą i sprawdź, czy skrypt kieruje rozmówcę z wypełnionymi zmiennymi połączenia. Jeśli połączenie nigdy nie dociera do agenta, sprawdź, czy numer w URI żądania i nagłówku To odpowiada numerowi dostępowemu, czy adres źródłowy Five9 znajduje się w allowed_source_cidrs oraz czy połączenie przyszło przez TCP lub TLS. Następnie otwórz połączenie za pomocą GET /v1/calls/{call_id}: sip_headers powinno zawierać x-callid, a external_call_id powinno odpowiadać call.call_id w Five9.

Ograniczenia

  • Przewodnik Five9 dokumentuje dane routingu w BYE i nie wspomina o akceptowaniu REFER, więc przekazanie z powrotem jest transferem bez konsultacji wykonywanym przez skrypt.
  • Five9 odczytuje X-RouteType, X-RouteValue, X-RouteReason i X-CustomMetaData, a nie User-to-User. ThunderPhone wysyła każdą wartość nagłówka o długości maksymalnie 256 bajtów.
  • Five9 zaleca ograniczenie liczby niestandardowych nagłówków do około dziesięciu, aby uniknąć fragmentacji pakietów.