ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Contact centers

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 /16 ali ožji (IPv6 /48 ali 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 vrne 409.

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 glavi To. 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-RouteType in X-RouteValue skriptu povesta, kam naj usmeri klicatelja, v tem primeru na veščino Support. Vrednosti za X-RouteType, ki jih dokumentirajo drugi ponudniki, vključujejo SkillTransfer, PhoneTransfer, Hangup in DispositionOnly; vrednosti uskladite z osebo, ki vzdržuje skript. Za več ciljev dodajte po eno vrnitev za vsak cilj z drugim imenom in X-RouteValue.
  • X-RouteReason vsebuje oznako namena agenta, na primer billing_dispute.
  • X-CustomMetaData vsebuje ID predaje. BYE ga vsebuje tudi kot X-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 BYE in ne omenja sprejemanja REFER, zato skript predajo nazaj izvede kot hladni prenos.
  • Five9 bere X-RouteType, X-RouteValue, X-RouteReason in X-CustomMetaData, ne pa User-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.