Open in
Zoom Contact Center에서 연결
타사 음성 봇 커넥터를 사용하여 Zoom Contact Center 통화를 ThunderPhone 에이전트로 전송하고, SIP REFER를 통해 다시 사람 에이전트에게 연결합니다.
Zoom Contact Center 플로우의 Bot 위젯은 Zoom의 call sid와 함께 발신자를 에이전트로 연결합니다. 발신자에게 사람이 필요하면 에이전트는 Zoom의 사람 에이전트 주소로 SIP REFER를 보내고, 플로우는 call sid로 인계를 가져옵니다.
시작하기 전에
- ThunderPhone 에이전트와 조직 API 키.
- 관리자가 관리하고 Contact Center에서 사용할 수 있도록 설정한 Zoom Marketplace 일반 앱과 Bot 위젯용 커넥터 (Zoom의 타사 음성 봇 가이드).
- Zoom에서 봇 제공업체로 연결되는 SIP 트렁크. Zoom의 ISV 팀이 단계적으로 구축합니다(사전 검토, 스테이징 트렁크, 이후 프로덕션). 앱의 회사 이름은 트렁크 레코드와 정확히 일치해야 합니다. 이 설정은 Zoom 계정에서만 시작하는 것이 아니라 ThunderPhone 지원팀 및 Zoom과 함께 시작합니다.
1. SIP 엔드포인트 만들기
Zoom의 커넥터는 SIP 주소가 아니라 999로 시작하는 15자리 번호로 전화를 겁니다. 커넥터를 저장하면 이 번호가 생성됩니다. Zoom의 트렁크는 포트 5061에서 TLS 1.2와 오디오용 SRTP를 사용하며, 비밀번호 대신 Zoom의 서브넷으로 허용 목록을 적용합니다. 따라서 커넥터 번호를 다이얼인 번호로 사용하고 SRTP를 필수로 설정한 ip_allowlist 엔드포인트를 만드세요(전화번호로 전화를 거는 플랫폼 참조).
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 주소와 함께 이 전환 번호를 추가합니다(전환 번호 추가 참고).
{"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 헤더를 전송할 수 있는지 확인합니다. 인계된 통화 조회를 참고합니다.
테스트
봇 위젯에 연결되는 번호로 전화를 걸고 에이전트에게 사람 연결을 요청한 다음, 발신자가 사람 에이전트에게 연결되고 위젯이 인계 정보를 반환하는지 확인합니다. 그런 다음 GET /v1/calls/{call_id}로 통화를 엽니다. sip_headers에 x-zoom-call-sid가 표시되어야 하며, external_call_id는 플로에서 사용하는 통화 SID와 일치해야 합니다.
제한 사항
- ThunderPhone은 커넥터의 정적 URL로 전송하지 않으므로, Zoom은 조회를 통해 또는 테스트 결과 Zoom이
REFER에서 이를 읽는 것으로 확인된 경우 매핑된 헤더를 통해 인계 정보를 받습니다. - 트렁크는 Zoom의 ISV 팀에서 구축하므로 직접 설정하거나 테스트할 수 없습니다.