---
title: "Microsoft Dynamics 365 ਤੋਂ ਕਨੈਕਟ ਕਰੋ"
description: "X-headers ਨਾਲ ਆਪਣੇ SBC ਰਾਹੀਂ Dynamics 365 Contact Center ਅਤੇ Copilot Studio ਕਾਲਾਂ ਨੂੰ ThunderPhone ਏਜੰਟ ਤੱਕ ਭੇਜੋ, ਅਤੇ HTTP ਰਾਹੀਂ ਏਜੰਟ ਦੇ ਹੈਂਡ-ਆਫ਼ ਨੂੰ ਲੁੱਕ ਅੱਪ ਕਰੋ।"
---

Dynamics 365 Contact Center ਕਾਲਰ ਨੂੰ ਤੁਹਾਡੇ ਸੈਸ਼ਨ ਬਾਰਡਰ ਕੰਟਰੋਲਰ (SBC) ਰਾਹੀਂ ਏਜੰਟ ਕੋਲ ਭੇਜਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਗੱਲਬਾਤ ID ਸਮੇਤ ਵੱਧ ਤੋਂ ਵੱਧ ਪੰਜ X-ਹੈਡਰ ਹੁੰਦੇ ਹਨ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਕੰਮ ਮੁੱਕ ਜਾਂਦਾ ਹੈ, ਉਹ ਕਾਲ ਡਿਸਕਨੈਕਟ ਕਰਦਾ ਹੈ, ਤੁਹਾਡਾ SBC ਕਾਲਰ ਨੂੰ ਮੁੜ Dynamics 365 ਵਿੱਚ ਲਿਆਉਂਦਾ ਹੈ, ਅਤੇ ਇੱਕ HTTP ਰਿਕਵੇਸਟ ਨੋਡ ਹੈਂਡ-ਆਫ਼ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।

## ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

- ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ [API ਕੁੰਜੀ](/pa/guides/api-keys)।
- Dynamics 365 Contact Center ਵੌਇਸ ਚੈਨਲ, ਜੋ ਤੁਹਾਡੇ ਵੱਲੋਂ ਚਲਾਏ ਜਾਂਦੇ SBC ਨਾਲ Azure Communication Services **ਡਾਇਰੈਕਟ ਰੂਟਿੰਗ** ਰਾਹੀਂ ਕਨੈਕਟ ਹੈ
  ([SBC ਲੋੜਾਂ](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  ਇੱਕ ਸਮਰਥਿਤ SBC ਜਿਸ ਕੋਲ ਜਨਤਕ ਸਰਟੀਫਿਕੇਟ ਹੋਵੇ, ਪੋਰਟ 5061 ਉੱਤੇ TLS 1.2 ਹੋਵੇ ਅਤੇ Microsoft ਵੱਲ SRTP ਹੋਵੇ।
- **SIP X-ਹੈਡਰ ਸਹਾਇਤਾ** **ਗੱਲਬਾਤ ਟ੍ਰਾਂਸਫ਼ਰ ਕਰੋ** ਨੋਡ ਉੱਤੇ
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header))।
  ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਇਹ ਤੁਹਾਡੇ ਵਾਤਾਵਰਨ ਵਿੱਚ ਉਪਲਬਧ ਹੈ।

Dynamics 365 ਸਿਰਫ਼ ਇੱਕ ਫ਼ੋਨ ਨੰਬਰ ਉੱਤੇ ਟ੍ਰਾਂਸਫ਼ਰ ਕਰਦਾ ਹੈ, ਅਤੇ Microsoft ਡਾਇਰੈਕਟ ਰੂਟਿੰਗ ਦੀ ਪ੍ਰਮਾਣਿਕਤਾ ਪਾਸਵਰਡ ਦੀ ਬਜਾਏ ਸਰਟੀਫਿਕੇਟ ਨਾਲ ਕਰਦਾ ਹੈ। ਤੁਹਾਡਾ 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 ਨਾਲ ਪ੍ਰਮਾਣੀਕਰਨ ਕਰਨ ਵਾਲੇ ਪਲੇਟਫ਼ਾਰਮ](/pa/guides/sip-addresses)।

## 2. ਸੰਦਰਭ ਨਾਲ ਕਾਲਾਂ ਭੇਜੋ

