---
title: "컨택 센터"
description: "Amazon Connect, Five9, Genesys Cloud, Talkdesk, Twilio, Microsoft Dynamics 365, NICE CXone 또는 Zoom Contact Center의 통화를 SIP를 통해 ThunderPhone 에이전트로 전송하고, 에이전트의 통화 이관으로 다시 연결합니다."
---

ThunderPhone 에이전트는 컨택 센터의 통화 흐름 내에서 전화를 받을 수 있습니다.
플랫폼은 자체 통화 ID와 발신자에 대해 알고 있는 기타 정보를 담은 SIP 헤더와 함께
에이전트의 [SIP 주소](/ko/guides/sip-addresses)로 통화를 전송합니다. 발신자에게 사람이 필요한 경우,
에이전트는 핸드오프와 함께 통화를 다시 전달합니다. 핸드오프에는 발신자에게 필요한 사항의 요약, 짧은 의도 레이블 및
통화 흐름에서 조회할 수 있는 ID가 포함됩니다.

## 플랫폼

| 플랫폼 | 통화 수신 방식 | 통화 ID 헤더 | 통화 복귀 방식 | 컨텍스트 복귀 방식 |
|---|---|---|---|---|
| [Amazon Connect](/ko/guides/contact-centers/amazon-connect) | 외부 음성 전환 커넥터; IP 허용 목록 | `X-Amzn-ConnectContactId` | 복귀: 에이전트가 전화를 끊고 흐름이 재개됨 | Lambda가 핸드오프 조회를 호출 |
| [Five9](/ko/guides/contact-centers/five9) | Five9에서 설정한 다이얼인 번호용 AI Agent Connect; IP 허용 목록 | `X-CallID` | 복귀: 에이전트가 `BYE`의 라우팅 헤더와 함께 전화를 끊음 | `X-Route*` 및 `X-CustomMetaData` 헤더를 IVR 통화 변수로 전달 |
| [Genesys Cloud](/ko/guides/contact-centers/genesys-cloud) | BYOC Cloud 트렁크; 다이제스트 | `x-inin-cnv` | 되돌리기 및 전환에서 수락되는 `REFER` | 전환 주소 내 16진수 UUI, 이후 데이터 작업 |
| [Talkdesk](/ko/guides/contact-centers/talkdesk) | Autopilot Voice에 연결; IP 허용 목록 | `X-Talkdesk-Interaction-Id` | Talkdesk의 에스컬레이션 주소로 `REFER` | 전환 주소 내 16진수 UUI, 이후 작업 실행 |
| [Twilio](/ko/guides/contact-centers/twilio) | `<Dial><Sip>`; 다이제스트 | 직접 추가하는 `X-Call-ID` | `referUrl` 핸들러로 `REFER` | 전환 주소 내 헤더(`ReferTransferTarget`) |
| [Microsoft Dynamics 365](/ko/guides/contact-centers/microsoft-dynamics-365) | SBC를 통한 전화번호 전환; 다이제스트 | 직접 추가하는 `X-Call-ID` | 복귀 후 SBC가 발신자를 다시 라우팅 | HTTP Request 노드가 핸드오프 조회를 호출 |
| [NICE CXone](/ko/guides/contact-centers/nice-cxone) | 다이얼인 번호로 `Sipputheader`를 사용하는 Studio `Placecall`; IP 허용 목록 | 직접 추가하는 `X-Call-ID` | 복귀: 에이전트가 전화를 끊음(NICE에 스크립트가 발신자를 복귀시키는 방식을 확인) | REST API 작업이 핸드오프 조회를 호출 |
| [Zoom Contact Center](/ko/guides/contact-centers/zoom-contact-center) | Zoom이 구축한 트렁크의 다이얼인 번호용 봇 위젯; SRTP를 사용하는 IP 허용 목록 | `X-ZOOM-Call-Sid` | Zoom의 사람 담당자 주소로 `REFER` | HTTP Call 위젯이 핸드오프 조회를 호출 |

## 작동 방식

1. **에이전트용 SIP 엔드포인트를 생성합니다.** API를 사용하거나, 앱의 **전화 및 웹**
   → **SIP 엔드포인트**에서 생성하거나, Zeus에게 요청합니다. 비밀번호 챌린지에 응답할 수 있는
   플랫폼은 엔드포인트의 사용자 이름과 비밀번호를 사용합니다. 소스 주소로만 자신을 식별하는
   플랫폼은 `auth`를 `ip_allowlist`로 설정한 엔드포인트를 사용합니다. 자세한 내용은
   [소스 IP로 인증하는 플랫폼](/ko/guides/sip-addresses)을 참조합니다.
   SIP 주소 대신 전화번호로 발신하는 플랫폼은 해당 엔드포인트의
   [수신 번호](/ko/guides/sip-addresses)를 통해 엔드포인트에 연결합니다.
