Open in
Forbind fra NICE CXone
Send NICE CXone-opkald til en ThunderPhone-agent fra et Studio-script med ContactID i en SIP-header, og slå agentens viderestilling op, når scriptet fortsætter.
Dit CXone Studio-script placerer et opkald til agenten med SIP-headere, der indeholder kontakt-id'et og enhver anden kontekst. Når agenten er færdig, lægger den på, og en REST API-handling i scriptet henter overdragelsen.
Før du starter
- En ThunderPhone-agent og en organisations-API-nøgle.
- En CXone SIP-trunkgruppe, der accepterer brugerdefinerede headere. Din NICE-konto- repræsentant skal aktivere denne indstilling, før CXone sender dem.
1. Opret SIP-slutpunktet
Placecall ringer et telefonnummer op via en CXone-trunkgruppe, ikke en SIP-adresse.
NICE dokumenterer ikke SIP-legitimationsoplysninger til den, og en anden AI-udbyders
CXone-integration bruger TLS med en IP-tilladelsesliste. Opret derfor et
ip_allowlist-slutpunkt med det nummer, scriptet vil ringe op, som et
indgående opkaldsnummer (se
Platforme, der ringer et telefonnummer op):
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: SIP-signaleringsområderne for din CXone-klynge, fra NICE. Hvert område skal være et offentligt IPv4-område på/16eller smallere (IPv6/48eller smallere).dial_in_numbers: nummeret, som Placecall ringer op, skrevet på den måde, CXone sender det på. Det behøver ikke være et rigtigt telefonnummer. Det må ikke allerede være i brug på ThunderPhone, hverken som telefonnummer eller på et andet slutpunkt: det returnerer409.
CXones adresser deles af alle deres kunder, så enhver anden CXone-kunde, der ringer nummeret op, når din agent. Når du vælger nummeret, skal du vælge et langt nummer, som ingen ville gætte (op til 15 cifre), sikre, at CXone sender det til ThunderPhone i stedet for ud på telefonnettet, og ikke offentliggøre det.
2. Send opkald med kontekst
I dit Studio-script, før Placecall:
- Tilføj en Sipputheader-handling med headeren
X-Call-IDog værdienContactID. CXone sender ikke selv en call-id-header; ThunderPhone gemmer denne som opkaldetsexternal_call_id. - Tilføj en Sipputheader-handling for hver anden værdi, agenten skal kende,
f.eks.
X-Skillsat tilsupport. Den når prompten som{{sip_x_skill}}. Sipputheader acceptererUser-to-User, enhverX--header og de flesteP--headere; NICE anbefaler værdier på højst 256 tegn.
Brug derefter Placecall til det nummer via en trunkgruppe, der sender det til
sip.thunderphone.com med nummeret i både request-URI'en og To-headeren.
Slutpunktet accepterer TLS (port 5061) eller TCP (port 5060) og afviser UDP,
og NICE dokumenterer ikke trunkgruppens transport, så sørg for, at den ikke er
UDP.
3. Få opkaldet tilbage
CXone læser kun SIP-headere på INVITE og dets endelige svar, så agenten
returnerer opkaldet: den siger farvel og lægger på, og dit script overtager
opkalderen igen. Tilføj dette overførselsnummer (se
Tilføj overførselsnummeret):
{"name": "NICE CXone", "action": "return"}NICE dokumenterer ikke, at et script fortsætter efter Placecall, når det
placerede opkald slutter. Andre AI-udbyderes CXone-integrationer signalerer
i stedet scriptet via CXones Signal API (POST /interactions/{contactId}/signal),
før de lægger på; ThunderPhone kalder det ikke. Bekræft med NICE, hvordan dit
script overtager opkalderen igen, og hent derefter overdragelsen med en
REST API-handling:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=efterfulgt afContactID.- Headeren
Authorization: Bearer sk_live_…. - Læs
handoff.summaryoghandoff.intentfra svaret for at dirigere kontakten.
Se Slå et overdraget opkald op.
Test det
Ring til et nummer, der kører scriptet, bed agenten om en person, og kontrollér, at
scriptet fortsætter, og at REST API-handlingen returnerer overdragelsen. Hvis opkaldet
aldrig når agenten, skal du kontrollere det nummer, CXone sender, at dets kildeadresse
er i allowed_source_cidrs, og at opkaldet kom over TCP eller TLS. Åbn derefter
opkaldet med GET /v1/calls/{call_id}: sip_headers bør indeholde x-call-id, og
external_call_id bør være lig med ContactID.
Begrænsninger
- CXone sender og læser kun headere på
INVITEog dets endelige2xx, så intet på agentensBYEnår scriptet. - NICE dokumenterer ikke, at det accepterer en
REFERfra agenten. - REST API-handlingen får som standard timeout efter 10 sekunder (højst under 90 sekunder) og læser svar på op til 32 KB.