Open in
Připojení z NICE CXone
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 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):
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/16nebo menší (IPv6/48nebo 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:
- Přidejte akci Sipputheader s hlavičkou
X-Call-IDa hodnotouContactID. CXone neodesílá vlastní hlavičku ID hovoru; ThunderPhone tuto hlavičku uloží jakoexternal_call_idhovoru. - Přidejte akci Sipputheader pro každou další hodnotu, kterou by měl agent znát, například
X-Skillnastavenou nasupport. Do promptu se dostane jako{{sip_x_skill}}. Sipputheader přijímáUser-to-User, libovolnou hlavičkuX-a většinu hlavičekP-; 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í):
{"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é hodnotouContactID.- Hlavička
Authorization: Bearer sk_live_…. - Z odpovědi načtěte
handoff.summaryahandoff.intent, abyste kontakt správně směrovali.
Viz Vyhledání předaného hovoru.
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
INVITEa jeho konečné odpovědi2xx, takže nic z agentovaBYEnedorazí ke skriptu. - NICE nedokumentuje přijímání
REFERod 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.