2. **컨텍스트와 함께 통화를 전송합니다.** 플랫폼은 엔드포인트의 `sip_uri` 또는
   수신 번호로 발신합니다.
   플랫폼이 전송하는 모든 `X-` 헤더와 `User-to-User`는 프롬프트에서 사용할 수 있는
   `{{sip_…}}` 통화 변수가 되며, call-id 헤더는 통화의 `external_call_id`로 저장됩니다. 자세한 내용은
   [SIP 헤더로 통화 컨텍스트 전달](/ko/guides/sip-addresses)을 참조합니다.
3. **통화를 다시 넘기는 전환 번호를 하나 추가합니다.** 플랫폼의 SIP 주소(에이전트가 `REFER`를 전송함) 또는
   [반환](/ko/guides/call-transfers)
   (에이전트가 전화를 끊으면 흐름이 계속 진행됨)을 사용합니다. 해당 헤더에는
   `{{handoff_summary}}`, `{{handoff_intent}}`, `{{handoff_id}}`를 포함할 수 있습니다. 자세한 내용은
   [컨택 센터로 컨텍스트 전달](/ko/guides/call-transfers)을 참조합니다.
4. **인계 정보를 읽습니다.** 플랫폼이 인계 정보를 저장하는 위치에서 읽거나,
   플랫폼의 통화 ID로 조회합니다.

### 전환 번호 추가

SIP 주소, 반환 및 해당 헤더는 [Agents API](/api-reference/agents#transfer-numbers)로 설정합니다. 쓰기 작업은 전체 목록을 교체하므로 에이전트의 다른 전환 번호도 포함한 후 배포하세요.

```bash
curl -X PATCH https://api.thunderphone.com/v1/agents/12 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transfer_destinations": [{"name": "Contact center", "action": "return"}]}'

curl -X POST https://api.thunderphone.com/v1/agents/12/deploy \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

그런 다음 프롬프트에서 이름을 지정하여 에이전트에게 사용 시점을 알려주세요. "발신자가 사람과 통화하기를 요청하거나 요청을 해결할 수 없는 경우 Contact center로 전환하세요."

### 인계 정보 조회

흐름에서 조직의 API 키와 플랫폼의 통화 ID를 사용하여 인계 정보를 가져올 수 있습니다.

```bash
curl "https://api.thunderphone.com/v1/calls/handoff?external_call_id=YOUR_PLATFORM_CALL_ID" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

응답에는 `handoff.summary`, `handoff.intent`, `handoff.handoff_id`, 통화 시작 시 사용된 SIP 헤더와 변수, 그리고 통화가 종료된 후에는 요약과 추출된 데이터가 포함됩니다. `handoff_id`로도 통화를 조회할 수 있습니다. 자세한 내용은 [인계된 통화 조회](/api-reference/calls#look-up-a-handed-off-call)를 참조하세요.

API 키는 흐름 자체가 아니라 플랫폼의 자격 증명 저장소에 보관하세요.

<Warning>
  헤더 값은 통화를 보내는 주체가 제공합니다. 발신자가 누구인지 또는 무엇을 할 수 있는지 판단하는 용도가 아니라 프롬프트의 컨텍스트로 사용하세요.
</Warning>

## 가이드

<CardGroup cols={2}>
  <Card title="Amazon Connect" icon="phone" href="/ko/guides/contact-centers/amazon-connect">
    외부 음성 전화를 에이전트로 연결하고, 다시 반환하며 Lambda 조회를 수행합니다.
  </Card>
  <Card title="Five9" icon="phone" href="/ko/guides/contact-centers/five9">
    AI Agent Connect로 연결하고, 통화 종료 시 라우팅 헤더를 다시 전달합니다.
  </Card>
  <Card title="Genesys Cloud" icon="phone" href="/ko/guides/contact-centers/genesys-cloud">
    BYOC Cloud 트렁크로 연결하고, Take Back 및 UUI를 포함한 Transfer를 다시 수행합니다.
  </Card>
  <Card title="Talkdesk" icon="phone" href="/ko/guides/contact-centers/talkdesk">
    Autopilot Voice로 연결하고, UUI를 포함해 다시 에스컬레이션합니다.
  </Card>
  <Card title="Twilio" icon="phone" href="/ko/guides/contact-centers/twilio">
    TwiML Dial로 연결하고, referUrl 핸들러로 REFER를 다시 전송합니다.
  </Card>
  <Card title="Microsoft Dynamics 365" icon="phone" href="/ko/guides/contact-centers/microsoft-dynamics-365">
    SBC를 통해 연결하고, 다시 반환하며 HTTP 조회를 수행합니다.
  </Card>
  <Card title="NICE CXone" icon="phone" href="/ko/guides/contact-centers/nice-cxone">
    Studio Placecall로 연결하고, 다시 반환하며 REST 조회를 수행합니다.
  </Card>
  <Card title="Zoom Contact Center" icon="phone" href="/ko/guides/contact-centers/zoom-contact-center">
    봇 위젯으로 연결하고, 사람 에이전트에게 REFER를 다시 전송합니다.
  </Card>
</CardGroup>
