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

Contact centers

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-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 :

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ètreValeur
Serveur SIPsip.thunderphone.com, port 5061
ProtocoleTLS
Authentification Digestle username et le password du point de terminaison
CodecsPCMU, 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 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 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é.

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.