Open in
Povežite iz Five9
Pošljite klice Five9 glasovnemu agentu ThunderPhone prek SIP z AI Agent Connect in jih prejemajte nazaj z usmerjevalnimi glavami, ki jih bere vaš skript IVR.
Vaš skript IVR Five9 klicatelja pošlje agentu s podrobnostmi klica Five9. Ko agent konča, prekine klic z glavami za usmerjanje v SIP BYE, ki jih skript prebere v spremenljivke klica za usmerjanje klicatelja.
Preden začnete
- Agent ThunderPhone in organizacijski ključ API.
- Dodatek Five9 AI Agent Connect. Five9 ga omejuje na ponudnike umetne inteligence, ki jih je odobril, njegova implementacijska ekipa Five9 pa ga nastavi: uvozi predlogo skripta IVR ponudnika, ustvari spremenljivke klica in modul skripta Prenos tretji osebi usmeri na ponudnika. ThunderPhone še ni na seznamu odobrenih ponudnikov Five9: preden se zanesete nanj, se obrnite na svojo ekipo za račun Five9 ali podporo ThunderPhone.
1. Ustvarite končno točko SIP
Modul Five9 za prenos tretji osebi kliče telefonsko številko, ne naslova SIP, integracije Five9 drugih ponudnikov pa Five9 preverjajo z izvornim naslovom namesto z geslom. Zato ustvarite končno točko ip_allowlist s številko, ki jo bo Five9 klical, kot številko za dohodne klice (glejte
Platforme, ki kličejo telefonsko številko):
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: signalni obsegi SIP vaših podatkovnih centrov Five9, ki jih zagotovi Five9. Vsak mora biti javni obseg IPv4/16ali ožji (IPv6/48ali ožji).dial_in_numbers: številka, ki jo bo klical skript Five9, zapisana tako, kot jo pošlje Five9. Ni nujno, da je prava telefonska številka. Ne sme biti že uporabljena v ThunderPhone, kot telefonska številka ali na drugi končni točki: v tem primeru se vrne409.
Naslove Five9 si delijo vse njegove stranke, zato vsak drug uporabnik Five9, ki pokliče številko, doseže vašega agenta. Pri izbiri številke izberite dolgo številko, ki je nihče ne bi uganil (do 15 mest), zagotovite, da jo Five9 pošlje v ThunderPhone namesto v telefonsko omrežje, in je ne objavite.
2. Pošljite klice s kontekstom
Implementacijsko ekipo Five9 prosite, naj:
- Klic iz modula Prenos tretji osebi pošlje na
sip:+14155550188@sip.thunderphone.com, pri čemer naj bo številka v URI zahteve in glaviTo. Modul uporabi številko z domeno SIP ponudnika v glavi. - Klic pošlje prek TLS (vrata 5061) ali TCP (vrata 5060). Končna točka zavrača UDP, Five9 pa ne objavlja, kateri prenos uporablja, zato preverite, da ne uporablja UDP.
- Vklopi Vrni se po klicu tretji osebi, da se skript nadaljuje, ko agent prekine klic (Five9 pri klicu tretji osebi omogoča do 3.600 sekund).
Vodnik Five9 navaja vrednosti, ki jih pošilja (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name in druge), ne pa imen njihovih glav. Integracije Five9 drugih ponudnikov umetne inteligence jih v prenosu dokumentirajo kot X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
in X-AgentID; preverite jih pri prvem testnem klicu. Vsaka se v pozivu prikaže kot spremenljivka, na primer
{{sip_x_callcampaign}}. X-CallID je shranjen kot
external_call_id klica.
3. Vrnitev klica
Agent vrne klic: poslovi se in prekine povezavo, BYE pa vsebuje
štiri glave, ki jih prebere skript Five9. Dodajte to številko za prenos (glejte
Dodajte številko za prenos):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeinX-RouteValueskriptu povesta, kam naj usmeri klicatelja, v tem primeru na veščino Support. Vrednosti zaX-RouteType, ki jih dokumentirajo drugi ponudniki, vključujejoSkillTransfer,PhoneTransfer,HangupinDispositionOnly; vrednosti uskladite z osebo, ki vzdržuje skript. Za več ciljev dodajte po eno vrnitev za vsak cilj z drugim imenom inX-RouteValue.X-RouteReasonvsebuje oznako namena agenta, na primerbilling_dispute.X-CustomMetaDatavsebuje ID predaje.BYEga vsebuje tudi kotX-TP-Handoff-Id, česar Five9 ne bere.
Skript Five9 preslika štiri glave v spremenljivke klica. Za povzetek agenta
naj skript z modulom IVR Poizvedba pokliče iskanje predaje:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= čemur sledi
call.call_id, s profilom avtorizacije, ki pošlje
Authorization: Bearer in vaš ključ API. Glejte
Iskanje predanega klica.
Preizkusite
Pokličite skript IVR, agenta prosite za osebo in preverite, ali skript
usmeri klicatelja z izpolnjenimi spremenljivkami klica. Če klic nikoli ne doseže
agenta, preverite, ali se številka v URI-ju zahteve in glavi To ujema s
številko za klicanje, ali je izvorni naslov Five9 v allowed_source_cidrs in
ali je klic prišel prek TCP ali TLS. Nato odprite klic z
GET /v1/calls/{call_id}: sip_headers mora navesti x-callid, vrednost
external_call_id pa se mora ujemati z call.call_id v Five9.
Omejitve
- Vodnik Five9 dokumentira podatke za usmerjanje v
BYEin ne omenja sprejemanjaREFER, zato skript predajo nazaj izvede kot hladni prenos. - Five9 bere
X-RouteType,X-RouteValue,X-RouteReasoninX-CustomMetaData, ne paUser-to-User. ThunderPhone pošlje posamezno vrednost glave, dolgo največ 256 bajtov. - Five9 priporoča, da zaradi preprečevanja fragmentacije paketov ohranite število glav po meri na približno deset.