Open in
Talkdesk에서 연결
Connect to Autopilot Voice를 사용하여 Talkdesk 통화를 ThunderPhone 에이전트로 전달하고, UUI의 핸드오프 ID로 다시 에스컬레이션합니다.
Talkdesk Studio 플로우는 상호작용 ID와 UUI를 포함해 발신자를 에이전트로 보냅니다. 발신자에게 사람의 도움이 필요하면 에이전트는 SIP
REFER로 Talkdesk에 에스컬레이션하고, 인계 ID는 Studio 변수에 저장됩니다.
시작하기 전에
- ThunderPhone 에이전트와 조직 API 키.
- 외부 음성 스트림 모드의 Studio Autopilot Voice에 연결 구성 요소를 포함하는 Talkdesk 대화 오케스트레이터 라이선스 (Talkdesk 문서). 에이전트가 통화를 유지하는 동안 Talkdesk는 분당 요금을 청구합니다.
1. SIP 엔드포인트 만들기
Talkdesk는 IP 허용 목록만 문서화하므로, 소스 주소로 통화를 수락하는 엔드포인트를 만드세요:
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로 인증하는 플랫폼을 참조하세요.
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를 전송합니다.
다음 전송 번호를 추가합니다(전송 번호 추가 및
전송 주소 내부의 헤더 참조).
{
"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를 표시합니다.
핸드오프된 통화 조회를 참조하세요.
테스트
Studio 흐름을 통해 통화를 시작하고, 에이전트에게 담당자 연결을 요청한 다음,
흐름이 변수에 핸드오프 ID를 포함한 채 컴포넌트를 지난 후에도 계속되는지
확인합니다. 그런 다음 GET /v1/calls/{call_id}로 통화를 엽니다.
external_call_id는 Talkdesk 상호작용 ID여야 합니다.
제한 사항
- Talkdesk는 최대 256바이트의 UUI만 읽으며
|또는;로 구분된 값은 허용하지 않으므로 단일 값을 전송합니다. 핸드오프 ID는 이 제한에 맞습니다. - Talkdesk API는 에이전트의 대화 기록을 읽을 수 없습니다. 대신 핸드오프 조회
또는
GET /v1/calls/{call_id}를 사용합니다.