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

Contact centers

Microsoft Dynamics 365에서 연결

X-헤더를 사용해 SBC를 통해 Dynamics 365 Contact Center 및 Copilot Studio 통화를 ThunderPhone 에이전트로 전송하고, HTTP를 통해 에이전트의 통화 전환을 조회합니다.

Dynamics 365 Contact Center는 대화 ID를 포함해 최대 5개의 X-헤더와 함께 세션 보더 컨트롤러(SBC)를 통해 발신자를 에이전트로 연결합니다. 에이전트가 작업을 마치면 통화를 종료하고, SBC는 발신자를 Dynamics 365로 다시 연결하며, HTTP 요청 노드가 인계를 가져옵니다.

시작하기 전에

  • ThunderPhone 에이전트 및 조직 API 키.
  • Azure Communication Services Direct Routing을 통해 직접 운영하는 SBC에 연결된 Dynamics 365 Contact Center 음성 채널 (SBC 요구 사항): 공개 인증서, 포트 5061의 TLS 1.2 및 Microsoft 방향의 SRTP를 지원하는 SBC.
  • 대화 전송 노드의 SIP X-헤더 지원 (Copilot Studio). 환경에서 사용할 수 있는지 확인합니다.

Dynamics 365는 전화번호로만 전송하며, Microsoft는 비밀번호가 아닌 인증서로 Direct Routing을 인증합니다. SBC는 Microsoft와 ThunderPhone 사이에 위치하며 해당 번호를 에이전트의 SIP 주소로 변환합니다.

1. SIP 엔드포인트 만들기

통화는 SBC에서 ThunderPhone으로 연결되므로 SBC에서 사용할 표준 엔드포인트를 만듭니다.

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": "Dynamics 365 SBC"}'

응답의 password를 즉시 저장합니다. 한 번만 표시되며, SBC는 이를 사용해 ThunderPhone의 챌린지에 응답합니다. SBC에서 다이제스트 인증을 지원하지 않는 경우에는 auth를 ip_allowlist로 설정하고 대신 SBC의 공개 주소를 사용해 엔드포인트를 만듭니다. 자세한 내용은 소스 IP로 인증하는 플랫폼을 참조합니다.

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

  1. SBC에서 에이전트에 사용할 전화번호를 선택합니다(예: +14155550188).
  2. SBC에서 해당 번호로 오는 통화를 엔드포인트의 sip_uri로 라우팅합니다. 예를 들어 포트 5061의 TLS를 통해 sip:agent-12-jhxmginwjx@sip.thunderphone.com으로 라우팅합니다. ThunderPhone은 요청 URI와 To 헤더 모두에 있어야 하는 사용자 부분(agent-12-jhxmginwjx)으로 엔드포인트를 찾습니다. X-헤더는 변경하지 않고 그대로 전달합니다.
  3. Copilot Studio에서 해당 번호에 대한 외부 전화번호로 전송이 포함된 대화 전송 노드를 추가하고 X-헤더를 추가합니다.
    • X-Call-ID: Dynamics 365 대화 ID입니다. Microsoft 헤더에는 이 값이 없으므로 여기에서 추가합니다. ThunderPhone은 이를 통화의 external_call_id로 저장합니다. Copilot Studio에서 대화 ID를 보관하는 변수를 확인합니다.
    • X-Customer-Tier와 같은 추가 헤더를 최대 4개까지 설정합니다.

Microsoft는 이름이 최대 64자이고 값이 최대 256자인 X-헤더를 최대 5개까지 전송하며, 문자, 숫자 및 = ; . ! % * _ + ~ -를 사용합니다. 접두사는 소문자 x-로 작성합니다. ThunderPhone은 헤더 이름의 대소문자를 구분하지 않고 일치시키므로 x-customer-tier는 {{sip_x_customer_tier}}로 프롬프트에 전달됩니다.

대신 Azure Communication Services Call Automation으로 통화를 구축하는 경우 AddSipX는 기본적으로 X-MS-Custom- 이름을 작성합니다. X-Call-ID 이름이 유지되도록 SipHeaderPrefix.X를 전달합니다 (사용자 지정 컨텍스트).

3. 통화를 다시 받기

에이전트가 통화를 반환합니다. 작별 인사를 하고 전화를 끊습니다. 다음 전송 번호를 추가합니다(자세한 내용은 전송 번호 추가 참조).

{"name": "Dynamics 365", "action": "return"}

발신자를 Dynamics 365로 다시 연결하는 작업은 SBC가 담당합니다. Microsoft는 컨텍스트가 포함된 통화의 한 가지 진입 방법을 문서화합니다. 이는 SBC를 통해 Dynamics 365에 등록된 번호로 거는 새 통화이며, UUI 키가 Workstreams → 고급 설정에서 구성한 컨텍스트 변수와 일치해야 합니다 (타사 IVR 전송). ThunderPhone이 전화를 끊을 때 발신자가 해당 번호에 도달하는 방법은 SBC 공급업체와 협의하고, 흐름에서 통화를 찾을 수 있도록 X-Call-ID로 전송한 대화 ID를 전달합니다.

그런 다음 Copilot Studio HTTP 요청 노드로 인계 정보를 가져옵니다.

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= 뒤에 대화 ID를 추가합니다.
  • 헤더 Authorization: Bearer sk_live_….
  • 응답을 변수로 파싱하고 handoff.summary 및 handoff.intent를 사용합니다.

인계된 통화 조회를 참조합니다.

테스트

전송 노드에 연결되는 Dynamics 365 번호로 전화를 걸고 에이전트에게 담당자를 요청한 다음, 발신자가 Dynamics 365로 다시 연결되는지 확인합니다. 그런 다음 GET /v1/calls/{call_id}로 통화를 엽니다. sip_headers에 x-call-id가 표시되어야 하며, external_call_id는 대화 ID여야 합니다. 통화가 에이전트에 도달하지 않고 SBC 로그에 SIP 404가 표시되면 요청 URI 또는 To 헤더에 엔드포인트의 사용자 부분이 포함되지 않은 것입니다.

제한 사항

  • SBC가 필요합니다. Microsoft는 SIP 주소로 전화를 걸거나 다이제스트 인증 요청에 응답할 수 없습니다.
  • Microsoft는 최대 5개의 X-헤더를 전송하며, 수신 통화에서는 처음 5개만 유지합니다. Dynamics 365는 최대 128자의 UUI를 허용합니다.
  • Microsoft는 BYE에서 헤더를 읽는 방법을 문서화하지 않았으므로, 인계 정보는 조회를 통해서만 다시 가져올 수 있습니다.