Open in
Se connecter depuis Microsoft Dynamics 365
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 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) : 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). 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 :
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.
2. Envoyez les appels avec le contexte
- Choisissez un numéro de téléphone pour l'agent sur votre SBC, par exemple
+14155550188. - Sur le SBC, acheminez les appels vers ce numéro vers le
sip_uridu point de terminaison, par exemplesip:agent-12-jhxmginwjx@sip.thunderphone.com, via TLS sur le port5061. 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êteTo. Transmettez les en-têtes X sans les modifier. - 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 commeexternal_call_idde 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é).
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) :
{"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).
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.summaryethandoff.intent.
Consultez Rechercher un appel transféré.
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.