Open in
Connetti da NICE CXone
Invia le chiamate NICE CXone a un agente ThunderPhone da un copione Studio con il ContactID in un
Il copione CXone Studio effettua una chiamata all'agente con intestazioni SIP che trasportano l'ID del contatto e qualsiasi altro contesto. Quando l'agente ha finito, riaggancia e un'azione REST API nel copione recupera il passaggio.
Prima di iniziare
- Un agente ThunderPhone e una chiave API dell'organizzazione.
- Un gruppo trunk SIP CXone che accetta intestazioni personalizzate. Il rappresentante del suo account NICE deve attivare questa impostazione prima che CXone le invii.
1. Creare l'endpoint SIP
Placecall compone un numero di telefono tramite un gruppo trunk CXone, non un indirizzo SIP. NICE non documenta le credenziali SIP per questa funzionalità e l'integrazione CXone di un altro provider AI usa TLS con una lista di autorizzazione IP. Crei quindi un endpoint ip_allowlist con il numero che il copione comporrà come numero di accesso (vedere Piattaforme che compongono 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": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: gli intervalli di segnalazione SIP del suo cluster CXone, forniti da NICE. Ognuno deve essere un intervallo IPv4 pubblico di/16o più ristretto (IPv6/48o più ristretto).dial_in_numbers: il numero che Placecall comporrà, scritto nel formato in cui CXone 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 restituisce409.
Gli indirizzi di CXone sono condivisi da tutti i suoi clienti, quindi qualsiasi altro cliente CXone che componga il numero raggiunge il suo agente. Nel punto in cui sceglie il numero, ne selezioni uno lungo che nessuno indovinerebbe facilmente, fino a 15 cifre, si assicuri che CXone lo invii a ThunderPhone anziché alla rete telefonica e non lo pubblichi.
2. Inviare chiamate con contesto
Nel suo copione Studio, prima di Placecall:
- Aggiunga un'azione Sipputheader con l'intestazione
X-Call-IDe il valore diContactID. CXone non invia un'intestazione call-id propria; ThunderPhone memorizza questa comeexternal_call_iddella chiamata. - Aggiunga un'azione Sipputheader per ogni altro valore che l'agente deve conoscere, ad esempio
X-Skillimpostato susupport. Raggiunge il prompt come{{sip_x_skill}}. Sipputheader accettaUser-to-User, qualsiasi intestazioneX-e la maggior parte delle intestazioniP-; NICE raccomanda valori di 256 caratteri o meno.
Quindi usi Placecall verso quel numero, tramite un gruppo trunk che lo invia a sip.thunderphone.com con il numero sia nell'URI della richiesta sia nell'intestazione To. L'endpoint accetta TLS, porta 5061, o TCP, porta 5060, e rifiuta UDP; NICE non documenta il trasporto del trunk, quindi si assicuri che non sia UDP.
3. Riprendere la chiamata
CXone legge le intestazioni SIP solo nell'INVITE e nella relativa risposta finale, quindi l'agente restituisce la chiamata: saluta e riaggancia, mentre il suo copione riprende il chiamante. Aggiunga questo numero di trasferimento (vedere Aggiungere il numero di trasferimento):
{"name": "NICE CXone", "action": "return"}NICE non documenta che un copione continui dopo Placecall quando termina la chiamata effettuata. Le integrazioni CXone di altri provider AI segnalano invece il copione tramite la Signal API di CXone (POST /interactions/{contactId}/signal) prima di riagganciare; ThunderPhone non la chiama. Confermi con NICE come il suo copione riprende il chiamante, quindi recuperi il passaggio con un'azione REST API:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=seguito daContactID.- Intestazione
Authorization: Bearer sk_live_…. - Legga
handoff.summaryehandoff.intentdalla risposta per instradare il contatto.
Vedere Cercare una chiamata trasferita.
Provalo
Chiama un numero che esegue il copione, chiedi all'agente una persona e verifica che
il copione continui e che l'azione REST API restituisca il trasferimento. Se la chiamata
non raggiunge mai l'agente, controlla il numero inviato da CXone, che il suo indirizzo di origine
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-call-id e
external_call_id dovrebbe essere uguale a ContactID.
Limiti
- CXone invia e legge le intestazioni solo su
INVITEe sul relativo2xxfinale, quindi nulla nelBYEdell'agente raggiunge il copione. - NICE non documenta l'accettazione di un
REFERdall'agente. - L'azione REST API va in timeout dopo 10 secondi per impostazione predefinita (al massimo meno di 90) e legge risposte fino a 32 KB.