1. ਆਪਣੇ SBC ਉੱਤੇ ਏਜੰਟ ਲਈ ਇੱਕ ਫ਼ੋਨ ਨੰਬਰ ਚੁਣੋ, ਜਿਵੇਂ ਕਿ `+14155550188`।
2. SBC ਉੱਤੇ, ਉਸ ਨੰਬਰ ਦੀਆਂ ਕਾਲਾਂ ਨੂੰ ਐਂਡਪੁਆਇੰਟ ਦੇ `sip_uri` ਵੱਲ ਰੂਟ ਕਰੋ, ਉਦਾਹਰਨ ਲਈ `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, ਪੋਰਟ `5061` ਉੱਤੇ TLS ਰਾਹੀਂ। ThunderPhone ਐਂਡਪੁਆਇੰਟ ਨੂੰ ਯੂਜ਼ਰ ਹਿੱਸੇ (`agent-12-jhxmginwjx`) ਨਾਲ ਲੱਭਦਾ ਹੈ, ਜੋ ਰਿਕਵੇਸਟ URI ਅਤੇ `To` ਹੈਡਰ ਦੋਵਾਂ ਵਿੱਚ ਹੋਣਾ ਲਾਜ਼ਮੀ ਹੈ। X-ਹੈਡਰਾਂ ਨੂੰ ਬਿਨਾਂ ਬਦਲੇ ਅੱਗੇ ਭੇਜੋ।
3. Copilot Studio ਵਿੱਚ, ਉਸ ਨੰਬਰ ਲਈ **ਬਾਹਰੀ ਫ਼ੋਨ ਨੰਬਰ ਟ੍ਰਾਂਸਫ਼ਰ** ਨਾਲ ਇੱਕ **ਗੱਲਬਾਤ ਟ੍ਰਾਂਸਫ਼ਰ ਕਰੋ** ਨੋਡ ਸ਼ਾਮਲ ਕਰੋ, ਅਤੇ X-ਹੈਡਰ ਜੋੜੋ:
   - `X-Call-ID`: Dynamics 365 ਗੱਲਬਾਤ ID। ਕੋਈ ਵੀ Microsoft ਹੈਡਰ ਇਸਨੂੰ ਨਹੀਂ ਰੱਖਦਾ, ਇਸ ਲਈ ਇਸਨੂੰ ਇੱਥੇ ਜੋੜੋ; ThunderPhone ਇਸਨੂੰ ਕਾਲ ਦੀ `external_call_id` ਵਜੋਂ ਸਟੋਰ ਕਰਦਾ ਹੈ। Copilot Studio ਵਿੱਚ ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਕਿਹੜਾ ਵੇਰੀਏਬਲ ਗੱਲਬਾਤ ID ਰੱਖਦਾ ਹੈ।
   - ਹੋਰ ਵੱਧ ਤੋਂ ਵੱਧ ਚਾਰ, ਜਿਵੇਂ ਕਿ `X-Customer-Tier`।

Microsoft ਵੱਧ ਤੋਂ ਵੱਧ ਪੰਜ X-ਹੈਡਰ ਭੇਜਦਾ ਹੈ, ਜਿਨ੍ਹਾਂ ਦੇ ਨਾਮ 64 ਅੱਖਰਾਂ ਤੱਕ ਅਤੇ ਮੁੱਲ 256 ਤੱਕ ਹੁੰਦੇ ਹਨ, ਅਤੇ ਇਹਨਾਂ ਵਿੱਚ ਅੱਖਰ, ਅੰਕ ਅਤੇ `= ; . ! % * _ + ~ -` ਵਰਤੇ ਜਾਂਦੇ ਹਨ। ਇਹ ਪ੍ਰੀਫ਼ਿਕਸ ਨੂੰ ਛੋਟੇ ਅੱਖਰਾਂ ਵਿੱਚ `x-` ਲਿਖਦਾ ਹੈ; ThunderPhone ਹੈਡਰ ਨਾਵਾਂ ਨੂੰ ਅੱਖਰਾਂ ਦੇ ਕੇਸ ਦੀ ਪਰਵਾਹ ਕੀਤੇ ਬਿਨਾਂ ਮਿਲਾਉਂਦਾ ਹੈ, ਇਸ ਲਈ `x-customer-tier` prompt ਤੱਕ `{{sip_x_customer_tier}}` ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ।

ਜੇ ਤੁਸੀਂ ਇਸਦੀ ਬਜਾਏ Azure Communication Services Call Automation ਨਾਲ ਕਾਲ ਬਣਾਉਂਦੇ ਹੋ, ਤਾਂ `AddSipX` ਮੂਲ ਰੂਪ ਵਿੱਚ `X-MS-Custom-` ਨਾਮ ਲਿਖਦਾ ਹੈ। `SipHeaderPrefix.X` ਪਾਸ ਕਰੋ ਤਾਂ ਜੋ `X-Call-ID` ਆਪਣਾ ਨਾਮ ਬਣਾਈ ਰੱਖੇ
([ਕਸਟਮ ਸੰਦਰਭ](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context))।

## 3. ਕਾਲ ਵਾਪਸ ਪ੍ਰਾਪਤ ਕਰੋ

ਏਜੰਟ ਕਾਲ ਵਾਪਸ ਸੌਂਪ ਦਿੰਦਾ ਹੈ: ਇਹ ਅਲਵਿਦਾ ਕਹਿੰਦਾ ਹੈ ਅਤੇ ਕਾਲ ਬੰਦ ਕਰ ਦਿੰਦਾ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫਰ
ਨੰਬਰ ਜੋੜੋ (ਵੇਖੋ
[ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਜੋੜੋ](/pa/guides/contact-centers/overview)):

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

ਕਾਲਰ ਨੂੰ Dynamics 365 ਵਿੱਚ ਵਾਪਸ ਲਿਆਉਣਾ ਤੁਹਾਡੇ SBC ਦਾ ਕੰਮ ਹੈ। Microsoft
ਸੰਦਰਭ ਵਾਲੀ ਕਾਲ ਲਈ ਇੱਕ ਤਰੀਕਾ ਦਸਤਾਵੇਜ਼ਬੱਧ ਕਰਦਾ ਹੈ: SBC ਰਾਹੀਂ Dynamics 365 ਵਿੱਚ
ਰਜਿਸਟਰ ਕੀਤੇ ਨੰਬਰ ਲਈ ਨਵੀਂ ਕਾਲ, ਜਿਸ ਵਿੱਚ UUI ਦੀਆਂ ਕੁੰਜੀਆਂ ਉਹਨਾਂ ਸੰਦਰਭ ਵੇਰੀਏਬਲਾਂ ਨਾਲ
ਮੇਲ ਖਾਂਦੀਆਂ ਹੋਣ ਜੋ ਤੁਸੀਂ **ਵਰਕਸਟ੍ਰੀਮਾਂ → ਉੱਨਤ ਸੈਟਿੰਗਾਂ**
([ਤੀਜੀ-ਧਿਰ IVR ਟ੍ਰਾਂਸਫਰ](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr))
ਵਿੱਚ ਸੈਟ ਅੱਪ ਕੀਤੇ ਹਨ। ਆਪਣੇ SBC ਵਿਕਰੇਤਾ ਨਾਲ ਤੈਅ ਕਰੋ ਕਿ ThunderPhone ਦੇ ਕਾਲ ਬੰਦ ਕਰਨ
'ਤੇ ਕਾਲਰ ਉਸ ਨੰਬਰ ਤੱਕ ਕਿਵੇਂ ਪਹੁੰਚਦਾ ਹੈ, ਅਤੇ `X-Call-ID` ਵਿੱਚ ਭੇਜੀ ਗਈ ਗੱਲਬਾਤ ਆਈਡੀ ਨੂੰ
ਨਾਲ ਰੱਖੋ ਤਾਂ ਜੋ ਫਲੋ ਕਾਲ ਲੱਭ ਸਕੇ।

ਫਿਰ Copilot Studio ਦੇ **HTTP ਰਿਕਵੇਸਟ** ਨੋਡ ਨਾਲ ਹੈਂਡ-ਆਫ਼ ਪ੍ਰਾਪਤ ਕਰੋ:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_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` ਗੱਲਬਾਤ ਆਈਡੀ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ। ਜੇ ਕਾਲ ਕਦੇ ਵੀ
ਏਜੰਟ ਤੱਕ ਨਹੀਂ ਪਹੁੰਚਦੀ ਅਤੇ ਤੁਹਾਡੇ SBC ਲੌਗ SIP `404` ਦਿਖਾਉਂਦੇ ਹਨ, ਤਾਂ ਇਸਦੀ ਰਿਕਵੇਸਟ
URI ਜਾਂ `To` ਹੈਡਰ ਵਿੱਚ ਐਂਡਪੌਇੰਟ ਦਾ ਯੂਜ਼ਰ-ਭਾਗ ਨਹੀਂ ਹੈ।

