---
title: "Połącz z Zoom Contact Center"
description: "Przekazuj połączenia Zoom Contact Center do agenta ThunderPhone za pomocą zewnętrznego łącznika voicebota, a następnie przekierowuj je z powrotem do agenta ludzkiego za pomocą SIP REFER."
---

Widżet Bot w przepływie Zoom Contact Center przekazuje rozmówcę do agenta wraz z
identyfikatorem sid połączenia Zoom. Gdy rozmówca potrzebuje człowieka, agent wysyła SIP `REFER`
na adres agenta ludzkiego Zoom, a przepływ pobiera przekazanie rozmowy według identyfikatora sid połączenia.

## Przed rozpoczęciem

- Agent ThunderPhone i organizacyjny [klucz API](/pl/guides/api-keys).
- **Aplikacja ogólna** Zoom Marketplace, zarządzana przez administratora i udostępniona
  dla Contact Center, z konektorem dla widżetu Bot
  ([przewodnik Zoom dotyczący zewnętrznego voicebota](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Łącze SIP z Zoom do dostawcy bota. Zespół ISV Zoom tworzy je etapami
  (rozpoznanie, łącze testowe, a następnie produkcyjne), a nazwa firmy aplikacji
  musi dokładnie odpowiadać wpisowi łącza. Ta konfiguracja rozpoczyna się ze wsparciem ThunderPhone
  i Zoom, a nie wyłącznie na koncie Zoom.

## 1. Utwórz punkt końcowy SIP

Konektor Zoom wybiera 15-cyfrowy numer rozpoczynający się od `999`, a nie adres SIP.
Zapisanie konektora generuje ten numer. Łącze Zoom używa TLS 1.2
na porcie 5061 z SRTP dla dźwięku i jest dopuszczane na podstawie podsieci Zoom, a nie hasła.
Dlatego utwórz punkt końcowy `ip_allowlist` z numerem konektora jako numerem dostępowym i wymaganym SRTP (zobacz
[Platformy wybierające numer telefonu](/pl/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`: podsieci sygnalizacji SIP Zoom, przekazane przez Zoom. Każda musi
  być publicznym zakresem IPv4 `/16` lub węższym (IPv6 `/48` lub węższym).
- `dial_in_numbers`: numer konektora dokładnie w formacie wysyłanym przez Zoom, bez
  `+`.
- `srtp`: `required`, ponieważ łącze Zoom zawsze używa SRTP.

Adresy Zoom są współdzielone przez wszystkich jego klientów, więc każdy inny klient Zoom,
który wybierze ten numer, połączy się z Twoim agentem. Zoom przypisuje ten numer; nie
publikuj go.

## 2. Wysyłaj połączenia z kontekstem

Dodaj widżet **Bot** do przepływu i powiąż go z konektorem. Poproś zespół ISV Zoom,
aby skierował łącze do `sip.thunderphone.com`, z TLS na porcie 5061 oraz numerem
konektora zarówno w URI żądania, jak i w nagłówku `To`. Punkt końcowy
odrzuca UDP, dlatego upewnij się, że łącze nie przełącza się na ten protokół awaryjnie.

Zoom wysyła:

- `X-ZOOM-Call-Sid`, zapisywany jako `external_call_id` połączenia. Strona Zoom dotycząca
  mapowania danych go nie wymienia; dokumentacja integracji Zoom innego dostawcy AI
  go opisuje, dlatego sprawdź go podczas pierwszego połączenia testowego.
- `X-ZOOM-DNIS`, numer wybrany przez rozmówcę, jako `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, statyczny adres URL konektora.

## 3. Odbierz połączenie zwrotne

Agent wysyła `REFER` na adres ludzkiego agenta w SBC Zoom. Dodaj ten
numer przekierowania (zobacz
[Dodaj numer przekierowania](/pl/guides/contact-centers/overview)),
wraz z adresem SBC podanym przez Zoom:

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

Przewodnik Zoom opisuje dwa sposoby przekazywania kontekstu przez bota: `POST` do
statycznego adresu URL konektora przed `REFER` (zdarzenia `voicebot_metadata` i
podobne) oraz nagłówki SIP mapowane w sekcji **Przychodzące od bota**. ThunderPhone
nie wysyła żądań do statycznego adresu URL. Przewodnik Zoom nie określa, czy odczytuje
mapowane nagłówki z `REFER`; jeśli chcesz to sprawdzić, dodaj do wpisu `headers`, takie jak
`"X-Handoff-Id": "{{handoff_id}}"`, i sprawdź podczas połączenia testowego. Potwierdź też
z Zoom, że akceptuje `REFER` bez poprzedzającego go `POST` z metadanymi.

Aby uzyskać przekazanie bez polegania na żadnym z tych sposobów, skonfiguruj przepływ
tak, aby wyszukiwał je po widżecie Bot, używając widżetu **Wywołanie HTTP** lub
**Skrypt**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  po którym następuje SID połączenia.
- Nagłówek `Authorization: Bearer sk_live_…`.
- Użyj `handoff.summary` i `handoff.intent`, aby skierować rozmówcę i przekazać
  informacje osobie odbierającej połączenie.

Zoom nie publikuje dokumentacji na poziomie pól dla tych widżetów, dlatego potwierdź
na swoim koncie, że widżet może wysłać nagłówek `Authorization`. Zobacz
[Wyszukaj przekazane połączenie](/api-reference/calls#look-up-a-handed-off-call).

## Przetestuj

Zadzwoń na numer, który prowadzi do widżetu Bot, poproś agenta o połączenie z osobą i sprawdź,
czy rozmówca trafia do ludzkiego agenta, a widżet zwraca przekazanie. Następnie
otwórz połączenie za pomocą `GET /v1/calls/{call_id}`: `sip_headers` powinno zawierać
`x-zoom-call-sid`, a `external_call_id` powinno odpowiadać SID połączenia używanemu przez przepływ.

## Ograniczenia

- ThunderPhone nie wysyła żądań do statycznego adresu URL konektora, więc Zoom otrzymuje
  przekazanie przez wyszukiwanie lub przez mapowane nagłówki, jeśli test wykaże, że
  Zoom odczytuje je z `REFER`.
- Łącze trunk jest tworzone przez zespół ISV Zoom, więc nie możesz samodzielnie go
  skonfigurować ani przetestować.
