ThunderPhone v3 est disponible.En libre-service, à partir de 2 ¢/min.Découvrir l’annonce

Contact centers

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

  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é).

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.summary et handoff.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.