ThunderPhone v3 er live.Selvbetjening fra 2 cent pr. minut.Læs mere om lanceringen

Contact centers

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å /16 eller smallere (IPv6 /48 eller 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 returnerer 409.

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:

  1. Tilføj en Sipputheader-handling med headeren X-Call-ID og værdien ContactID. CXone sender ikke selv en call-id-header; ThunderPhone gemmer denne som opkaldets external_call_id.
  2. Tilføj en Sipputheader-handling for hver anden værdi, agenten skal kende, f.eks. X-Skill sat til support. Den når prompten som {{sip_x_skill}}. Sipputheader accepterer User-to-User, enhver X--header og de fleste P--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 af ContactID.
  • Headeren Authorization: Bearer sk_live_….
  • Læs handoff.summary og handoff.intent fra 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å INVITE og dets endelige 2xx, så intet på agentens BYE når scriptet.
  • NICE dokumenterer ikke, at det accepterer en REFER fra 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.