Open in
컨택 센터
Amazon Connect, Five9, Genesys Cloud, Talkdesk, Twilio, Microsoft Dynamics 365, NICE CXone 또는 Zoom Contact Center의 통화를 SIP를 통해 ThunderPhone 에이전트로 전송하고, 에이전트의 통화 이관으로 다시 연결합니다.
ThunderPhone 에이전트는 컨택 센터의 통화 흐름 내에서 전화를 받을 수 있습니다. 플랫폼은 자체 통화 ID와 발신자에 대해 알고 있는 기타 정보를 담은 SIP 헤더와 함께 에이전트의 SIP 주소로 통화를 전송합니다. 발신자에게 사람이 필요한 경우, 에이전트는 핸드오프와 함께 통화를 다시 전달합니다. 핸드오프에는 발신자에게 필요한 사항의 요약, 짧은 의도 레이블 및 통화 흐름에서 조회할 수 있는 ID가 포함됩니다.
플랫폼
| 플랫폼 | 통화 수신 방식 | 통화 ID 헤더 | 통화 복귀 방식 | 컨텍스트 복귀 방식 |
|---|---|---|---|---|
| Amazon Connect | 외부 음성 전환 커넥터; IP 허용 목록 | X-Amzn-ConnectContactId | 복귀: 에이전트가 전화를 끊고 흐름이 재개됨 | Lambda가 핸드오프 조회를 호출 |
| Five9 | Five9에서 설정한 다이얼인 번호용 AI Agent Connect; IP 허용 목록 | X-CallID | 복귀: 에이전트가 BYE의 라우팅 헤더와 함께 전화를 끊음 | X-Route* 및 X-CustomMetaData 헤더를 IVR 통화 변수로 전달 |
| Genesys Cloud | BYOC Cloud 트렁크; 다이제스트 | x-inin-cnv | 되돌리기 및 전환에서 수락되는 REFER | 전환 주소 내 16진수 UUI, 이후 데이터 작업 |
| Talkdesk | Autopilot Voice에 연결; IP 허용 목록 | X-Talkdesk-Interaction-Id | Talkdesk의 에스컬레이션 주소로 REFER | 전환 주소 내 16진수 UUI, 이후 작업 실행 |
| Twilio | <Dial><Sip>; 다이제스트 | 직접 추가하는 X-Call-ID | referUrl 핸들러로 REFER | 전환 주소 내 헤더(ReferTransferTarget) |
| Microsoft Dynamics 365 | SBC를 통한 전화번호 전환; 다이제스트 | 직접 추가하는 X-Call-ID | 복귀 후 SBC가 발신자를 다시 라우팅 | HTTP Request 노드가 핸드오프 조회를 호출 |
| NICE CXone | 다이얼인 번호로 Sipputheader를 사용하는 Studio Placecall; IP 허용 목록 | 직접 추가하는 X-Call-ID | 복귀: 에이전트가 전화를 끊음(NICE에 스크립트가 발신자를 복귀시키는 방식을 확인) | REST API 작업이 핸드오프 조회를 호출 |
| Zoom Contact Center | Zoom이 구축한 트렁크의 다이얼인 번호용 봇 위젯; SRTP를 사용하는 IP 허용 목록 | X-ZOOM-Call-Sid | Zoom의 사람 담당자 주소로 REFER | HTTP Call 위젯이 핸드오프 조회를 호출 |
작동 방식
- 에이전트용 SIP 엔드포인트를 생성합니다. API를 사용하거나, 앱의 전화 및 웹
→ SIP 엔드포인트에서 생성하거나, Zeus에게 요청합니다. 비밀번호 챌린지에 응답할 수 있는
플랫폼은 엔드포인트의 사용자 이름과 비밀번호를 사용합니다. 소스 주소로만 자신을 식별하는
플랫폼은
auth를ip_allowlist로 설정한 엔드포인트를 사용합니다. 자세한 내용은 소스 IP로 인증하는 플랫폼을 참조합니다. SIP 주소 대신 전화번호로 발신하는 플랫폼은 해당 엔드포인트의 수신 번호를 통해 엔드포인트에 연결합니다. - 컨텍스트와 함께 통화를 전송합니다. 플랫폼은 엔드포인트의
sip_uri또는 수신 번호로 발신합니다. 플랫폼이 전송하는 모든X-헤더와User-to-User는 프롬프트에서 사용할 수 있는{{sip_…}}통화 변수가 되며, call-id 헤더는 통화의external_call_id로 저장됩니다. 자세한 내용은 SIP 헤더로 통화 컨텍스트 전달을 참조합니다. - 통화를 다시 넘기는 전환 번호를 하나 추가합니다. 플랫폼의 SIP 주소(에이전트가
REFER를 전송함) 또는 반환 (에이전트가 전화를 끊으면 흐름이 계속 진행됨)을 사용합니다. 해당 헤더에는{{handoff_summary}},{{handoff_intent}},{{handoff_id}}를 포함할 수 있습니다. 자세한 내용은 컨택 센터로 컨텍스트 전달을 참조합니다. - 인계 정보를 읽습니다. 플랫폼이 인계 정보를 저장하는 위치에서 읽거나, 플랫폼의 통화 ID로 조회합니다.
전환 번호 추가
SIP 주소, 반환 및 해당 헤더는 Agents API로 설정합니다. 쓰기 작업은 전체 목록을 교체하므로 에이전트의 다른 전환 번호도 포함한 후 배포하세요.
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를 사용하여 인계 정보를 가져올 수 있습니다.
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 키는 흐름 자체가 아니라 플랫폼의 자격 증명 저장소에 보관하세요.
가이드
외부 음성 전화를 에이전트로 연결하고, 다시 반환하며 Lambda 조회를 수행합니다.
AI Agent Connect로 연결하고, 통화 종료 시 라우팅 헤더를 다시 전달합니다.
BYOC Cloud 트렁크로 연결하고, Take Back 및 UUI를 포함한 Transfer를 다시 수행합니다.
Autopilot Voice로 연결하고, UUI를 포함해 다시 에스컬레이션합니다.
TwiML Dial로 연결하고, referUrl 핸들러로 REFER를 다시 전송합니다.
SBC를 통해 연결하고, 다시 반환하며 HTTP 조회를 수행합니다.
Studio Placecall로 연결하고, 다시 반환하며 REST 조회를 수행합니다.
봇 위젯으로 연결하고, 사람 에이전트에게 REFER를 다시 전송합니다.