Open in
Connecter depuis Genesys Cloud
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 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) :
- 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-Useret l'encodage Hex. - Reprise et transfert, afin que Genesys accepte le
REFERde l'agent.
- En-têtes de conversation, afin que Genesys envoie son identifiant de conversation dans
1. Créer le point de terminaison SIP
Genesys répond à une demande d'authentification Digest. Utilisez donc un point de terminaison standard :
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 :
- 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. - Ajoutez une action Transférer vers un numéro avec le
sip_uridu point de terminaison, par exemplesip: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
et En-têtes dans l'adresse de transfert) :
{
"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 deCall.UUIData. - Identifiants : votre clé API, envoyée sous la forme
Authorization: Bearer sk_live_…. - Sortie : mappez
handoff.summaryethandoff.intentvers des variables de flux.
Voir Rechercher un appel transféré.
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’
INVITEinitial et ne peut donc rien lire depuis leREFERde 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.