Open in
Connettiti da Five9
Invia le chiamate Five9 a un agente ThunderPhone tramite SIP con AI Agent Connect e ricevile di nuovo con intestazioni di instradamento lette dal tuo copione IVR.
Il copione IVR di Five9 invia il chiamante all'agente con i dettagli della
chiamata di Five9. Al termine, l'agente riaggancia con intestazioni di instradamento nel SIP
BYE, che il copione legge nelle variabili di chiamata per instradare il chiamante.
Prima di iniziare
- Un agente ThunderPhone e una chiave API dell'organizzazione.
- L'add-on AI Agent Connect di Five9. Five9 lo limita ai fornitori di IA che ha accreditato e il team di implementazione di Five9 lo configura: importa il modello di copione IVR del fornitore, crea le variabili di chiamata e indirizza il modulo Trasferimento a terzi del copione al fornitore. ThunderPhone non è ancora nell'elenco dei fornitori accreditati da Five9: chiedi al team che gestisce il tuo account Five9 o al supporto ThunderPhone prima di pianificare in base a questa integrazione.
1. Crea l'endpoint SIP
Il modulo Trasferimento a terzi di Five9 chiama un numero di telefono, non un indirizzo SIP,
e le integrazioni Five9 di altri fornitori autenticano Five9 tramite l'indirizzo di origine
anziché una password. Crea quindi un endpoint ip_allowlist con il numero
che Five9 chiamerà come numero di accesso (vedi
Piattaforme che chiamano un numero di telefono):
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: gli intervalli di segnalazione SIP dei tuoi data center Five9, forniti da Five9. Ognuno deve essere un intervallo IPv4 pubblico di/16o più ristretto (IPv6/48o più ristretto).dial_in_numbers: il numero che il copione Five9 chiamerà, scritto nel modo in cui Five9 lo invia. Non deve necessariamente essere un numero di telefono reale. Non può essere già in uso su ThunderPhone, come numero di telefono o su un altro endpoint: in tal caso viene restituito409.
Gli indirizzi di Five9 sono condivisi da tutti i suoi clienti, quindi qualsiasi altro cliente Five9 che chiami il numero raggiunge il tuo agente. Quando scegli il numero, scegline uno lungo che nessuno possa indovinare (fino a 15 cifre), assicurati che Five9 lo invii a ThunderPhone anziché alla rete telefonica e non pubblicarlo.
2. Invia le chiamate con contesto
Chiedi al team di implementazione di Five9 di:
- Inviare la chiamata dal modulo Trasferimento a terzi a
sip:+14155550188@sip.thunderphone.com, con il numero sia nell'URI della richiesta sia nell'intestazioneTo. Il modulo utilizza il numero, con il dominio SIP del fornitore in un'intestazione. - Inviarla tramite TLS (porta 5061) o TCP (porta 5060). L'endpoint rifiuta UDP, e Five9 non pubblica quale trasporto utilizza, quindi assicurati che non sia UDP.
- Attivare Ritorno dopo chiamata di terze parti, in modo che il copione continui quando l'agente riaggancia (Five9 consente fino a 3.600 secondi per la chiamata di terze parti).
La guida di Five9 elenca i valori che invia (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name e altri), non i nomi delle
intestazioni. Le integrazioni Five9 di altri fornitori di IA li documentano a livello di protocollo
come X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
e X-AgentID; verificali nella prima chiamata di test. Ognuno raggiunge il prompt come variabile, ad esempio
{{sip_x_callcampaign}}. X-CallID viene memorizzato come
external_call_id della chiamata.
3. Ricevi nuovamente la chiamata
L'agente restituisce la chiamata: saluta e riaggancia, e il BYE contiene
i quattro header letti dal copione di Five9. Aggiungi questo numero di trasferimento (vedi
Aggiungi il numero di trasferimento):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeeX-RouteValueindicano al copione dove inviare il chiamante, in questo caso alla competenza Support. Tra i valori documentati da altri provider perX-RouteTyperientranoSkillTransfer,PhoneTransfer,HangupeDispositionOnly; concorda i valori con chi gestisce il copione. Per più destinazioni, aggiungi un ritorno per ogni destinazione con un nome e unX-RouteValuediversi.X-RouteReasoncontiene l'etichetta dell'intento dell'agente, ad esempiobilling_dispute.X-CustomMetaDatacontiene l'ID di passaggio. IlBYElo contiene anche comeX-TP-Handoff-Id, che Five9 non legge.
Il copione di Five9 associa i quattro header alle variabili della chiamata. Per il
riepilogo dell'agente, fai in modo che il copione chiami la ricerca del passaggio con un modulo IVR Query:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= seguito da
call.call_id, con un profilo di autorizzazione che invia
Authorization: Bearer e la tua chiave API. Vedi
Cerca una chiamata passata.
Verifica
Chiama il copione IVR, chiedi all'agente di parlare con una persona e verifica che il copione
instradi il chiamante con le variabili della chiamata compilate. Se la chiamata non raggiunge mai
l'agente, verifica che il numero nell'URI della richiesta e nell'header To corrisponda al
numero di accesso, che l'indirizzo di origine di Five9 sia in allowed_source_cidrs e
che la chiamata sia arrivata tramite TCP o TLS. Quindi apri la chiamata con
GET /v1/calls/{call_id}: sip_headers dovrebbe elencare x-callid e
external_call_id dovrebbe corrispondere a call.call_id in Five9.
Limiti
- La guida di Five9 documenta i dati di instradamento nel
BYEe non menziona l'accettazione di unREFER, quindi la restituzione è un trasferimento a freddo eseguito dal copione. - Five9 legge
X-RouteType,X-RouteValue,X-RouteReasoneX-CustomMetaData, nonUser-to-User. ThunderPhone invia valori degli header lunghi al massimo 256 byte. - Five9 consiglia di limitare gli header personalizzati a circa dieci per evitare la frammentazione dei pacchetti.