ThunderPhone v3 je venku.Spustíte sami, od 2 ¢/min.Přečíst oznámení

Contact centers

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 /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í):

{"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.

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.