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

Contact centers

Připojení ze Zoom Contact Center

Směrujte hovory ze Zoom Contact Center k agentovi ThunderPhone pomocí konektoru hlasového bota třetí strany a pomocí SIP REFER je předejte zpět lidskému agentovi.

Widget Bot ve vašem toku Zoom Contact Center odešle volajícího k agentovi s ID hovoru ze Zoomu. Když volající potřebuje člověka, agent odešle SIP REFER na adresu lidského agenta ve Zoomu a váš tok načte předání podle ID hovoru.

Než začnete

  • Agent ThunderPhone a organizační klíč API.
  • General App ze Zoom Marketplace, spravovaná vaším administrátorem a zpřístupněná pro Contact Center, s konektorem pro widget Bot (průvodce Zoomu pro hlasové boty třetích stran).
  • SIP trunk ze Zoomu k poskytovateli bota. Tým ISV Zoomu jej vytváří po etapách (zjištění požadavků, testovací trunk a následně produkční) a název společnosti aplikace musí přesně odpovídat záznamu trunku. Toto nastavení začíná s podporou ThunderPhone a Zoomem, nikoli pouze ve vašem účtu Zoom.

1. Vytvořte koncový bod SIP

Konektor Zoomu vytáčí 15místné číslo začínající na 999, nikoli adresu SIP. Uložením konektoru se toto číslo vygeneruje. Trunk Zoomu používá TLS 1.2 na portu 5061 se SRTP pro zvuk a je povolen podle podsítí Zoomu namísto hesla. Vytvořte proto koncový bod ip_allowlist s číslem konektoru jako číslem pro příchozí volání a s povinným SRTP (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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: podsítě signalizace SIP Zoomu, které poskytne Zoom. Každá musí být veřejný rozsah IPv4 o velikosti /16 nebo menší (IPv6 /48 nebo menší).
  • dial_in_numbers: číslo konektoru přesně ve formě, v jaké jej Zoom odesílá, bez znaku +.
  • srtp: required, protože trunk Zoomu vždy používá SRTP.

Adresy Zoomu jsou sdílené všemi jeho zákazníky, takže každý jiný zákazník Zoomu, který toto číslo vytočí, se spojí s vaším agentem. Číslo přiděluje Zoom; nezveřejňujte ho.

2. Odesílejte hovory s kontextem

Přidejte do svého toku widget Bot a propojte jej s konektorem. Požádejte tým ISV Zoomu, aby trunk nasměroval na sip.thunderphone.com, s TLS na portu 5061 a s číslem konektoru v URI požadavku i v hlavičce To. Koncový bod odmítá UDP, proto zajistěte, aby se na něj trunk nepřepnul.

Zoom odesílá:

  • X-ZOOM-Call-Sid, uložené jako external_call_id hovoru. Vlastní stránka Zoomu pro mapování dat jej neuvádí; dokumentuje jej integrace Zoomu jiného poskytovatele AI, proto jej ověřte při prvním testovacím hovoru.
  • X-ZOOM-DNIS, číslo, které volající vytočil, jako {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, statickou adresu URL konektoru.

3. Získejte hovor zpět

Agent odešle REFER na adresu lidského agenta na SBC služby Zoom. Přidejte toto číslo pro přepojení (viz Přidání čísla pro přepojení) s adresou SBC, kterou vám poskytne Zoom:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Průvodce Zoom popisuje dva způsoby, jak bot předává kontext: POST na statickou URL konektoru před REFER (události voicebot_metadata a podobné) a hlavičky SIP namapované v části Příchozí od bota. ThunderPhone neodesílá požadavky na statickou URL. Průvodce Zoom neuvádí, zda čte namapované hlavičky z REFER; pokud to chcete vyzkoušet, přidejte do položky headers, například "X-Handoff-Id": "{{handoff_id}}", a ověřte to při testovacím hovoru. Také si u Zoom ověřte, že přijímá REFER bez předchozího POST s metadaty.

Chcete-li získat předání bez spoléhání na kterýkoli z těchto způsobů, nechte ho tok vyhledat po widgetu Bot pomocí widgetu HTTP Call nebo Script:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= následovaný SID hovoru.
  • Hlavička Authorization: Bearer sk_live_….
  • Pomocí handoff.summary a handoff.intent směrujte volajícího a informujte osobu, která hovor převezme.

Zoom nezveřejňuje dokumentaci k polím těchto widgetů, proto si ve svém účtu ověřte, že widget dokáže odeslat hlavičku Authorization. Viz Vyhledání předaného hovoru.

Otestujte to

Zavolejte na číslo, které vede k widgetu Bot, požádejte agenta o spojení s osobou a ověřte, že se volající dostane k lidskému agentovi a widget vrátí údaje o předání. Poté otevřete hovor pomocí GET /v1/calls/{call_id}: sip_headers by mělo obsahovat x-zoom-call-sid a external_call_id by mělo odpovídat SID hovoru, které váš tok používá.

Omezení

  • ThunderPhone neodesílá požadavky na statickou URL konektoru, takže Zoom získá předání prostřednictvím vyhledání nebo prostřednictvím namapovaných hlaviček, pokud váš test ukáže, že je Zoom čte z REFER.
  • Trunk vytváří tým ISV společnosti Zoom, takže jej nemůžete sami nastavit ani otestovat.