ThunderPhone v3 è online.Attivazione self-service, da 2¢/min.Leggi l’annuncio

Contact centers

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 /16 o più ristretto (IPv6 /48 o 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 restituito 409.

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'intestazione To. 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-RouteType e X-RouteValue indicano al copione dove inviare il chiamante, in questo caso alla competenza Support. Tra i valori documentati da altri provider per X-RouteType rientrano SkillTransfer, PhoneTransfer, Hangup e DispositionOnly; concorda i valori con chi gestisce il copione. Per più destinazioni, aggiungi un ritorno per ogni destinazione con un nome e un X-RouteValue diversi.
  • X-RouteReason contiene l'etichetta dell'intento dell'agente, ad esempio billing_dispute.
  • X-CustomMetaData contiene l'ID di passaggio. Il BYE lo contiene anche come X-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 BYE e non menziona l'accettazione di un REFER, quindi la restituzione è un trasferimento a freddo eseguito dal copione.
  • Five9 legge X-RouteType, X-RouteValue, X-RouteReason e X-CustomMetaData, non User-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.