Open in
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/16nebo menší (IPv6/48nebo 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é jakoexternal_call_idhovoru. 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.summaryahandoff.intentsmě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.