---
title: "Microsoft Dynamics 365 నుండి కనెక్ట్ చేయండి"
description: "X-హెడర్‌లతో మీ SBC ద్వారా Dynamics 365 Contact Center మరియు Copilot Studio కాల్‌లను ThunderPhone ఏజెంట్‌కు పంపండి, అలాగే HTTP ద్వారా ఏజెంట్ హ్యాండ్-ఆఫ్‌ను పొందండి."
---

Dynamics 365 Contact Center కాలర్‌ను సంభాషణ idతో సహా గరిష్ఠంగా ఐదు X-హెడర్‌లతో మీ సెషన్
బోర్డర్ కంట్రోలర్ (SBC) ద్వారా ఏజెంట్‌కు పంపుతుంది. ఏజెంట్ పని పూర్తిచేసినప్పుడు,
అది కాల్‌ను ముగిస్తుంది, మీ SBC కాలర్‌ను తిరిగి Dynamics 365లోకి తీసుకువస్తుంది, మరియు
ఒక HTTP రిక్వెస్ట్ నోడ్ హ్యాండ్-ఆఫ్‌ను పొందుతుంది.

## ప్రారంభించే ముందు

- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ [API కీ](/te/guides/api-keys).
- మీరే నిర్వహించే SBCకి Azure Communication Services **డైరెక్ట్ రూటింగ్** ద్వారా
  కనెక్ట్ చేసిన Dynamics 365 Contact Center వాయిస్ ఛానెల్
  ([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 ద్వారా ప్రామాణీకరించే ప్లాట్‌ఫారమ్‌లు](/te/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`గా నిల్వ చేస్తుంది. సంభాషణ idని ఏ వేరియబుల్ కలిగి ఉందో
     Copilot Studioలో నిర్ధారించండి.
   - `X-Customer-Tier` వంటి మరో నాలుగు వరకు.

Microsoft అక్షరాలు, అంకెలు మరియు `= ; . ! % * _ + ~ -` ఉపయోగించి, గరిష్ఠంగా 64 అక్షరాల
పేర్లు మరియు గరిష్ఠంగా 256 విలువలతో ఐదు X-హెడర్‌ల వరకు పంపుతుంది. ఇది ఉపసర్గను
చిన్న అక్షరాల `x-`గా వ్రాస్తుంది; ThunderPhone హెడర్ పేర్లను అక్షర పరిమాణాన్ని పరిగణించకుండా
సరిపోలుస్తుంది, కాబట్టి `x-customer-tier` promptకు `{{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. కాల్‌ను తిరిగి పొందండి

ఏజెంట్ కాల్‌ను తిరిగి పంపిస్తుంది: వీడ్కోలు చెప్పి కాల్‌ను ముగిస్తుంది. ఈ బదిలీ
నంబర్‌ను జోడించండి (చూడండి
[బదిలీ నంబర్‌ను జోడించండి](/te/guides/contact-centers/overview)):

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

కాలర్‌ను తిరిగి Dynamics 365లోకి తీసుకురావడం మీ SBC పని. సందర్భంతో కూడిన కాల్‌కు
Microsoft ఒక విధానాన్ని డాక్యుమెంట్ చేసింది: Dynamics 365లో నమోదు చేసిన నంబర్‌కు
SBC ద్వారా కొత్త కాల్, మీరు **వర్క్‌స్ట్రీమ్‌లు → అధునాతన సెట్టింగ్‌లు** కింద
సెట్ చేసిన సందర్భ వేరియబుల్‌లకు సరిపోలే కీలతో కూడిన 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 అభ్యర్థన** నోడ్‌తో హ్యాండ్-ఆఫ్‌ను పొందండి:

- `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 గరిష్ఠంగా ఐదు X-హెడర్‌లను పంపుతుంది మరియు లోపలికి వచ్చే కాల్‌లో
  మొదటి ఐదింటినే ఉంచుతుంది. Dynamics 365 గరిష్ఠంగా 128 అక్షరాల UUIని తీసుకుంటుంది.
- `BYE`లో హెడర్‌లను చదవడాన్ని Microsoft డాక్యుమెంట్ చేయలేదు, కాబట్టి హ్యాండ్-ఆఫ్
  లుక్‌అప్ ద్వారా మాత్రమే తిరిగి వస్తుంది.
