---
title: "Připojení ze Zoom Contact Center"
description: "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](/cs/guides/api-keys).
- **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](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- 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](/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": "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í](/cs/guides/contact-centers/overview))
s adresou SBC, kterou vám poskytne Zoom:

```json
{"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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