## ਸੀਮਾਵਾਂ

- SBC ਲਾਜ਼ਮੀ ਹੈ। Microsoft SIP ਐਡਰੈੱਸ ਡਾਇਲ ਨਹੀਂ ਕਰ ਸਕਦਾ ਜਾਂ ਡਾਇਜੈਸਟ ਚੈਲੈਂਜ ਦਾ ਜਵਾਬ ਨਹੀਂ ਦੇ ਸਕਦਾ।
- Microsoft ਵੱਧ ਤੋਂ ਵੱਧ ਪੰਜ X-ਹੈਡਰ ਭੇਜਦਾ ਹੈ ਅਤੇ ਅੰਦਰ ਆਉਣ ਵਾਲੀ ਕਾਲ ਵਿੱਚ ਸਿਰਫ਼ ਪਹਿਲੇ ਪੰਜ ਹੀ ਰੱਖਦਾ ਹੈ। Dynamics 365 ਵੱਧ ਤੋਂ ਵੱਧ 128 ਅੱਖਰਾਂ ਦਾ UUI ਲੈਂਦਾ ਹੈ।
- Microsoft `BYE` ਉੱਤੇ ਹੈਡਰ ਪੜ੍ਹਨ ਬਾਰੇ ਦਸਤਾਵੇਜ਼ਬੱਧ ਨਹੀਂ ਕਰਦਾ, ਇਸ ਲਈ ਹੈਂਡ-ਆਫ਼ ਸਿਰਫ਼ ਲੁੱਕਅੱਪ ਰਾਹੀਂ ਹੀ ਵਾਪਸ ਆਉਂਦਾ ਹੈ।
