---
title: "Talkdesk에서 연결"
description: "Connect to Autopilot Voice를 사용하여 Talkdesk 통화를 ThunderPhone 에이전트로 전달하고, UUI의 핸드오프 ID로 다시 에스컬레이션합니다."
---

Talkdesk Studio 플로우는 상호작용 ID와 UUI를 포함해 발신자를 에이전트로 보냅니다. 발신자에게 사람의 도움이 필요하면 에이전트는 SIP
`REFER`로 Talkdesk에 에스컬레이션하고, 인계 ID는 Studio 변수에 저장됩니다.

## 시작하기 전에

- ThunderPhone 에이전트와 조직 [API 키](/ko/guides/api-keys).
- **외부 음성 스트림** 모드의 Studio **Autopilot Voice에 연결** 구성 요소를 포함하는 Talkdesk **대화 오케스트레이터** 라이선스
  ([Talkdesk 문서](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  에이전트가 통화를 유지하는 동안 Talkdesk는 분당 요금을 청구합니다.

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

Talkdesk는 IP 허용 목록만 문서화하므로, 소스 주소로 통화를 수락하는 엔드포인트를 만드세요:

```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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'
```

Talkdesk 문서에 따르면 오디오는 SRTP를 통해 전송되며, `"srtp": "optional"`은
Talkdesk가 SRTP를 제안할 때 SRTP로 응답합니다. 문서에는 Talkdesk가 SRTP를
필수로 요구하는지 명시되어 있지 않습니다. Talkdesk에서 SRTP가 필요하다고 안내하면
`srtp`를 `required`로 설정하세요. 이렇게 하면 SRTP 없이 들어오는 통화는 거부됩니다.

Talkdesk에서 Talkdesk의 SIP 시그널링 범위를 받으세요. 각 범위는 `/16` 또는 그보다
좁은 공인 IPv4 범위여야 합니다(IPv6는 `/48` 또는 그보다 좁아야 함). 자세한 내용은
[소스 IP로 인증하는 플랫폼](/ko/guides/sip-addresses)을 참조하세요.
Talkdesk는 모든 Twilio 고객이 공유하는 Twilio 네트워크의 주소에서 SIP를 전송하므로,
다른 발신자를 차단하는 것은 엔드포인트 주소입니다. 이 주소를 공개하지 마세요.
응답의 `sip_uri`를 보관하세요. 예:
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. 컨텍스트와 함께 통화 보내기

Studio 플로우에서 **외부 음성 스트림** 모드의 **Autopilot Voice에 연결**을 추가하고,
대상을 엔드포인트의 `sip_uri`에 `;transport=tls`를 추가한 값으로 설정하세요. 예:
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. 엔드포인트는 UDP를 통한
통화를 거부합니다. 별도로 지정하지 않으면 Twilio SIP는 UDP를 사용합니다.

Talkdesk는 다음을 전송합니다:

- 통화의 `external_call_id`로 저장되는 `X-Talkdesk-Interaction-Id`;
- `business_hours=open`과 같이 16진수로 인코딩된 `User-to-User`. 이는 디코딩되어
  `{{sip_uui}}`로 프롬프트에 전달됩니다.

구성 요소 버전 2.1은 **정의된 헤더**도 전송할 수 있습니다. Talkdesk 환경설정 페이지에서는
이를 WebSocket을 통해 전송되는 JSON으로 설명하므로, 이에 의존하기 전에 SIP 헤더로
도착하는지 Talkdesk에 확인하세요.

## 3. 통화 다시 받기

에이전트는 Talkdesk가 이를 읽는 유일한 위치인 주소 내부의 16진수 UUI로 핸드오프 ID를 포함하여 Talkdesk 에스컬레이션 주소에 `REFER`를 전송합니다.
다음 전송 번호를 추가합니다([전송 번호 추가](/ko/guides/contact-centers/overview) 및
[전송 주소 내부의 헤더](/ko/guides/call-transfers) 참조).

```json
{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

주소는 Talkdesk 문서에 있는 주소입니다. 컴포넌트 버전 2.1은
`autopilot_result=`를 읽고, 버전 1.7은 `escalate_to=`를 읽으므로
1.7에서는 해당 키를 사용합니다. `REFER`는 다음과 같습니다.

```
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
```

Talkdesk는 값을 Studio 변수에 저장합니다. 요약과 의도를 가져오려면
Connections로 구축한 사용자 지정 통합에 **작업 실행** 단계를 추가합니다.

- 인증 유형은 **API 키**이고, 헤더 이름은 `Authorization`, 값은
  `Bearer sk_live_…`입니다.
- 요청은 `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=` 뒤에
  변수의 ID를 추가합니다. 상호작용 ID와 함께 `external_call_id`로 통화를
  조회할 수도 있습니다.
- `handoff.intent`에 따라 라우팅하고, 통화를 이어받는 사람에게
  `handoff.summary`를 표시합니다.

[핸드오프된 통화 조회](/api-reference/calls#look-up-a-handed-off-call)를 참조하세요.

## 테스트

Studio 흐름을 통해 통화를 시작하고, 에이전트에게 담당자 연결을 요청한 다음,
흐름이 변수에 핸드오프 ID를 포함한 채 컴포넌트를 지난 후에도 계속되는지
확인합니다. 그런 다음 `GET /v1/calls/{call_id}`로 통화를 엽니다.
`external_call_id`는 Talkdesk 상호작용 ID여야 합니다.

## 제한 사항

- Talkdesk는 최대 256바이트의 UUI만 읽으며 `|` 또는 `;`로 구분된 값은
  허용하지 않으므로 단일 값을 전송합니다. 핸드오프 ID는 이 제한에 맞습니다.
- Talkdesk API는 에이전트의 대화 기록을 읽을 수 없습니다. 대신 핸드오프 조회
  또는 `GET /v1/calls/{call_id}`를 사용합니다.
