Open in
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/16lub węższym (IPv6/48lub 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 kod409.
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łówkuTo. 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-RouteTypeiX-RouteValueinformują skrypt, dokąd skierować rozmówcę, tutaj do umiejętności Support. WartościX-RouteTypedokumentowane przez innych dostawców obejmująSkillTransfer,PhoneTransfer,HangupiDispositionOnly; 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-RouteReasonzawiera etykietę intencji agenta, taką jakbilling_dispute.X-CustomMetaDatazawiera identyfikator przekazania.BYEzawiera go również jakoX-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
BYEi nie wspomina o akceptowaniuREFER, więc przekazanie z powrotem jest transferem bez konsultacji wykonywanym przez skrypt. - Five9 odczytuje
X-RouteType,X-RouteValue,X-RouteReasoniX-CustomMetaData, a nieUser-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.