Open in
Savienojiet no Five9
Nosūtiet Five9 zvanus uz ThunderPhone balss aģentu, izmantojot SIP un AI Agent Connect, un saņemiet tos atpakaļ ar maršrutēšanas galvenēm, ko nolasa jūsu IVR skripts.
Jūsu Five9 IVR skripts nosūta zvanītāju pie aģenta kopā ar Five9 zvana
detalizēto informāciju. Kad aģents ir pabeidzis darbu, tas pārtrauc zvanu,
SIP BYE iekļaujot maršrutēšanas galvenes, kuras skripts nolasa zvana
mainīgajos, lai maršrutētu zvanītāju.
Pirms sākat
- ThunderPhone aģents un organizācijas API atslēga.
- Five9 AI aģenta savienojuma papildinājums. Five9 to ierobežo ar AI pakalpojumu sniedzējiem, kurus tas ir akreditējis, un Five9 ieviešanas komanda to iestata: tā importē pakalpojumu sniedzēja IVR skripta veidni, izveido zvana mainīgos un konfigurē skripta Trešās puses pārsūtīšanas moduli pakalpojumu sniedzējam. ThunderPhone vēl nav Five9 akreditēto pakalpojumu sniedzēju sarakstā: pirms plānojat to izmantot, jautājiet savai Five9 konta komandai vai ThunderPhone atbalsta dienestam.
1. Izveidojiet SIP galapunktu
Five9 Trešās puses pārsūtīšanas modulis izsauc tālruņa numuru, nevis SIP adresi,
un citu pakalpojumu sniedzēju Five9 integrācijas autentificē Five9 pēc avota adreses,
nevis paroles. Tāpēc izveidojiet ip_allowlist galapunktu ar numuru, kuru
Five9 izsauks, kā iezvanes numuru (skatiet
Platformas, kas izsauc tālruņa numuru):
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ūsu Five9 datu centru SIP signalizācijas diapazoni, ko nodrošina Five9. Katram jābūt publiskam IPv4 diapazonam ar/16vai šaurāku masku (IPv6 —/48vai šaurāku).dial_in_numbers: numurs, kuru Five9 skripts izsauks, rakstīts tā, kā to nosūta Five9. Tam nav jābūt reālam tālruņa numuram. To nedrīkst jau izmantot ThunderPhone — ne kā tālruņa numuru, ne citā galapunktā; pretējā gadījumā tiek atgriezts409.
Five9 adreses ir kopīgas visiem tā klientiem, tāpēc jebkurš cits Five9 klients, kurš izsauc šo numuru, sasniedz jūsu aģentu. Izvēloties numuru, izvēlieties garu numuru, kuru neviens neuzminētu (līdz 15 cipariem), pārliecinieties, ka Five9 to nosūta uz ThunderPhone, nevis tālruņu tīklu, un nepublicējiet to.
2. Sūtiet zvanus ar kontekstu
Lūdziet Five9 ieviešanas komandai:
- Sūtīt zvanu no Trešās puses pārsūtīšanas moduļa uz
sip:+14155550188@sip.thunderphone.com, numuru iekļaujot gan pieprasījuma URI, ganTogalvenē. Modulis izmanto numuru ar pakalpojumu sniedzēja SIP domēnu galvenē. - Sūtīt to, izmantojot TLS (ports 5061) vai TCP (ports 5060). Galapunkts atsaka UDP, un Five9 nepublicē, kuru transportu tas izmanto, tāpēc pārliecinieties, ka tas nav UDP.
- Ieslēgt Atgriezties pēc trešās puses zvana, lai skripts turpinātu darbu, kad aģents pārtrauc zvanu (Five9 trešās puses zvanam atļauj līdz 3 600 sekundēm).
Five9 ceļvedī ir norādītas vērtības, ko tas nosūta (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name un citas), nevis to
galveņu nosaukumi. Citu AI pakalpojumu sniedzēju Five9 integrācijas tās protokola līmenī
dokumentē kā X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
un X-AgentID; pārbaudiet tās savā pirmajā testa zvanā. Katra nonāk uzvednē kā mainīgais, piemēram,
{{sip_x_callcampaign}}. X-CallID tiek saglabāts kā zvana
external_call_id.
3. Saņemiet zvanu atpakaļ
Aģents atdod zvanu: tas atvadās un noliek klausuli, un BYE ietver
četras galvenes, ko nolasa Five9 skripts. Pievienojiet šo pārsūtīšanas numuru (skatiet
Pievienojiet pārsūtīšanas numuru):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeunX-RouteValuenorāda skriptam, kur nosūtīt zvanītāju — šajā gadījumā uz Support prasmi. Citu pakalpojumu sniedzēju dokumentētāsX-RouteTypevērtības ietverSkillTransfer,PhoneTransfer,HangupunDispositionOnly; saskaņojiet vērtības ar personu, kas uztur skriptu. Vairākiem galamērķiem pievienojiet vienu atgriešanu katram galamērķim ar citu nosaukumu unX-RouteValue.X-RouteReasonietver aģenta nodoma etiķeti, piemēram,billing_dispute.X-CustomMetaDataietver nodošanas ID.BYEto ietver arī kāX-TP-Handoff-Id, ko Five9 nenolasa.
Five9 skripts kartē četras galvenes uz zvana mainīgajiem. Lai iegūtu aģenta
kopsavilkumu, lieciet skriptam izsaukt nodošanas meklēšanu ar IVR Vaicājuma moduli:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= kam seko
call.call_id, izmantojot autorizācijas profilu, kas nosūta
Authorization: Bearer un jūsu API atslēgu. Skatiet
Meklējiet nodotu zvanu.
Testējiet
Piezvaniet uz IVR skriptu, palūdziet aģentam savienot ar personu un pārbaudiet, vai skripts
maršrutē zvanītāju ar aizpildītiem zvana mainīgajiem. Ja zvans nekad nenonāk pie
aģenta, pārbaudiet, vai numurs pieprasījuma URI un To galvenē atbilst
iezvanes numuram, vai Five9 avota adrese ir iekļauta allowed_source_cidrs un
vai zvans tika veikts, izmantojot TCP vai TLS. Pēc tam atveriet zvanu ar
GET /v1/calls/{call_id}: sip_headers jānorāda x-callid, un
external_call_id jāatbilst Five9 call.call_id.
Ierobežojumi
- Five9 ceļvedī ir dokumentēti maršrutēšanas dati
BYEziņojumā, bet nav minētaREFERpieņemšana, tāpēc atdošana ir skripta veikta aukstā pārsūtīšana. - Five9 nolasa
X-RouteType,X-RouteValue,X-RouteReasonunX-CustomMetaData, nevisUser-to-User. ThunderPhone katras galvenes vērtību nosūta ne garāku par 256 baitiem. - Five9 iesaka saglabāt pielāgoto galveņu skaitu apmēram līdz desmit, lai izvairītos no pakešu fragmentācijas.