ThunderPhone v3 este disponibil.Self-service, de la 2 ¢/min.Citiți anunțul

Contact centers

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 /16 sau mai restrâns (IPv6 /48 sau 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:

  1. Adăugați o acțiune Sipputheader cu antetul X-Call-ID și valoarea ContactID. CXone nu trimite un antet propriu pentru id-ul apelului; ThunderPhone îl stochează pe acesta ca external_call_id al apelului.
  2. Adăugați o acțiune Sipputheader pentru fiecare altă valoare pe care agentul ar trebui să o cunoască, cum ar fi X-Skill setat la support. Aceasta ajunge în prompt ca {{sip_x_skill}}. Sipputheader acceptă User-to-User, orice antet X- și majoritatea antetelor P-; 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 de ContactID.
  • Antetul Authorization: Bearer sk_live_….
  • Citiți handoff.summary și handoff.intent din 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 final 2xx, deci nimic din BYE al agentului nu ajunge la script.
  • NICE nu documentează acceptarea unui REFER de 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.