---
title: "Forbind fra NICE CXone"
description: "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](/da/guides/api-keys).
- 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](/da/guides/sip-addresses)):

```bash
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](/da/guides/contact-centers/overview)):

```json
{"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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
