---
title: "Unganisha kutoka Microsoft Dynamics 365"
description: "Tuma simu za Dynamics 365 Contact Center na Copilot Studio kwa ejenti wa ThunderPhone kupitia SBC yako ukitumia vichwa vya X, na tafuta uhamisho wa ejenti kupitia HTTP."
---

Dynamics 365 Contact Center humtuma mpigaji simu kwa ejenti kupitia kidhibiti chako cha mpaka wa sesheni (SBC), ikiwa na hadi X-header tano ikijumuisha id ya mazungumzo. Ejenti inapomaliza, hukata simu, SBC yako humrudisha mpigaji simu kwenye Dynamics 365, na nodi ya Ombi la HTTP hupata makabidhiano.

## Kabla ya kuanza

- Ejenti wa ThunderPhone na [ufunguo wa API](/sw/guides/api-keys) wa shirika.
- Kituo cha sauti cha Dynamics 365 Contact Center, kilichounganishwa kupitia Azure
  Communication Services **Uelekezaji wa Moja kwa Moja** kwenye SBC unayoendesha
  ([mahitaji ya SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  SBC inayotumika yenye cheti cha umma, TLS 1.2 kwenye bandari 5061 na SRTP
  kuelekea Microsoft.
- **Usaidizi wa SIP X-header** kwenye nodi ya **Hamisha mazungumzo**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Thibitisha kuwa unapatikana katika mazingira yako.

Dynamics 365 huhamisha tu kwenye nambari ya simu, na Microsoft huthibitisha
Uelekezaji wa Moja kwa Moja kwa cheti, si kwa nywila. SBC yako hukaa kati ya
Microsoft na ThunderPhone na kugeuza nambari hiyo kuwa anwani ya SIP ya ejenti.

## 1. Unda kituo cha mwisho cha SIP

Simu hufika ThunderPhone kutoka kwenye SBC yako, kwa hivyo unda kituo cha mwisho
cha kawaida kitakachotumiwa na 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"}'
```

Hifadhi `password` kutoka kwenye jibu mara moja; huonyeshwa mara moja, na
SBC yako hujibu changamoto ya ThunderPhone kwa kuitumia. Ikiwa SBC yako haiwezi
kufanya uthibitishaji wa muhtasari, unda kituo cha mwisho huku `auth` ikiwa
imewekwa kuwa `ip_allowlist` na anwani ya umma ya SBC yako badala yake; tazama
[Majukwaa yanayothibitisha kwa IP chanzo](/sw/guides/sip-addresses).

## 2. Tuma simu zenye muktadha

1. Chagua nambari ya simu ya ejenti kwenye SBC yako, kama vile `+14155550188`.
2. Kwenye SBC, elekeza simu zinazoingia kwenye nambari hiyo kwenye `sip_uri` ya
   kituo cha mwisho, kwa mfano `sip:agent-12-jhxmginwjx@sip.thunderphone.com`,
   kupitia TLS kwenye bandari `5061`. ThunderPhone hupata kituo cha mwisho kwa
   sehemu ya mtumiaji (`agent-12-jhxmginwjx`), ambayo lazima iwe katika URI ya
   ombi na kichwa cha `To`. Pitisha X-header bila kuzibadilisha.
3. Katika Copilot Studio, ongeza nodi ya **Hamisha mazungumzo** yenye
   **Hamisha kwa nambari ya simu ya nje** hadi kwenye nambari hiyo, na uongeze
   X-header:
   - `X-Call-ID`: id ya mazungumzo ya Dynamics 365. Hakuna kichwa cha Microsoft
     kinachoibeba, kwa hivyo iongeze hapa; ThunderPhone huihifadhi kama
     `external_call_id` ya simu. Thibitisha katika Copilot Studio ni kigeu gani
     kinachoshikilia id ya mazungumzo.
   - Hadi nyingine nne, kama vile `X-Customer-Tier`.

Microsoft hutuma upeo wa X-header tano, zikiwa na majina ya hadi vibambo 64 na
thamani za hadi 256, kwa kutumia herufi, tarakimu na `= ; . ! % * _ + ~ -`.
Huandika kiambishi awali kwa herufi ndogo `x-`; ThunderPhone hulinganisha majina
ya vichwa bila kuzingatia ukubwa wa herufi, kwa hivyo `x-customer-tier` hufika
kwenye prompt kama `{{sip_x_customer_tier}}`.

Ikiwa badala yake utaunda simu kwa Azure Communication Services Call Automation,
`AddSipX` huandika majina ya `X-MS-Custom-` kwa chaguo-msingi. Pitisha
`SipHeaderPrefix.X` ili `X-Call-ID` ihifadhi jina lake
([muktadha maalum](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Rejesha simu

Ejenti hurudisha simu: inaaga na kukata simu. Ongeza nambari hii ya
uhamisho (angalia
[Ongeza nambari ya uhamisho](/sw/guides/contact-centers/overview)):

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

Kurudisha mpigaji simu kwenye Dynamics 365 ni kazi ya SBC yako. Microsoft
inaeleza njia moja ya kuingiza simu yenye muktadha: simu mpya kupitia SBC hadi
kwenye nambari iliyosajiliwa katika Dynamics 365, yenye UUI ambayo funguo zake
zinalingana na vigeu vya muktadha unavyoweka chini ya **Mitiririko ya kazi → Mipangilio ya kina**
([uhamisho wa IVR wa mhusika mwingine](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Panga na mtoa huduma wako wa SBC jinsi mpigaji simu anavyofika kwenye nambari
hiyo ThunderPhone inapokata simu, na pitisha kitambulisho cha mazungumzo
ulichotuma katika `X-Call-ID` ili mtiririko uweze kupata simu.

Kisha pata maelezo ya uhamisho kwa kutumia nodi ya Copilot Studio ya **Ombi la HTTP**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ikifuatiwa na kitambulisho cha mazungumzo.
- Kichwa `Authorization: Bearer sk_live_…`.
- Changanua jibu katika kigeu na utumie `handoff.summary` na
  `handoff.intent`.

Angalia [Tafuta simu iliyohamishwa](/api-reference/calls#look-up-a-handed-off-call).

## Ijaribu

Piga nambari ya Dynamics 365 inayofikia nodi ya uhamisho, mwombe ejenti mtu,
na uhakikishe kuwa mpigaji simu anarudi kwenye Dynamics 365. Kisha fungua simu
kwa `GET /v1/calls/{call_id}`: `sip_headers` zinapaswa kuorodhesha `x-call-id`,
na `external_call_id` inapaswa kuwa kitambulisho cha mazungumzo. Ikiwa simu
haimfikii ejenti kamwe na kumbukumbu za SBC yako zinaonyesha SIP `404`, URI ya
ombi lake au kichwa cha `To` hakina sehemu ya mtumiaji ya endpoint.

## Vikomo

- SBC inahitajika. Microsoft haiwezi kupiga anwani ya SIP au kujibu changamoto
  ya digest.
- Microsoft hutuma vichwa vya X visivyozidi vitano, na huhifadhi vitano vya
  kwanza pekee kwenye simu inayoingia. Dynamics 365 huchukua herufi zisizozidi
  128 za UUI.
- Microsoft haielezi kusoma vichwa kwenye `BYE`, kwa hivyo maelezo ya uhamisho
  hurudi kupitia utafutaji pekee.
