---
title: "Zoom Contact Center에서 연결"
description: "타사 음성 봇 커넥터를 사용하여 Zoom Contact Center 통화를 ThunderPhone 에이전트로 전송하고, SIP REFER를 통해 다시 사람 에이전트에게 연결합니다."
---

Zoom Contact Center 플로우의 Bot 위젯은 Zoom의 call sid와 함께 발신자를 에이전트로 연결합니다. 발신자에게 사람이 필요하면 에이전트는 Zoom의 사람 에이전트 주소로 SIP `REFER`를 보내고, 플로우는 call sid로 인계를 가져옵니다.

## 시작하기 전에

- ThunderPhone 에이전트와 조직 [API 키](/ko/guides/api-keys).
- 관리자가 관리하고 Contact Center에서 사용할 수 있도록 설정한 Zoom Marketplace **일반 앱**과 Bot 위젯용 커넥터
  ([Zoom의 타사 음성 봇 가이드](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Zoom에서 봇 제공업체로 연결되는 SIP 트렁크. Zoom의 ISV 팀이 단계적으로 구축합니다(사전 검토, 스테이징 트렁크, 이후 프로덕션). 앱의 회사 이름은 트렁크 레코드와 정확히 일치해야 합니다. 이 설정은 Zoom 계정에서만 시작하는 것이 아니라 ThunderPhone 지원팀 및 Zoom과 함께 시작합니다.

## 1. SIP 엔드포인트 만들기

Zoom의 커넥터는 SIP 주소가 아니라 `999`로 시작하는 15자리 번호로 전화를 겁니다. 커넥터를 저장하면 이 번호가 생성됩니다. Zoom의 트렁크는 포트 5061에서 TLS 1.2와 오디오용 SRTP를 사용하며, 비밀번호 대신 Zoom의 서브넷으로 허용 목록을 적용합니다. 따라서 커넥터 번호를 다이얼인 번호로 사용하고 SRTP를 필수로 설정한 `ip_allowlist` 엔드포인트를 만드세요([전화번호로 전화를 거는 플랫폼](/ko/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`: Zoom에서 제공하는 Zoom SIP 시그널링 서브넷입니다. 각 항목은 `/16` 또는 그보다 좁은 공용 IPv4 범위여야 합니다(IPv6는 `/48` 또는 그보다 좁아야 함).
- `dial_in_numbers`: `+` 없이 Zoom이 전송하는 커넥터 번호 그대로입니다.
- `srtp`: Zoom의 트렁크는 항상 SRTP를 사용하므로 `required`로 설정합니다.

Zoom의 주소는 모든 고객이 공유하므로 다른 Zoom 고객이 이 번호로 전화를 걸어도 에이전트에 연결됩니다. Zoom이 번호를 할당하므로 공개하지 마세요.

## 2. 컨텍스트와 함께 통화 전송하기

플로우에 **Bot** 위젯을 추가하고 커넥터에 연결하세요. Zoom의 ISV 팀에 트렁크가 포트 5061의 TLS를 사용하여 `sip.thunderphone.com`을 가리키도록 요청하고, 요청 URI와 `To` 헤더 모두에 커넥터 번호를 포함하도록 하세요. 엔드포인트는 UDP를 거부하므로 트렁크가 UDP로 대체되지 않도록 하세요.

Zoom은 다음을 전송합니다.

- 통화의 `external_call_id`로 저장되는 `X-ZOOM-Call-Sid`. Zoom 자체 데이터 매핑 페이지에는 이 항목이 나열되어 있지 않지만, 다른 AI 제공업체의 Zoom 통합 문서에는 설명되어 있습니다. 따라서 첫 번째 테스트 통화에서 확인하세요.
- 발신자가 건 번호인 `X-ZOOM-DNIS`는 `{{sip_x_zoom_dnis}}`로 제공됩니다.
- 커넥터의 Static URL인 `X-ZOOM-WEBHOOK`.

## 3. 통화 정보 다시 가져오기

에이전트가 Zoom의 SBC에 있는 사람 에이전트 주소로 `REFER`를 전송합니다. Zoom에서 제공한 SBC 주소와 함께 이 전환 번호를 추가합니다([전환 번호 추가](/ko/guides/contact-centers/overview) 참고).

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

Zoom 가이드에서는 봇이 컨텍스트를 전달하는 두 가지 방법을 설명합니다. `REFER` 전에 커넥터의 정적 URL로 전송하는 `POST`(`voicebot_metadata` 및 유사 이벤트)와 **봇에서 수신** 아래에 매핑된 SIP 헤더입니다. ThunderPhone은 정적 URL로 전송하지 않습니다. Zoom 가이드에서는 `REFER`에서 매핑된 헤더를 읽는지 명시하지 않습니다. 시도하려면 항목에 `"X-Handoff-Id": "{{handoff_id}}"` 같은 `headers`를 추가하고 테스트 통화에서 확인합니다. 또한 Zoom에 메타데이터 `POST` 없이 `REFER`를 수락하는지 확인합니다.

두 방법 모두에 의존하지 않고 인계를 받으려면 봇 위젯 다음에 **HTTP Call** 또는 **Script** 위젯을 사용하여 플로에서 조회하도록 설정합니다.

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  뒤에 통화 SID를 추가합니다.
- 헤더 `Authorization: Bearer sk_live_…`.
- `handoff.summary` 및 `handoff.intent`를 사용하여 발신자를 라우팅하고 통화를 받는 사람에게 정보를 전달합니다.

Zoom은 이러한 위젯에 대한 필드 수준 문서를 제공하지 않으므로, 계정에서 위젯이 `Authorization` 헤더를 전송할 수 있는지 확인합니다. [인계된 통화 조회](/api-reference/calls#look-up-a-handed-off-call)를 참고합니다.

## 테스트

봇 위젯에 연결되는 번호로 전화를 걸고 에이전트에게 사람 연결을 요청한 다음, 발신자가 사람 에이전트에게 연결되고 위젯이 인계 정보를 반환하는지 확인합니다. 그런 다음 `GET /v1/calls/{call_id}`로 통화를 엽니다. `sip_headers`에 `x-zoom-call-sid`가 표시되어야 하며, `external_call_id`는 플로에서 사용하는 통화 SID와 일치해야 합니다.

## 제한 사항

- ThunderPhone은 커넥터의 정적 URL로 전송하지 않으므로, Zoom은 조회를 통해 또는 테스트 결과 Zoom이 `REFER`에서 이를 읽는 것으로 확인된 경우 매핑된 헤더를 통해 인계 정보를 받습니다.
- 트렁크는 Zoom의 ISV 팀에서 구축하므로 직접 설정하거나 테스트할 수 없습니다.
