Open in
Conectați din Five9
Trimiteți apeluri Five9 către un agent ThunderPhone prin SIP cu AI Agent Connect și primiți-le înapoi cu antete de rutare pe care scriptul dumneavoastră IVR le citește.
Scriptul IVR Five9 trimite apelantul către agent împreună cu detaliile
apelului Five9. Când agentul termină, închide apelul cu antete de rutare în SIP
BYE, pe care scriptul le citește în variabilele apelului pentru a ruta apelantul.
Înainte de a începe
- Un agent ThunderPhone și o cheie API a organizației.
- Suplimentul Five9 Conectare agent AI. Five9 îl limitează la furnizorii AI pe care i-a acreditat, iar echipa de implementare Five9 îl configurează: importă șablonul de script IVR al furnizorului, creează variabilele apelului și direcționează modulul Transfer către terți al scriptului către furnizor. ThunderPhone nu se află încă pe lista de furnizori acreditați Five9: consultați echipa de cont Five9 sau asistența ThunderPhone înainte de a vă baza planurile pe această integrare.
1. Creați endpointul SIP
Modulul Five9 Transfer către terți apelează un număr de telefon, nu o adresă
SIP, iar integrările Five9 ale altor furnizori autentifică Five9 după adresa
sursă, nu printr-o parolă. Prin urmare, creați un endpoint ip_allowlist cu
numărul pe care Five9 îl va apela ca număr de apelare (consultați
Platforme care apelează un număr de telefon):
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: intervalele de semnalizare SIP ale centrelor dvs. de date Five9, furnizate de Five9. Fiecare trebuie să fie un interval IPv4 public de/16sau mai restrâns (IPv6/48sau mai restrâns).dial_in_numbers: numărul pe care scriptul Five9 îl va apela, scris în modul în care îl trimite Five9. Nu trebuie să fie un număr de telefon real. Nu poate fi deja utilizat în ThunderPhone, ca număr de telefon sau pe alt endpoint: aceasta returnează409.
Adresele Five9 sunt partajate de toți clienții săi, astfel că orice alt client Five9 care apelează numărul ajunge la agentul dvs. Când alegeți numărul, alegeți unul lung pe care nimeni nu l-ar ghici (până la 15 cifre), asigurați-vă că Five9 îl trimite către ThunderPhone, nu către rețeaua telefonică, și nu îl publicați.
2. Trimiteți apeluri cu context
Cereți echipei de implementare Five9 să:
- Trimită apelul din modulul Transfer către terți către
sip:+14155550188@sip.thunderphone.com, cu numărul atât în URI-ul solicitării, cât și în antetulTo. Modulul preia numărul, cu domeniul SIP al furnizorului într-un antet. - Îl trimită prin TLS (portul 5061) sau TCP (portul 5060). Endpointul refuză UDP, iar Five9 nu publică ce transport utilizează, deci asigurați-vă că nu este UDP.
- Activeze Revenire după apelul către terț, astfel încât scriptul să continue când agentul închide apelul (Five9 permite până la 3.600 de secunde pentru apelul către terț).
Ghidul Five9 enumeră valorile pe care le trimite (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name și altele), nu numele
antetelor. Integrările Five9 ale altor furnizori AI le documentează în
semnalizare drept X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID,
X-CallCampaign și X-AgentID; verificați-le la primul apel de test. Fiecare
ajunge în prompt ca variabilă, cum ar fi
{{sip_x_callcampaign}}. X-CallID este stocat ca
external_call_id al apelului.
3. Primiți apelul înapoi
Agentul returnează apelul: își ia rămas-bun și închide, iar BYE conține
cele patru antete pe care le citește scriptul Five9. Adăugați acest număr de transfer (consultați
Adăugați numărul de transfer):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeșiX-RouteValueîi indică scriptului unde să trimită apelantul, în acest caz către competența Support. Alți furnizori documentează pentruX-RouteTypevalorileSkillTransfer,PhoneTransfer,HangupșiDispositionOnly; stabiliți valorile cu persoana care administrează scriptul. Pentru mai multe destinații, adăugați câte un retur pentru fiecare destinație, cu un nume și unX-RouteValuediferite.X-RouteReasonconține eticheta intenției agentului, precumbilling_dispute.X-CustomMetaDataconține ID-ul predării.BYEîl conține și caX-TP-Handoff-Id, pe care Five9 nu îl citește.
Scriptul Five9 mapează cele patru antete în variabile de apel. Pentru rezumatul
agentului, configurați scriptul să apeleze căutarea predării cu un modul IVR Interogare:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= urmat de
call.call_id, cu un profil de autorizare care trimite
Authorization: Bearer și cheia dumneavoastră API. Consultați
Căutați un apel predat.
Testați
Apelați scriptul IVR, cereți agentului o persoană și verificați că scriptul
direcționează apelantul cu variabilele apelului completate. Dacă apelul nu ajunge niciodată la
agent, verificați că numărul din URI-ul solicitării și antetul To corespunde
numărului de apelare, că adresa sursă Five9 se află în allowed_source_cidrs și
că apelul a venit prin TCP sau TLS. Apoi deschideți apelul cu
GET /v1/calls/{call_id}: sip_headers ar trebui să listeze x-callid, iar
external_call_id ar trebui să corespundă cu call.call_id în Five9.
Limite
- Ghidul Five9 documentează datele de rutare în
BYEși nu menționează acceptarea unuiREFER, astfel că returnarea este un transfer neasistat realizat de script. - Five9 citește
X-RouteType,X-RouteValue,X-RouteReasonșiX-CustomMetaData, nuUser-to-User. ThunderPhone trimite fiecare valoare de antet cu o lungime de cel mult 256 de octeți. - Five9 recomandă păstrarea antetelor personalizate la aproximativ zece pentru a evita fragmentarea pachetelor.