---
title: "Conectați-vă din Microsoft Dynamics 365"
description: "Trimiteți apelurile Dynamics 365 Contact Center și Copilot Studio către un agent vocal ThunderPhone prin SBC-ul dumneavoastră cu antete X și căutați transferul agentului prin HTTP."
---

Dynamics 365 Contact Center trimite apelantul către agent prin controlerul dumneavoastră de frontieră de sesiune (SBC), cu până la cinci antete X, inclusiv id-ul conversației. Când agentul termină, încheie apelul, SBC-ul dumneavoastră readuce apelantul în Dynamics 365, iar un nod de solicitare HTTP preia predarea.

## Înainte de a începe

- Un agent ThunderPhone și o [cheie API](/ro/guides/api-keys) de organizație.
- Canalul vocal Dynamics 365 Contact Center, conectat prin Azure
  Communication Services **Rutare directă** la un SBC administrat de dumneavoastră
  ([cerințe pentru SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  un SBC compatibil cu certificat public, TLS 1.2 pe portul 5061 și SRTP
  către Microsoft.
- **Suport pentru antete SIP X** în nodul **Transferați conversația**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Confirmați că este disponibil în mediul dumneavoastră.

Dynamics 365 transferă doar către un număr de telefon, iar Microsoft autentifică
Rutarea directă prin certificat, nu prin parolă. SBC-ul dumneavoastră se află între
Microsoft și ThunderPhone și transformă acel număr în adresa SIP a agentului.

## 1. Creați punctul final SIP

Apelul ajunge la ThunderPhone de la SBC-ul dumneavoastră, deci creați un punct final standard pe care
SBC-ul să îl utilizeze:

```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"}'
```

Salvați imediat `password` din răspuns; este afișată o singură dată, iar
SBC-ul dumneavoastră răspunde cu aceasta la provocarea ThunderPhone. Dacă SBC-ul nu poate efectua
autentificarea Digest, creați în schimb punctul final cu `auth` setat la `ip_allowlist` și adresa publică a
SBC-ului; consultați
[Platforme care se autentifică după IP-ul sursă](/ro/guides/sip-addresses).

## 2. Trimiteți apeluri cu context

1. Alegeți un număr de telefon pentru agent pe SBC-ul dumneavoastră, precum `+14155550188`.
2. Pe SBC, direcționați apelurile către acel număr la `sip_uri` al punctului final, de
   exemplu `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, prin TLS pe portul
   `5061`. ThunderPhone identifică punctul final după partea de utilizator
   (`agent-12-jhxmginwjx`), care trebuie să fie atât în URI-ul solicitării, cât și în
   antetul `To`. Transmiteți antetele X fără modificări.
3. În Copilot Studio, adăugați un nod **Transferați conversația** cu
   **Transfer către număr de telefon extern** către acel număr și adăugați antetele X:
   - `X-Call-ID`: id-ul conversației Dynamics 365. Niciun antet Microsoft nu îl conține,
     deci adăugați-l aici; ThunderPhone îl stochează ca
     `external_call_id` al apelului. Confirmați în Copilot Studio ce variabilă conține
     id-ul conversației.
   - Încă până la patru antete, precum `X-Customer-Tier`.

Microsoft trimite cel mult cinci antete X, cu nume de până la 64 de caractere și
valori de până la 256 de caractere, folosind litere, cifre și `= ; . ! % * _ + ~ -`. Scrie
prefixul cu litere mici, `x-`; ThunderPhone compară numele antetelor fără a ține cont de majuscule,
astfel încât `x-customer-tier` ajunge în prompt ca `{{sip_x_customer_tier}}`.

Dacă creați apelul cu Azure Communication Services Call Automation
în schimb, `AddSipX` scrie implicit nume `X-MS-Custom-`. Transmiteți
`SipHeaderPrefix.X` pentru ca `X-Call-ID` să își păstreze numele
([context personalizat](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Preluați apelul înapoi

Agentul returnează apelul: își ia rămas-bun și închide. Adăugați acest
număr de transfer (consultați
[Adăugați numărul de transfer](/ro/guides/contact-centers/overview)):

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

Readucerea apelantului în Dynamics 365 este responsabilitatea SBC-ului dumneavoastră. Microsoft
documentează o modalitate de a iniția un apel cu context: un apel nou prin SBC către un
număr înregistrat în Dynamics 365, cu UUI ale cărui chei corespund variabilelor de context
pe care le configurați în **Fluxuri de lucru → Setări avansate**
([transfer IVR de la terți](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Stabiliți împreună cu furnizorul SBC cum ajunge apelantul la acel număr atunci când
ThunderPhone închide apelul și transmiteți ID-ul conversației pe care l-ați trimis în `X-Call-ID`
pentru ca fluxul să poată găsi apelul.

Apoi preluați predarea cu un nod **Solicitare HTTP** din Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  urmat de ID-ul conversației.
- Antetul `Authorization: Bearer sk_live_…`.
- Analizați răspunsul într-o variabilă și utilizați `handoff.summary` și
  `handoff.intent`.

Consultați [Căutați un apel predat](/api-reference/calls#look-up-a-handed-off-call).

## Testați

Apelați un număr Dynamics 365 care ajunge la nodul de transfer, solicitați agentului o
persoană și verificați că apelantul revine în Dynamics 365. Apoi deschideți apelul cu
`GET /v1/calls/{call_id}`: `sip_headers` trebuie să includă `x-call-id`, iar
`external_call_id` trebuie să fie ID-ul conversației. Dacă apelul nu ajunge niciodată la
agent și jurnalele SBC indică SIP `404`, URI-ul solicitării sau antetul `To` nu conține
partea de utilizator a punctului final.

## Limite

- Este necesar un SBC. Microsoft nu poate apela o adresă SIP și nu poate răspunde la o
  provocare digest.
- Microsoft trimite cel mult cinci antete X și păstrează doar primele cinci pentru un
  apel primit. Dynamics 365 acceptă cel mult 128 de caractere de UUI.
- Microsoft nu documentează citirea antetelor într-un `BYE`, astfel că predarea revine
  numai prin căutare.
