ThunderPhone v3 ir klāt.Sāciet patstāvīgi — no 2 ¢/min.Lasīt paziņojumu

Contact centers

Savienošana no NICE CXone

Nosūtiet NICE CXone zvanus uz ThunderPhone balss aģentu no Studio skripta, izmantojot ContactID SIP galvenē, un sameklējiet aģenta pāradresēšanu, kad skripts turpinās.

Jūsu CXone Studio skripts veic zvanu balss aģentam ar SIP galvenēm, kurās ir kontakta ID un jebkāds cits konteksts. Kad balss aģents ir pabeidzis darbu, tas noliek klausuli, un REST API darbība skriptā iegūst nodošanas datus.

Pirms darba sākšanas

  • ThunderPhone aģents un organizācijas API atslēga.
  • CXone SIP maģistrāļu grupa, kas pieņem pielāgotas galvenes. Jūsu NICE konta pārstāvim šis iestatījums ir jāiespējo, pirms CXone tās nosūta.

1. Izveidojiet SIP galapunktu

Placecall zvana uz tālruņa numuru, izmantojot CXone maģistrāļu grupu, nevis uz SIP adresi. NICE tam nedokumentē SIP akreditācijas datus, un cita MI nodrošinātāja CXone integrācija izmanto TLS ar IP atļauju sarakstu. Tāpēc izveidojiet ip_allowlist galapunktu ar numuru, uz kuru skripts zvanīs, kā ienākošo zvanu numuru (skatiet Platformas, kas zvana uz tālruņa numuru):

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: jūsu CXone klastera SIP signalizācijas diapazoni, ko nodrošina NICE. Katram jābūt publiskam IPv4 diapazonam /16 vai šaurākam (IPv6 /48 vai šaurākam).
  • dial_in_numbers: numurs, uz kuru Placecall zvanīs, rakstīts tā, kā to nosūta CXone. Tam nav jābūt reālam tālruņa numuram. To nedrīkst jau izmantot ThunderPhone kā tālruņa numuru vai citā galapunktā: pretējā gadījumā tiek atgriezts 409.

CXone adreses ir koplietotas visiem tā klientiem, tāpēc jebkurš cits CXone klients, kas zvana uz šo numuru, sasniedz jūsu balss aģentu. Vietā, kur izvēlaties numuru, izvēlieties garu numuru, ko neviens neuzminētu (līdz 15 cipariem), pārliecinieties, ka CXone to nosūta uz ThunderPhone, nevis uz tālruņu tīklu, un nepublicējiet to.

2. Sūtiet zvanus ar kontekstu

Savā Studio skriptā pirms Placecall:

  1. Pievienojiet Sipputheader darbību ar galveni X-Call-ID un vērtību ContactID. CXone nesūta savu zvana ID galveni; ThunderPhone šo galveni saglabā kā zvana external_call_id.
  2. Pievienojiet Sipputheader darbību katrai citai vērtībai, kas balss aģentam jāzina, piemēram, X-Skill ar vērtību support. Tā sasniedz uzvedni kā {{sip_x_skill}}. Sipputheader pieņem User-to-User, jebkuru X- galveni un lielāko daļu P- galveņu; NICE iesaka vērtības ar 256 vai mazāk rakstzīmēm.

Pēc tam veiciet Placecall uz šo numuru, izmantojot maģistrāļu grupu, kas to nosūta uz sip.thunderphone.com ar numuru gan pieprasījuma URI, gan To galvenē. Galapunkts pieņem TLS (ports 5061) vai TCP (ports 5060) un noraida UDP, bet NICE nedokumentē maģistrāles transportu, tāpēc pārliecinieties, ka tas nav UDP.

3. Saņemiet zvanu atpakaļ

CXone nolasa SIP galvenes tikai INVITE un tā gala atbildē, tāpēc balss aģents atgriež zvanu: tas atvadās un noliek klausuli, un jūsu skripts atkal pārņem zvanītāju. Pievienojiet šo pārsūtīšanas numuru (skatiet Pievienojiet pārsūtīšanas numuru):

{"name": "NICE CXone", "action": "return"}

NICE nedokumentē, ka skripts turpinās pēc Placecall, kad veiktais zvans beidzas. Citu MI nodrošinātāju CXone integrācijas tā vietā signalizē skriptam, izmantojot CXone Signal API (POST /interactions/{contactId}/signal), pirms tās noliek klausuli; ThunderPhone to neizsauc. Apstipriniet ar NICE, kā jūsu skripts atkal pārņem zvanītāju, pēc tam iegūstiet nodošanas datus ar REST API darbību:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= kam seko ContactID.
  • Galvene Authorization: Bearer sk_live_….
  • Nolasiet atbildes handoff.summary un handoff.intent, lai maršrutētu kontaktu.

Skatiet Nodota zvana uzmeklēšana.

Pārbaudiet

Piezvaniet uz numuru, kurā darbojas skripts, palūdziet aģentam savienot ar personu un pārbaudiet, vai skripts turpinās un REST API darbība atgriež pāradresāciju. Ja zvans nekad nenonāk līdz aģentam, pārbaudiet numuru, ko CXone nosūta, vai tā avota adrese ir allowed_source_cidrs un vai zvans tika veikts, izmantojot TCP vai TLS. Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}: sip_headers jānorāda x-call-id, un external_call_id jābūt vienādam ar ContactID.

Ierobežojumi

  • CXone nosūta un nolasa galvenes tikai INVITE un tā galīgajā 2xx, tāpēc nekas no aģenta BYE nenonāk līdz skriptam.
  • NICE nedokumentē REFER pieņemšanu no aģenta.
  • REST API darbībai pēc noklusējuma iestājas taimauts pēc 10 sekundēm (ne vairāk kā 90 sekundēs) un tā nolasa atbildes līdz 32 KB.