---
title: "Se connecter depuis Microsoft Dynamics 365"
description: "Envoyez les appels de Dynamics 365 Contact Center et Copilot Studio vers un agent ThunderPhone via votre SBC avec des en-têtes X, et recherchez le transfert de l’agent via HTTP."
---

Dynamics 365 Contact Center envoie l'appelant à l'agent via votre contrôleur de
bordure de session (SBC), avec jusqu'à cinq en-têtes X, dont l'identifiant de
conversation. Lorsque l'agent a terminé, il raccroche, votre SBC renvoie
l'appelant dans Dynamics 365, et un nœud Requête HTTP récupère le transfert.

## Avant de commencer

- Un agent ThunderPhone et une [clé API](/fr/guides/api-keys) d'organisation.
- Le canal vocal Dynamics 365 Contact Center, connecté via le **Routage direct**
  d'Azure Communication Services à un SBC que vous exploitez
  ([exigences relatives au SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)) :
  un SBC pris en charge avec un certificat public, TLS 1.2 sur le port 5061 et
  SRTP vers Microsoft.
- La **prise en charge des en-têtes SIP X** sur le nœud **Transférer la
  conversation**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Vérifiez qu'elle est disponible dans votre environnement.

Dynamics 365 transfère uniquement vers un numéro de téléphone, et Microsoft
authentifie le Routage direct par certificat, et non par mot de passe. Votre SBC
se place entre Microsoft et ThunderPhone et transforme ce numéro en adresse SIP
de l'agent.

## 1. Créez le point de terminaison SIP

L'appel atteint ThunderPhone depuis votre SBC. Créez donc un point de
terminaison standard que le SBC pourra utiliser :

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

Enregistrez immédiatement le `password` de la réponse ; il n'est affiché
qu'une seule fois, et votre SBC répond à la demande d'authentification de
ThunderPhone avec celui-ci. Si votre SBC ne peut pas utiliser l'authentification
Digest, créez plutôt le point de terminaison avec `auth` défini sur
`ip_allowlist` et l'adresse publique de votre SBC ; consultez
[Plateformes qui s'authentifient par IP source](/fr/guides/sip-addresses).

## 2. Envoyez les appels avec le contexte

1. Choisissez un numéro de téléphone pour l'agent sur votre SBC, par exemple
   `+14155550188`.
2. Sur le SBC, acheminez les appels vers ce numéro vers le `sip_uri` du point
   de terminaison, par exemple `sip:agent-12-jhxmginwjx@sip.thunderphone.com`,
   via TLS sur le port `5061`. ThunderPhone identifie le point de terminaison
   par la partie utilisateur (`agent-12-jhxmginwjx`), qui doit figurer à la
   fois dans l'URI de requête et dans l'en-tête `To`. Transmettez les en-têtes
   X sans les modifier.
3. Dans Copilot Studio, ajoutez un nœud **Transférer la conversation** avec
   **Transfert vers un numéro de téléphone externe** vers ce numéro, puis
   ajoutez les en-têtes X :
   - `X-Call-ID` : l'identifiant de conversation Dynamics 365. Aucun en-tête
     Microsoft ne le contient ; ajoutez-le donc ici. ThunderPhone l'enregistre
     comme `external_call_id` de l'appel. Vérifiez dans Copilot Studio quelle
     variable contient l'identifiant de conversation.
   - Jusqu'à quatre autres, par exemple `X-Customer-Tier`.

Microsoft envoie au maximum cinq en-têtes X, avec des noms de 64 caractères
maximum et des valeurs de 256 caractères maximum, composés de lettres, de
chiffres et de `= ; . ! % * _ + ~ -`. Il écrit le préfixe en minuscules
`x-` ; ThunderPhone compare les noms d'en-tête sans tenir compte de la casse.
Ainsi, `x-customer-tier` atteint le prompt sous la forme
`{{sip_x_customer_tier}}`.

Si vous créez plutôt l'appel avec Azure Communication Services Call Automation,
`AddSipX` écrit par défaut des noms `X-MS-Custom-`. Transmettez
`SipHeaderPrefix.X` afin que `X-Call-ID` conserve son nom
([contexte personnalisé](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Récupérer l’appel

L’agent restitue l’appel : il dit au revoir et raccroche. Ajoutez ce numéro de
transfert (voir
[Ajouter le numéro de transfert](/fr/guides/contact-centers/overview)) :

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

C’est à votre SBC qu’il revient de ramener l’appelant dans Dynamics 365. Microsoft
documente une méthode d’entrée pour un appel avec contexte : un nouvel appel via le SBC vers un
numéro enregistré dans Dynamics 365, avec des UUI dont les clés correspondent aux variables de contexte
que vous avez configurées dans **Flux de travail → Paramètres avancés**
([transfert vers un SVI tiers](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Déterminez avec votre fournisseur SBC comment l’appelant atteint ce numéro lorsque
ThunderPhone raccroche, et transmettez l’identifiant de conversation que vous avez envoyé dans `X-Call-ID`
afin que le flux puisse retrouver l’appel.

Récupérez ensuite le transfert avec un nœud **Requête HTTP** de Copilot Studio :

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  suivi de l’identifiant de conversation.
- En-tête `Authorization: Bearer sk_live_…`.
- Analysez la réponse dans une variable et utilisez `handoff.summary` et
  `handoff.intent`.

Consultez [Rechercher un appel transféré](/api-reference/calls#look-up-a-handed-off-call).

## Testez

Appelez un numéro Dynamics 365 qui atteint le nœud de transfert, demandez à l’agent
d’être mis en relation avec une personne et vérifiez que l’appelant revient dans Dynamics 365. Ouvrez ensuite
l’appel avec `GET /v1/calls/{call_id}` : `sip_headers` doit répertorier `x-call-id`, et
`external_call_id` doit correspondre à l’identifiant de conversation. Si l’appel n’atteint jamais
l’agent et que votre SBC journalise un SIP `404`, son URI de requête ou son en-tête `To` ne contient pas
la partie utilisateur du point de terminaison.

## Limites

- Un SBC est requis. Microsoft ne peut pas appeler une adresse SIP ni répondre à une
  demande d’authentification Digest.
- Microsoft envoie au plus cinq en-têtes X et ne conserve que les cinq premiers pour un
  appel entrant. Dynamics 365 accepte au plus 128 caractères d’UUI.
- Microsoft ne documente pas la lecture des en-têtes sur un `BYE`, les données de transfert
  ne reviennent donc que via la recherche.
