---
title: "Connecter depuis Talkdesk"
description: "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](/fr/guides/api-keys) d’organisation.
- Une licence Talkdesk **Conversation Orchestrator**, qui couvre le composant Studio
  **Se connecter à Autopilot Voice** en mode **Flux vocal externe**
  ([article de Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  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 :

```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": "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](/fr/guides/sip-addresses).
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](/fr/guides/contact-centers/overview)
et [En-têtes dans l'adresse de transfert](/fr/guides/call-transfers)) :

```json
{
  "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é](/api-reference/calls#look-up-a-handed-off-call).

## 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}`.
