ThunderPhone v3가 출시되었습니다.셀프서비스로, 분당 2¢부터.출시 소식 보기

Contact centers

Genesys Cloud에서 연결

대화 ID와 UUI를 포함하여 BYOC Cloud 트렁크를 통해 Genesys Cloud 통화를 ThunderPhone 에이전트로 전송하고, UUI의 핸드오프로 다시 가져옵니다.

Architect 플로는 대화 ID와 설정한 모든 UUI를 포함하여 BYOC Cloud 트렁크를 통해 발신자를 에이전트로 보냅니다. 발신자에게 사람이 필요하면 에이전트가 SIP REFER를 전송하고, Genesys가 통화를 다시 가져오며, 인계 ID는 통화의 UUI로 전달됩니다.

시작하기 전에

  • ThunderPhone 에이전트와 조직 API 키.
  • BYOC Cloud가 있는 Genesys Cloud 및 다음 설정이 활성화된 외부 트렁크(BYOC Carrier 또는 PBX 유형) (외부 트렁크 설정):
    • Genesys가 x-inin-cnv에 대화 ID를 전송하도록 하는 대화 헤더. 기본적으로 비활성화되어 있습니다.
    • 헤더 유형이 User-To-User이고 인코딩이 Hex인 UUI 패스스루.
    • Genesys가 에이전트의 REFER를 수락하도록 하는 가져오기 및 전환.

1. SIP 엔드포인트 만들기

Genesys는 다이제스트 챌린지에 응답하므로 표준 엔드포인트를 사용합니다.

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": "Genesys Cloud"}'

응답의 password는 한 번만 표시되므로 즉시 저장합니다. 트렁크에서 다음을 설정합니다.

설정값
SIP 서버sip.thunderphone.com, 포트 5061
프로토콜TLS
다이제스트 인증엔드포인트의 username 및 password
코덱PCMU, PCMA 또는 G.722

플로가 다이얼하는 주소를 번호 계획에서 포함하는 사이트의 아웃바운드 경로에 트렁크를 추가합니다.

2. 컨텍스트와 함께 통화 전송하기

Architect 플로에서 다음을 수행합니다.

  1. 필요에 따라 에이전트용 컨텍스트(예: account=12345)가 포함된 UUI 데이터 설정 작업을 추가합니다. Genesys는 128자 이하를 권장합니다.
  2. 예를 들어 sip:agent-12-jhxmginwjx@sip.thunderphone.com과 같이 엔드포인트의 sip_uri를 사용하는 번호로 전환 작업을 추가합니다.

Genesys는 x-inin-cnv에 대화 ID를 전송합니다. ThunderPhone은 이를 통화의 external_call_id로 저장합니다. UUI는 디코딩된 상태로 {{sip_uui}} 프롬프트에 전달됩니다.

Genesys의 트렁크 사용자 지정 헤더는 정적이므로 통화별 값은 UUI에 넣습니다. Genesys는 x-inin, x-genesys, x-pcv, x-gcv 헤더 접두사를 자체적으로 예약합니다.

3. 통화 다시 가져오기

에이전트는 Genesys의 주소로 REFER를 사용해 전환하며, 해당 주소 내부에 16진수 UUI로 인계 ID를 포함합니다. 이 전환 번호를 추가합니다(전환 번호 추가 및 전환 주소 내부의 헤더 참조).

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

주소를 발신자를 받아야 하는 대기열 또는 플로로 다시 라우팅되는 주소로 바꾸고, 그 형식은 Genesys에서 확인합니다. REFER는 다음과 같습니다.

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

가져오기 및 전환을 활성화하면 Genesys는 트렁크에서 통화를 다시 가져와 해당 주소로 라우팅합니다. Genesys 문서에 따르면 수신 UUI는 Call.UUIData에 저장됩니다. 가져오기 작업에 대해서는 이를 문서화하지 않으므로 Genesys 또는 테스트 통화로 발신자를 받는 플로가 그곳에서 인계 ID를 찾는지 확인합니다. 요약과 의도를 가져오려면 Web Services Data Actions 통합의 통화 데이터 작업으로 인계 조회를 호출합니다.

  • 요청: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= 뒤에 Call.UUIData의 ID를 추가합니다.
  • 자격 증명: Authorization: Bearer sk_live_…로 전송하는 API 키입니다.
  • 출력: handoff.summary 및 handoff.intent를 플로 변수에 매핑합니다.

인계된 통화 조회를 참조하세요.

테스트

흐름에 연결되는 번호로 전화를 걸고, 에이전트에게 담당자를 요청한 다음 Genesys가 설정한 주소로 통화를 연결하는지 확인합니다. 해당 흐름에서 Call.UUIData에 핸드오프 ID가 텍스트로 저장되는지 확인합니다(16진수 문자가 표시되면 트렁크의 UUI 인코딩이 Hex인지 확인합니다). 그런 다음 GET /v1/calls/{call_id}로 통화를 엽니다. external_call_id는 대화 ID여야 합니다.

제한 사항

  • Get SIP Headers 작업은 초기 INVITE만 읽으므로 에이전트의 REFER에서는 아무것도 읽을 수 없습니다. 핸드오프는 UUI를 통해서만 Genesys에 전달됩니다.
  • 통화에 UUI 헤더가 둘 이상 포함되면 Genesys는 모든 UUI를 삭제합니다.
  • 전송 주소는 254자로 제한되므로 긴 UUI는 길이에 맞게 잘립니다. 핸드오프 ID는 항상 들어갑니다.