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

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

## 시작하기 전에

- ThunderPhone 에이전트 및 조직 [API 키](/ko/guides/api-keys).
- Azure Communication Services **Direct Routing**을 통해 직접 운영하는 SBC에 연결된 Dynamics 365 Contact Center 음성 채널
  ([SBC 요구 사항](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  공개 인증서, 포트 5061의 TLS 1.2 및 Microsoft 방향의 SRTP를 지원하는 SBC.
- **대화 전송** 노드의 **SIP X-헤더 지원**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  환경에서 사용할 수 있는지 확인합니다.

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

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

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

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

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

## 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`를 전달합니다
([사용자 지정 컨텍스트](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. 통화를 다시 받기

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

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

발신자를 Dynamics 365로 다시 연결하는 작업은 SBC가 담당합니다. Microsoft는 컨텍스트가 포함된 통화의 한 가지 진입 방법을 문서화합니다. 이는 SBC를 통해 Dynamics 365에 등록된 번호로 거는 새 통화이며, UUI 키가 **Workstreams → 고급 설정**에서 구성한 컨텍스트 변수와 일치해야 합니다
([타사 IVR 전송](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-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`를 사용합니다.

[인계된 통화 조회](/api-reference/calls#look-up-a-handed-off-call)를 참조합니다.

## 테스트

전송 노드에 연결되는 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`에서 헤더를 읽는 방법을 문서화하지 않았으므로, 인계 정보는 조회를 통해서만 다시 가져올 수 있습니다.
