---
title: "Microsoft Dynamics 365 இலிருந்து இணைக்கவும்"
description: "X-headers உடன் உங்கள் SBC வழியாக Dynamics 365 Contact Center மற்றும் Copilot Studio அழைப்புகளை ThunderPhone ஏஜென்ட்டிற்கு அனுப்பி, ஏஜென்ட்டின் hand-off-ஐ HTTP வழியாகத் தேடவும்."
---

Dynamics 365 தொடர்பு மையம், உரையாடல் id உட்பட அதிகபட்சம் ஐந்து X-ஹெடர்களுடன், உங்கள் அமர்வு
எல்லைக் கட்டுப்படுத்தி (SBC) வழியாக அழைப்பாளரை ஏஜென்ட்டிடம் அனுப்புகிறது. ஏஜென்ட் முடித்ததும்,
அது அழைப்பை முடிக்கிறது, உங்கள் SBC அழைப்பாளரை மீண்டும் Dynamics 365-க்கு கொண்டுவருகிறது, மேலும்
ஒரு HTTP கோரிக்கை நோடு ஒப்படைப்பைப் பெறுகிறது.

## தொடங்குவதற்கு முன்

- ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு நிறுவனம் [API விசை](/ta/guides/api-keys).
- Azure Communication Services **நேரடி ரூட்டிங்** வழியாக நீங்கள் இயக்கும் SBC-க்கு
  இணைக்கப்பட்டுள்ள Dynamics 365 தொடர்பு மைய குரல் சேனல்
  ([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-யால்
digest அங்கீகாரத்தைச் செய்ய முடியாவிட்டால், அதற்குப் பதிலாக `auth`-ஐ `ip_allowlist` என
அமைத்து, உங்கள் SBC-யின் பொது முகவரியுடன் எண்ட்பாயிண்டை உருவாக்கவும்; பார்க்கவும்
[மூல IP மூலம் அங்கீகரிக்கும் தளங்கள்](/ta/guides/sip-addresses).

## 2. சூழலுடன் அழைப்புகளை அனுப்பவும்

1. உங்கள் SBC-யில் ஏஜென்ட்டுக்கான ஒரு தொலைபேசி எண்ணைத் தேர்ந்தெடுக்கவும், உதாரணமாக `+14155550188`.
2. SBC-யில், அந்த எண்ணுக்கான அழைப்புகளை எண்ட்பாயிண்டின் `sip_uri`-க்கு வழிமாற்றவும்,
   உதாரணமாக போர்ட் `5061`-ல் TLS வழியாக `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.
   ThunderPhone பயனர் பகுதியின் மூலம் எண்ட்பாயிண்டைக் கண்டறிகிறது
   (`agent-12-jhxmginwjx`); அது கோரிக்கை URI மற்றும் `To` ஹெடர் இரண்டிலும் இருக்க வேண்டும்.
   X-ஹெடர்களை மாற்றமின்றி அனுப்பவும்.
3. Copilot Studio-வில், அந்த எண்ணுக்கு **வெளிப்புற தொலைபேசி எண் மாற்றம்** கொண்ட
   **உரையாடலை மாற்று** நோடைச் சேர்த்து, X-ஹெடர்களைச் சேர்க்கவும்:
   - `X-Call-ID`: Dynamics 365 உரையாடல் id. எந்த Microsoft ஹெடரும் இதைக் கொண்டிருக்காது,
     எனவே இதை இங்கே சேர்க்கவும்; ThunderPhone இதை அழைப்பின்
     `external_call_id` ஆகச் சேமிக்கிறது. உரையாடல் id-ஐ எந்த மாறி வைத்திருக்கிறது என்பதை
     Copilot Studio-வில் உறுதிப்படுத்தவும்.
   - `X-Customer-Tier` போன்ற மேலும் நான்கு வரை.

Microsoft அதிகபட்சம் ஐந்து X-ஹெடர்களை அனுப்புகிறது; அவற்றின் பெயர்கள் 64 எழுத்துகள் வரை,
மதிப்புகள் 256 வரை இருக்கலாம், மேலும் எழுத்துகள், இலக்கங்கள் மற்றும் `= ; . ! % * _ + ~ -`
ஆகியவற்றைப் பயன்படுத்தலாம். அது முன்னொட்டைப் சிற்றெழுத்து `x-` என எழுதுகிறது; ThunderPhone
ஹெடர் பெயர்களை பெரிய/சிறிய எழுத்து வேறுபாட்டைக் கணக்கில் கொள்ளாமல் பொருத்துவதால்,
`x-customer-tier` prompt-க்கு `{{sip_x_customer_tier}}` ஆக வருகிறது.

அதற்குப் பதிலாக Azure Communication Services அழைப்பு ஆட்டோமேஷன் மூலம் அழைப்பை உருவாக்கினால்,
`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. அழைப்பை மீண்டும் பெறுங்கள்

ஏஜென்ட் அழைப்பைத் திருப்பி அனுப்புகிறது: அது விடைபெற்று அழைப்பைத் துண்டிக்கிறது. இந்தப் பரிமாற்ற எண்ணைச் சேர்க்கவும் (பார்க்கவும்
[பரிமாற்ற எண்ணைச் சேர்க்கவும்](/ta/guides/contact-centers/overview)):

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

அழைப்பாளரை மீண்டும் Dynamics 365-க்கு கொண்டு வருவது உங்கள் SBC-யின் பணி. சூழலுடன் ஒரு அழைப்பை இணைப்பதற்கான ஒரு முறையை Microsoft ஆவணப்படுத்துகிறது: Dynamics 365-இல் பதிவுசெய்யப்பட்ட எண்ணுக்கு SBC வழியாக புதிய அழைப்பு, நீங்கள் **Workstreams → மேம்பட்ட அமைப்புகள்** கீழ் அமைத்த சூழல் மாறிகளுடன் பொருந்தும் விசைகளைக் கொண்ட UUI உடன்
([மூன்றாம் தரப்பு 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 கோரிக்கை** முனையைப் பயன்படுத்தி ஒப்படைப்பைப் பெறுங்கள்:

- உரையாடல் id-யைத் தொடர்ந்து `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` உரையாடல் id-யாக இருக்க வேண்டும். அழைப்பு ஏஜென்டை ஒருபோதும் அடையவில்லை மற்றும் உங்கள் SBC பதிவுகள் SIP `404`-ஐக் காட்டினால், அதன் கோரிக்கை URI அல்லது `To` தலைப்பில் எண்ட்பாயிண்ட்டின் பயனர் பகுதி இல்லை.

## வரம்புகள்

- SBC அவசியம். Microsoft-ஆல் SIP முகவரியை அழைக்கவோ அல்லது digest சவாலுக்குப் பதிலளிக்கவோ முடியாது.
- Microsoft அதிகபட்சம் ஐந்து X-தலைப்புகளை அனுப்புகிறது; உள்வரும் அழைப்பில் முதல் ஐந்தை மட்டுமே வைத்திருக்கும். Dynamics 365 அதிகபட்சம் 128 எழுத்துகள் கொண்ட UUI-ஐ ஏற்கிறது.
- `BYE`-இல் தலைப்புகளைப் படிப்பதை Microsoft ஆவணப்படுத்தவில்லை; எனவே ஒப்படைப்பு தேடல் மூலம் மட்டுமே மீண்டும் கிடைக்கும்.
