Open in
Unganisha kutoka Five9
Tuma simu za Five9 kwa ejenti wa ThunderPhone kupitia SIP ukitumia AI Agent Connect, kisha uzirudishe zikiwa na vichwa vya uelekezaji ambavyo script yako ya IVR husoma.
Script yako ya Five9 IVR humtuma mpigaji kwa ejenti pamoja na maelezo ya simu ya Five9. Ejenti anapomaliza, hukata simu akiwa na vichwa vya kuelekeza kwenye SIP
BYE, ambavyo script husoma kama vigeu vya simu ili kumwelekeza mpigaji.
Kabla ya kuanza
- Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
- Nyongeza ya AI Agent Connect ya Five9. Five9 huiwekea kikomo kwa watoa huduma wa AI ambao imewaidhinisha, na timu ya utekelezaji ya Five9 huisanidi: huingiza kiolezo cha script ya IVR cha mtoa huduma, huunda vigeu vya simu na kuelekeza moduli ya Third Party Transfer ya script kwa mtoa huduma. ThunderPhone bado haiko kwenye orodha ya Five9 ya watoa huduma walioidhinishwa: wasiliana na timu yako ya akaunti ya Five9 au usaidizi wa ThunderPhone kabla ya kupanga kutegemea huduma hii.
1. Unda endpoint ya SIP
Moduli ya Third Party Transfer ya Five9 hupiga namba ya simu, si anwani ya SIP,
na miunganisho ya Five9 ya watoa huduma wengine huthibitisha Five9 kwa anwani
chanzi badala ya nenosiri. Kwa hivyo unda endpoint ya ip_allowlist yenye namba
ambayo Five9 itapiga kama namba ya kuingia (tazama
Majukwaa yanayopiga namba ya simu):
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: masafa ya uashiriaji wa SIP ya vituo vyako vya data vya Five9, kutoka Five9. Kila moja lazima liwe masafa ya umma ya IPv4 ya/16au yenye upeo mwembamba zaidi (IPv6/48au yenye upeo mwembamba zaidi).dial_in_numbers: namba ambayo script ya Five9 itapiga, iliyoandikwa kwa namna Five9 inavyoituma. Si lazima iwe namba halisi ya simu. Haiwezi kuwa tayari inatumika kwenye ThunderPhone, iwe kama namba ya simu au kwenye endpoint nyingine: hali hiyo hurejesha409.
Anwani za Five9 zinashirikiwa na wateja wake wote, kwa hivyo mteja mwingine yeyote wa Five9 anayepiga namba hiyo atamfikia ejenti wako. Mahali unapochagua namba, chagua ndefu ambayo hakuna mtu angeikisia (hadi tarakimu 15), hakikisha Five9 inaituma kwa ThunderPhone badala ya kuituma kwenye mtandao wa simu, na usiichapishe.
2. Tuma simu pamoja na muktadha
Iombe timu ya utekelezaji ya Five9:
- Kutuma simu kutoka kwenye moduli ya Third Party Transfer hadi
sip:+14155550188@sip.thunderphone.com, ikiwa na namba katika URI ya ombi na kichwa chaTo. Moduli huchukua namba, huku kikoa cha SIP cha mtoa huduma kikiwa kwenye kichwa. - Kuituma kupitia TLS (porti 5061) au TCP (porti 5060). Endpoint hukataa UDP, na Five9 haichapishi ni usafirishaji upi unaotumia, kwa hivyo hakikisha si UDP.
- Kuwasha Rudi Baada ya Simu ya Upande wa Tatu, ili script iendelee ejenti anapokata simu (Five9 inaruhusu hadi sekunde 3,600 kwa simu ya upande wa tatu).
Mwongozo wa Five9 unaorodhesha thamani inazotuma (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name na nyinginezo), si majina
ya vichwa vyake. Miunganisho ya Five9 ya watoa huduma wengine wa AI huziorodhesha
katika itifaki kama X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID,
X-CallCampaign na X-AgentID; zihakiki kwenye simu yako ya kwanza ya majaribio. Kila moja hufika kwenye prompt kama kigeu, kama vile
{{sip_x_callcampaign}}. X-CallID huhifadhiwa kama
external_call_id ya simu.
3. Rejesha simu
Ejenti inarejesha simu: inasema kwaheri na kukata simu, na BYE hubeba
vichwa vinne ambavyo skripti ya Five9 husoma. Ongeza namba hii ya uhamisho (tazama
Ongeza namba ya uhamisho):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypenaX-RouteValuehuiambia skripti mahali pa kumtuma mpigaji, hapa ni ujuzi wa Support. Thamani ambazo watoa huduma wengine huandika kwaX-RouteTypezinajumuishaSkillTransfer,PhoneTransfer,HangupnaDispositionOnly; kubaliana kuhusu thamani hizo na anayesimamia skripti. Kwa lengwa kadhaa, ongeza rejesho moja kwa kila lengwa lenye jina tofauti naX-RouteValue.X-RouteReasonhubeba lebo ya nia ya ejenti, kama vilebilling_dispute.X-CustomMetaDatahubeba kitambulisho cha uhamisho.BYEpia hukibeba kamaX-TP-Handoff-Id, ambacho Five9 haisomi.
Skripti ya Five9 huweka vichwa vinne kwenye vigezo vya simu. Kwa muhtasari wa
ejenti, iwezeshe skripti kuita utafutaji wa uhamisho kwa kutumia moduli ya IVR ya Hoja:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ikifuatiwa na
call.call_id, kwa Wasifu wa Uidhinishaji unaotuma
Authorization: Bearer na ufunguo wako wa API. Tazama
Tafuta simu iliyohamishwa.
Ijaribu
Piga simu kwenye skripti ya IVR, mwombe ejenti akuhamishe kwa mtu, na uthibitishe kuwa skripti
inamwelekeza mpigaji huku vigezo vya simu vimejazwa. Ikiwa simu haimfikii kamwe
ejenti, thibitisha kuwa namba katika URI ya ombi na kichwa cha To inalingana na
namba ya kupiga, kwamba anwani chanzi ya Five9 iko katika allowed_source_cidrs, na
kwamba simu ilikuja kupitia TCP au TLS. Kisha fungua simu kwa
GET /v1/calls/{call_id}: sip_headers inapaswa kuorodhesha x-callid, na
external_call_id inapaswa kulingana na call.call_id katika Five9.
Vikomo
- Mwongozo wa Five9 huandika data ya kuelekeza kwenye
BYEna hautaji kukubaliREFER, kwa hivyo urejeshaji ni uhamisho baridi unaofanywa na skripti. - Five9 husoma
X-RouteType,X-RouteValue,X-RouteReasonnaX-CustomMetaData, siUser-to-User. ThunderPhone hutuma kila thamani ya kichwa yenye urefu wa hadi baiti 256. - Five9 inapendekeza kuweka vichwa maalum karibu na kumi ili kuepuka mgawanyiko wa paketi.