Open in
Prisijunkite iš Five9
Siųskite Five9 skambučius ThunderPhone agentui per SIP naudodami AI Agent Connect ir grąžinkite juos su maršruto parinkimo antraštėmis, kurias nuskaito jūsų IVR scenarijus.
Jūsų Five9 IVR scenarijus siunčia skambinantįjį agentui kartu su Five9 skambučio
informacija. Kai agentas baigia darbą, jis nutraukia skambutį ir SIP
BYE pranešime pateikia maršruto parinkimo antraštes, kurias scenarijus
nuskaito į skambučio kintamuosius, kad nukreiptų skambinantįjį.
Prieš pradedant
- ThunderPhone agentas ir organizacijos API raktas.
- Five9 AI Agent Connect priedas. Five9 jį riboja tik savo akredituotais DI paslaugų teikėjais, o Five9 diegimo komanda jį sukonfigūruoja: importuoja paslaugų teikėjo IVR scenarijaus šabloną, sukuria skambučio kintamuosius ir scenarijaus modulį Trečiosios šalies perdavimas nukreipia į paslaugų teikėją. ThunderPhone dar nėra Five9 akredituotų paslaugų teikėjų sąraše: prieš planuodami jo naudojimą kreipkitės į savo Five9 paskyros komandą arba ThunderPhone palaikymo tarnybą.
1. Sukurkite SIP galinį tašką
Five9 modulis „Trečiosios šalies perdavimas“ renka telefono numerį, o ne SIP adresą,
o kitų paslaugų teikėjų Five9 integracijos autentifikuoja Five9 pagal šaltinio adresą,
o ne slaptažodį. Todėl sukurkite ip_allowlist galinį tašką, kuriame numeris,
kuriuo skambins Five9, būtų nurodytas kaip prisijungimo numeris (žr.
Platformos, kurios renka telefono numerį):
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: jūsų Five9 duomenų centrų SIP signalizavimo diapazonai, kuriuos pateikia Five9. Kiekvienas turi būti viešas/16arba siauresnis IPv4 diapazonas (IPv6/48arba siauresnis).dial_in_numbers: numeris, kurį rinks Five9 scenarijus, užrašytas taip, kaip jį siunčia Five9. Jis neprivalo būti tikras telefono numeris. Jis negali būti jau naudojamas ThunderPhone kaip telefono numeris arba kitame galiniame taške: tokiu atveju grąžinamas409.
Five9 adresais dalijasi visi jos klientai, todėl bet kuris kitas Five9 klientas, surinkęs šį numerį, pasieks jūsų agentą. Rinkdamiesi numerį pasirinkite ilgą numerį, kurio niekas neatspėtų (iki 15 skaitmenų), įsitikinkite, kad Five9 siunčia jį į ThunderPhone, o ne į telefono tinklą, ir jo neskelbkite.
2. Siųskite skambučius su kontekstu
Paprašykite Five9 diegimo komandos:
- Siųsti skambutį iš modulio Trečiosios šalies perdavimas į
sip:+14155550188@sip.thunderphone.com, numerį nurodant ir užklausos URI, irToantraštėje. Modulis naudoja numerį, o paslaugų teikėjo SIP domeną pateikia antraštėje. - Siųsti per TLS (5061 prievadas) arba TCP (5060 prievadas). Galinis taškas atmeta UDP, o Five9 neskelbia, kokį transportą naudoja, todėl įsitikinkite, kad tai nėra UDP.
- Įjungti Grįžti po trečiosios šalies skambučio, kad scenarijus būtų tęsiamas, kai agentas nutraukia skambutį (Five9 trečiosios šalies skambučiui leidžia iki 3 600 sekundžių).
Five9 vadove pateikiamos siunčiamos reikšmės (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name ir kitos), bet ne jų
antraščių pavadinimai. Kitų DI paslaugų teikėjų Five9 integracijose jos
perduodamos kaip X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID,
X-CallCampaign ir X-AgentID; patikrinkite jas per pirmąjį bandomąjį skambutį.
Kiekviena jų pasiekia raginimą kaip kintamasis, pavyzdžiui,
{{sip_x_callcampaign}}. X-CallID išsaugomas kaip skambučio
external_call_id.
3. Grąžinkite skambutį
Agentas grąžina skambutį: atsisveikina ir nutraukia pokalbį, o BYE perduoda
keturias antraštes, kurias nuskaito Five9 scenarijus. Pridėkite šį perdavimo numerį (žr.
Pridėkite perdavimo numerį):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeirX-RouteValuenurodo scenarijui, kur nukreipti skambinantįjį, šiuo atveju į Support kompetenciją. Kiti teikėjaiX-RouteTypereikšmėms dokumentuojaSkillTransfer,PhoneTransfer,HangupirDispositionOnly; suderinkite reikšmes su asmeniu, kuris prižiūri scenarijų. Jei yra kelios paskirtys, kiekvienai paskirčiai pridėkite po vieną grąžinimo veiksmą su skirtingu pavadinimu irX-RouteValue.X-RouteReasonperduoda agento ketinimo žymą, pvz.,billing_dispute.X-CustomMetaDataperduoda perdavimo ID.BYEjį taip pat perduoda kaipX-TP-Handoff-Id, kurio Five9 nenuskaito.
Five9 scenarijus susieja keturias antraštes su skambučio kintamaisiais. Kad gautumėte
agento suvestinę, nurodykite scenarijui iškviesti perdavimo paiešką naudojant IVR Užklausa modulį:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= po kurio nurodomas
call.call_id, naudojant autorizacijos profilį, kuris siunčia
Authorization: Bearer ir jūsų API raktą. Žr.
Perduoto skambučio paieška.
Išbandykite
Paskambinkite į IVR scenarijų, paprašykite agento sujungti su žmogumi ir patikrinkite,
ar scenarijus nukreipia skambinantįjį su užpildytais skambučio kintamaisiais. Jei skambutis
niekada nepasiekia agento, patikrinkite, ar užklausos URI ir To antraštėje nurodytas numeris
sutampa su įeinančių skambučių numeriu, ar Five9 šaltinio adresas yra allowed_source_cidrs,
ir ar skambutis atėjo per TCP arba TLS. Tada atidarykite skambutį naudodami
GET /v1/calls/{call_id}: sip_headers turėtų būti nurodyta x-callid, o
external_call_id turėtų sutapti su Five9 call.call_id.
Apribojimai
- Five9 vadove maršruto duomenys dokumentuojami
BYEpranešime ir neminima, kad priimamasREFER, todėl atgalinis perdavimas yra scenarijaus atliekamas šaltas perdavimas. - Five9 nuskaito
X-RouteType,X-RouteValue,X-RouteReasonirX-CustomMetaData, bet neUser-to-User. ThunderPhone siunčia kiekvienos antraštės reikšmę, kurios ilgis neviršija 256 baitų. - Five9 rekomenduoja naudoti maždaug iki dešimties pasirinktinių antraščių, kad būtų išvengta paketų fragmentavimo.