---
title: "Připojení z NICE CXone"
description: "Odesílejte hovory z NICE CXone hlasovému agentovi ThunderPhone ze skriptu Studio s ContactID v hlavičce SIP a při pokračování skriptu vyhledejte předání agenta."
---

Váš skript CXone Studio uskuteční hovor s agentem pomocí hlaviček SIP, které nesou ID kontaktu a veškerý další kontext. Když agent skončí, zavěsí a akce REST API ve skriptu načte předání.

## Než začnete

- Agent ThunderPhone a [klíč API](/cs/guides/api-keys) organizace.
- Skupina trunků SIP v CXone, která přijímá vlastní hlavičky. Váš zástupce účtu NICE musí toto nastavení zapnout, než je CXone odešle.

## 1. Vytvořte koncový bod SIP

Placecall vytáčí telefonní číslo přes skupinu trunků CXone, nikoli adresu SIP.
NICE pro něj nedokumentuje přihlašovací údaje SIP a integrace CXone jiného poskytovatele AI používá TLS se seznamem povolených IP adres. Vytvořte proto koncový bod `ip_allowlist` s číslem, které bude skript vytáčet, jako číslem pro příchozí volání (viz
[Platformy, které vytáčejí telefonní číslo](/cs/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`: rozsahy signalizace SIP vašeho clusteru CXone od NICE. Každý musí být veřejný rozsah IPv4 o velikosti `/16` nebo menší (IPv6 `/48` nebo menší).
- `dial_in_numbers`: číslo, které Placecall vytočí, zapsané způsobem, jakým ho CXone odesílá. Nemusí jít o skutečné telefonní číslo. Nesmí se již používat v ThunderPhone jako telefonní číslo ani v jiném koncovém bodě: v takovém případě se vrátí `409`.

Adresy CXone jsou sdílené všemi jeho zákazníky, takže jakýkoli jiný zákazník CXone, který vytočí toto číslo, se spojí s vaším agentem. Při volbě čísla zvolte dlouhé číslo, které nikdo neuhodne (až 15 číslic), ujistěte se, že ho CXone odešle do ThunderPhone namísto do telefonní sítě, a nezveřejňujte ho.

## 2. Odesílejte hovory s kontextem

Ve skriptu Studio před akcí **Placecall**:

1. Přidejte akci **Sipputheader** s hlavičkou `X-Call-ID` a hodnotou `ContactID`. CXone neodesílá vlastní hlavičku ID hovoru; ThunderPhone tuto hlavičku uloží jako `external_call_id` hovoru.
2. Přidejte akci **Sipputheader** pro každou další hodnotu, kterou by měl agent znát, například `X-Skill` nastavenou na `support`. Do promptu se dostane jako `{{sip_x_skill}}`. Sipputheader přijímá `User-to-User`, libovolnou hlavičku `X-` a většinu hlaviček `P-`; NICE doporučuje hodnoty o délce nejvýše 256 znaků.

Poté proveďte **Placecall** na toto číslo přes skupinu trunků, která ho odešle na
`sip.thunderphone.com` s číslem v identifikátoru URI požadavku i v hlavičce `To`.
Koncový bod přijímá TLS (port 5061) nebo TCP (port 5060) a odmítá
UDP; NICE transport trunku nedokumentuje, proto se ujistěte, že nejde o
UDP.

## 3. Převezměte hovor zpět

CXone čte hlavičky SIP pouze v požadavku `INVITE` a jeho konečné odpovědi, takže agent hovor vrátí: rozloučí se a zavěsí a váš skript volajícího znovu převezme. Přidejte toto číslo pro přesměrování (viz
[Přidání čísla pro přesměrování](/cs/guides/contact-centers/overview)):

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

NICE nedokumentuje, že skript pokračuje po akci Placecall, když uskutečněný hovor skončí. Integrace CXone jiných poskytovatelů AI místo toho signalizují skriptu prostřednictvím rozhraní Signal API CXone (`POST /interactions/{contactId}/signal`) před zavěšením; ThunderPhone ho nevolá. Ověřte si u NICE, jak váš skript převezme volajícího zpět, a potom načtěte předání akcí **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  následované hodnotou `ContactID`.
- Hlavička `Authorization: Bearer sk_live_…`.
- Z odpovědi načtěte `handoff.summary` a `handoff.intent`, abyste kontakt správně směrovali.

Viz [Vyhledání předaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolejte na číslo, které spouští skript, požádejte agenta o spojení s osobou a ověřte,
že skript pokračuje a akce REST API vrátí předání. Pokud hovor nikdy nedorazí k agentovi, zkontrolujte číslo, které CXone odesílá, zda je jeho zdrojová adresa
v `allowed_source_cidrs` a zda hovor přišel přes TCP nebo TLS. Poté otevřete
hovor pomocí `GET /v1/calls/{call_id}`: `sip_headers` by mělo obsahovat `x-call-id` a
`external_call_id` by se mělo rovnat `ContactID`.

## Omezení

- CXone odesílá a čte hlavičky pouze při `INVITE` a jeho konečné odpovědi `2xx`, takže
  nic z agentova `BYE` nedorazí ke skriptu.
- NICE nedokumentuje přijímání `REFER` od agenta.
- Akce REST API ve výchozím nastavení vyprší po 10 sekundách (maximálně pod 90 sekundami)
  a čte odpovědi až do 32 KB.
