Open in
Conectați-vă din NICE CXone
Trimiteți apelurile NICE CXone către un agent ThunderPhone dintr-un script Studio, cu ContactID într-un antet SIP, și căutați transferul agentului când scriptul continuă.
Scriptul dumneavoastră CXone Studio plasează un apel către agent cu antete SIP care conțin id-ul contactului și orice alt context. Când agentul termină, închide apelul, iar o acțiune API REST din script preia predarea.
Înainte de a începe
- Un agent ThunderPhone și o cheie API de organizație.
- Un grup de trunk SIP CXone care acceptă antete personalizate. Reprezentantul dumneavoastră de cont NICE trebuie să activeze această setare înainte ca CXone să le trimită.
1. Creați endpointul SIP
Placecall apelează un număr de telefon printr-un grup de trunk CXone, nu o adresă SIP.
NICE nu documentează credențialele SIP pentru acesta, iar integrarea CXone a unui alt
furnizor AI utilizează TLS cu o listă de IP-uri permise. Prin urmare, creați un endpoint
ip_allowlist cu numărul pe care scriptul î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": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: intervalele de semnalizare SIP ale clusterului dumneavoastră CXone, furnizate de NICE. 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 Placecall îl va apela, scris în formatul în care CXone îl trimite. 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: în acest caz se returnează409.
Adresele CXone sunt partajate de toți clienții săi, astfel încât orice alt client CXone care apelează numărul ajunge la agentul dumneavoastră. Alegeți un număr lung pe care nimeni nu l-ar ghici (cu până la 15 cifre), asigurați-vă că CXone îl trimite către ThunderPhone în loc să îl direcționeze către rețeaua telefonică și nu îl publicați.
2. Trimiteți apeluri cu context
În scriptul dumneavoastră Studio, înainte de Placecall:
- Adăugați o acțiune Sipputheader cu antetul
X-Call-IDși valoareaContactID. CXone nu trimite un antet propriu pentru id-ul apelului; ThunderPhone îl stochează pe acesta caexternal_call_idal apelului. - Adăugați o acțiune Sipputheader pentru fiecare altă valoare pe care agentul ar trebui
să o cunoască, cum ar fi
X-Skillsetat lasupport. Aceasta ajunge în prompt ca{{sip_x_skill}}. Sipputheader acceptăUser-to-User, orice antetX-și majoritatea antetelorP-; NICE recomandă valori de cel mult 256 de caractere.
Apoi utilizați Placecall pentru a apela acel număr, printr-un grup de trunk care îl trimite la
sip.thunderphone.com cu numărul atât în URI-ul cererii, cât și în antetul To.
Endpointul acceptă TLS (portul 5061) sau TCP (portul 5060) și refuză
UDP, iar NICE nu documentează transportul trunkului, deci asigurați-vă că nu este
UDP.
3. Preluați apelul înapoi
CXone citește antetele SIP numai în INVITE și în răspunsul său final, astfel că
agentul returnează apelul: își ia rămas-bun și închide apelul, iar scriptul dumneavoastră
preia apelantul din nou. Adăugați acest număr de transfer (consultați
Adăugați numărul de transfer):
{"name": "NICE CXone", "action": "return"}NICE nu documentează faptul că un script continuă după Placecall atunci când apelul plasat
se încheie. Integrările CXone ale altor furnizori AI semnalizează în schimb scriptului
prin API-ul Signal al CXone (POST /interactions/{contactId}/signal) înainte
de a închide apelul; ThunderPhone nu îl apelează. Confirmați cu NICE cum preia scriptul
dumneavoastră apelantul înapoi, apoi preluați predarea cu o acțiune REST API:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=urmat deContactID.- Antetul
Authorization: Bearer sk_live_…. - Citiți
handoff.summaryșihandoff.intentdin răspuns pentru a direcționa contactul.
Consultați Căutați un apel predat.
Testați-l
Apelați un număr care rulează scriptul, solicitați agentului o persoană și verificați că
scriptul continuă și că acțiunea REST API returnează transferul. Dacă apelul nu ajunge
niciodată la agent, verificați numărul trimis de CXone, că adresa sa sursă
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ă enumere x-call-id, iar
external_call_id ar trebui să fie egal cu ContactID.
Limitări
- CXone trimite și citește anteturi numai în
INVITEși în răspunsul său final2xx, deci nimic dinBYEal agentului nu ajunge la script. - NICE nu documentează acceptarea unui
REFERde la agent. - Acțiunea REST API expiră implicit după 10 secunde (cel mult sub 90 de secunde) și citește răspunsuri de până la 32 KB.