Open in
Connecter depuis Talkdesk
Envoyez les appels Talkdesk à un agent ThunderPhone avec Connect to Autopilot Voice, puis faites-les remonter avec l’identifiant de transfert dans l’UUI.
Votre flux Talkdesk Studio envoie l’appelant à l’agent avec l’identifiant
d’interaction et l’UUI. Lorsqu’un appelant a besoin d’une personne, l’agent effectue une escalade avec un
REFER SIP vers Talkdesk, et l’identifiant de transfert est placé dans une variable Studio.
Avant de commencer
- Un agent ThunderPhone et une clé API d’organisation.
- Une licence Talkdesk Conversation Orchestrator, qui couvre le composant Studio Se connecter à Autopilot Voice en mode Flux vocal externe (article de Talkdesk). Talkdesk la facture à la minute pendant que l’agent garde l’appel.
1. Créer l’endpoint SIP
Talkdesk documente uniquement une liste d’autorisation d’adresses IP. Créez donc un endpoint qui accepte les appels selon l’adresse source :
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": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'L’article de Talkdesk indique qu’il envoie l’audio via SRTP, et "srtp": "optional"
répond en SRTP lorsque Talkdesk le propose. L’article ne précise pas si Talkdesk
exige SRTP ; si Talkdesk vous indique que c’est le cas, définissez srtp sur required, ce qui
refuse les appels qui ne l’utilisent pas.
Obtenez les plages de signalisation SIP de Talkdesk auprès de Talkdesk. Chacune doit être une plage IPv4 publique
de /16 ou plus restrictive (IPv6 /48 ou plus restrictive). Consultez
les plateformes qui s’authentifient par IP source.
Talkdesk envoie les SIP depuis le réseau de Twilio, dont tous les clients Twilio
partagent les adresses. L’adresse de l’endpoint empêche donc les autres appelants d’y accéder : ne la
publiez pas.
Conservez le sip_uri de la réponse, par exemple
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Envoyer les appels avec le contexte
Dans votre flux Studio, ajoutez Se connecter à Autopilot Voice en mode Flux vocal
externe et définissez sa cible sur le sip_uri de l’endpoint avec ;transport=tls ajouté, par
exemple sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. L’endpoint
refuse les appels via UDP, que le SIP de Twilio utilise sauf indication contraire.
Talkdesk envoie :
X-Talkdesk-Interaction-Id, stocké commeexternal_call_idde l’appel ;User-to-User, encodé en hexadécimal, par exemplebusiness_hours=open. Il atteint le prompt décodé, sous la forme{{sip_uui}}.
La version 2.1 du composant peut également envoyer des En-têtes définis. La page des préférences de Talkdesk les décrit comme du JSON envoyé via un WebSocket. Confirmez donc auprès de Talkdesk qu’ils arrivent sous forme d’en-têtes SIP avant de vous y fier.
3. Récupérez l'appel
L'agent effectue une escalade avec un REFER vers l'adresse d'escalade Talkdesk, avec l'identifiant de transfert au format UUI hexadécimal dans cette adresse, le seul endroit où Talkdesk le lit.
Ajoutez ce numéro de transfert (voir
Ajouter le numéro de transfert
et En-têtes dans l'adresse de transfert) :
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}L'adresse est celle indiquée dans l'article Talkdesk. La version 2.1 du composant
lit autopilot_result= ; la version 1.7 lit escalate_to=, utilisez donc cette clé avec
la version 1.7. Le REFER se présente ainsi :
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk place la valeur dans une variable Studio. Pour obtenir le résumé et l'intention, ajoutez une étape Exécuter une action dans une intégration personnalisée créée avec Connections :
- Type d'authentification Clé API, nom de l'en-tête
Authorization, valeurBearer sk_live_…. - Requête :
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=suivi de l'identifiant de la variable. Vous pouvez également rechercher l'appel parexternal_call_idavec l'identifiant d'interaction. - Effectuez le routage selon
handoff.intentet affichezhandoff.summaryà la personne qui prend l'appel.
Voir Rechercher un appel transféré.
Testez
Démarrez un appel via le flux Studio, demandez à l'agent de vous mettre en relation avec une personne et vérifiez
que le flux continue après le composant avec l'identifiant de transfert dans sa
variable. Ouvrez ensuite l'appel avec GET /v1/calls/{call_id} :
external_call_id doit correspondre à l'identifiant d'interaction Talkdesk.
Limites
- Talkdesk lit au maximum 256 octets d'UUI et n'autorise pas les valeurs séparées par
|ou;, envoyez donc une seule valeur. L'identifiant de transfert tient dans cette limite. - Les API Talkdesk ne peuvent pas lire la transcription de l'agent. Utilisez plutôt la recherche de transfert ou
GET /v1/calls/{call_id}.