---
title: "Connecter depuis Genesys Cloud"
description: "Envoyez des appels Genesys Cloud vers un agent ThunderPhone via un trunk BYOC Cloud avec l’identifiant de conversation et l’UUI, puis récupérez-les avec le transfert dans l’UUI."
---

Votre flux Architect envoie l'appelant à l'agent via un trunk BYOC Cloud, avec l'identifiant de conversation et toute UUI que vous définissez. Lorsque l'appelant a besoin d'une personne, l'agent envoie un `REFER` SIP, Genesys reprend l'appel et l'identifiant de transfert arrive dans l'UUI de l'appel.

## Avant de commencer

- Un agent ThunderPhone et une [clé API](/fr/guides/api-keys) d'organisation.
- Genesys Cloud avec BYOC Cloud, et un trunk externe (type BYOC Carrier ou PBX) avec les paramètres suivants activés
  ([paramètres de trunk externe](https://help.genesys.cloud/articles/external-trunk-settings/)) :
  - **En-têtes de conversation**, afin que Genesys envoie son identifiant de conversation dans
    `x-inin-cnv`. Cette option est désactivée par défaut.
  - **Transmission UUI**, avec le type d'en-tête `User-To-User` et l'encodage Hex.
  - **Reprise et transfert**, afin que Genesys accepte le `REFER` de l'agent.

## 1. Créer le point de terminaison SIP

Genesys répond à une demande d'authentification Digest. Utilisez donc un point de terminaison standard :

```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": "Genesys Cloud"}'
```

Enregistrez immédiatement le `password` de la réponse ; il n'est affiché qu'une seule fois. Sur le
trunk :

| Paramètre | Valeur |
|---|---|
| Serveur SIP | `sip.thunderphone.com`, port `5061` |
| Protocole | TLS |
| Authentification Digest | le `username` et le `password` du point de terminaison |
| Codecs | PCMU, PCMA ou G.722 |

Placez le trunk sur une route sortante de votre site dont le plan de numérotation couvre l'adresse que le flux compose.

## 2. Envoyer les appels avec du contexte

Dans votre flux Architect :

1. Vous pouvez ajouter une action **Définir les données UUI** avec du contexte pour l'agent, par
   exemple `account=12345`. Genesys recommande 128 caractères ou moins.
2. Ajoutez une action **Transférer vers un numéro** avec le `sip_uri` du point de terminaison, par
   exemple `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys envoie l'identifiant de conversation dans `x-inin-cnv`. ThunderPhone le stocke comme
`external_call_id` de l'appel. L'UUI atteint le prompt décodée, sous la forme
`{{sip_uui}}`.

Les en-têtes personnalisés du trunk sont statiques dans Genesys. Placez donc les valeurs propres à chaque appel dans l'UUI.
Genesys réserve pour son usage les préfixes d'en-tête `x-inin`, `x-genesys`, `x-pcv` et `x-gcv`.

## 3. Récupérer l'appel

L'agent transfère avec un `REFER` vers une adresse sur Genesys, avec l'identifiant de transfert sous forme d'UUI hexadécimale dans cette adresse. 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": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Remplacez l'adresse par une adresse qui redirige vers la file d'attente ou le flux qui doit
prendre l'appelant ; confirmez son format avec Genesys. Le `REFER` ressemble à ceci :

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

Lorsque **Reprise et transfert** est activé, Genesys reprend l'appel depuis le trunk
et le redirige vers cette adresse. Genesys indique que les UUI entrantes sont placées dans
`Call.UUIData` ; cette information n'est pas documentée pour une reprise d'appel. Confirmez donc avec
Genesys, ou lors d'un appel de test, que le flux qui reçoit l'appelant y trouve
l'identifiant de transfert. Pour obtenir le résumé et l'intention, appelez la recherche de transfert avec
une **Action de données d'appel** sur une intégration Web Services Data Actions :

- Requête : `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  suivie de l'identifiant provenant de `Call.UUIData`.
- Identifiants : votre clé API, envoyée sous la forme `Authorization: Bearer sk_live_…`.
- Sortie : mappez `handoff.summary` et `handoff.intent` vers des variables de flux.

Voir [Rechercher un appel transféré](/api-reference/calls#look-up-a-handed-off-call).

## Tester

Appelez un numéro qui atteint le flux, demandez à l’agent une personne, puis vérifiez que
Genesys achemine l’appel vers l’adresse définie. Dans ce flux, vérifiez que
`Call.UUIData` contient l’identifiant de transfert sous forme de texte (s’il affiche des chiffres hexadécimaux, vérifiez que l’encodage UUI du trunk est défini sur Hex). Ouvrez ensuite l’appel avec `GET /v1/calls/{call_id}` :
`external_call_id` doit correspondre à l’identifiant de conversation.

## Limites

- L’action **Obtenir les en-têtes SIP** lit uniquement l’`INVITE` initial et ne peut donc
  rien lire depuis le `REFER` de l’agent. Le transfert atteint Genesys uniquement
  via UUI.
- Genesys supprime toutes les données UUI lorsqu’un appel comporte plus d’un en-tête UUI.
- L’adresse de transfert est limitée à 254 caractères ; une longue UUI est donc tronquée.
  Un identifiant de transfert tient toujours.
