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

Contact centers

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é comme external_call_id de l’appel ;
  • User-to-User, encodé en hexadécimal, par exemple business_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, valeur Bearer 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 par external_call_id avec l'identifiant d'interaction.
  • Effectuez le routage selon handoff.intent et affichez handoff.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}.