Intégration avec Genesys Audio Connector

Avant de commencer

Vous devez disposer des conditions préalables suivantes avant de commencer à intégrer votre assistant à Genesys Audio Connector :

• Créez un nouveau compte ou connectez-vous à un compte Genesys Cloud existant disposant d'un accès à Genesys Architect et à la région appropriée sur le portail Genesys Cloud.

• Le rôle 'Admin dans l'organisation Genesys Cloud.

Pour plus d'informations sur les rôles et les autorisations dans Genesys Cloud, consultez la section « Présentation des rôles et des autorisations ».

Créez l'intégration Audio Connector dans votre assistant

1. Accédez à la page « Intégrations » en cliquant sur l'icône des intégrations () dans le menu de gauche.

Conservez les informations d'identification car vous ne pourrez plus les voir après avoir cliqué sur Enregistrer. Vous avez besoin de ces informations d'identification pour configurer le connecteur audio Genesys.

1. Cliquez sur Ajouter dans la tuile Téléphone.

2. Cliquez sur la tuile Genesys Audio Connector.

3. Dans la section " Credentials", copiez et enregistrez les informations d'identification générées automatiquement dans les champs suivants :

   • Clé d'API

   • Secret client

   • URI de connexion audio Genesys

   • ID du connecteur Bot

4. Cliquez sur Sauvegarder et quitter.

Configurer le connecteur audio pour intégrer l'assistant

Pour configurer Genesys Audio Connector, suivez les étapes décrites dans la rubrique « Configurer et activer Audio Connector dans Genesys Cloud ».

Dans la page Genesys Admin, allez dans Intégrations > Configuration pour ajouter la valeur URI Genesys audio connect que vous avez copiée lors de la création de l'intégration Audio Connector dans votre assistant.

Dans la page Genesys Admin, allez dans Intégrations > Credentials pour ajouter les informations d'identification pour les champs API key et Client secret que vous avez copiés lors de la création de l'intégration Audio Connector dans votre assistant.

Partage du contexte grâce aux variables de session

À partir du nœud « Audio Connector » dans le flux Genesys Architect, vous pouvez définir des variables de session qui permettront de transmettre des informations au générateur d'assistants IA. Vous pouvez spécifier les paramètres d'entrée et de sortie. Pour l'intégration, ces deux paramètres sont regroupés en un seul objet sous context l'objet.

Les paramètres d'entrée et de sortie sont tous deux disponibles dans l 'assistant IA context, et les informations sont partagées à chaque tour. Par exemple, la context fonctionnalité disponible dans l 'assistant IA est la suivante :

{
  "context": {
    "integrations": {
      "genesys_audio_connector": {
        "user_id": "<SENT FROM GENESYS>",
        "some_variable": "<SET_FROM_WATSON_ASSISTANT>"
      }
    }
  }
}

Accédez aux paramètres d'entrée de votre assistant IA à l'aide de la variable de session « ${system_integrations.genesys_audio_connector.user_id} ».

Pour définir les paramètres de sortie, utilisez une expression telle que ${system_integrations.genesys_audio_connector.some_variable}, à laquelle vous pourrez accéder ultérieurement dans votre flux.

Procédez comme suit pour définir une variable de sortie :

1. Accédez à l'étape des actions de l'assistant IA où vous souhaitez définir la variable.

2. Cliquez sur Définir une nouvelle variable et sélectionnez Expression.

3. Entrez l'expression suivante :

${system_integrations.genesys_audio_connector.<variable_name>} = "<variable_value>"

Exemple :

${system_integrations.genesys_audio_connector.some_variable} = "this is an output variable"

Dans cet exemple, le nom de la variable est some_variable, avec la valeur "ceci est une variable de sortie".

Fin du flux du connecteur audio Genesys

Après avoir reçu la conversation audio de l'utilisateur, le nœud Audio Connector de Genesys Architect facilite l'échange de messages entre l'utilisateur et l'assistant jusqu'à la fin de la conversation. Pour renvoyer la conversation audio à Genesys, vous devez utiliser le type de réponse " end_session

{
  "generic": [
    {
      "response_type": "text",
      "values": [
        {
          "text": "You have ended the call."
        }
      ]
    },
    {
      "response_type": "end_session"
    }
  ]
}

Types de réponse

Une fois votre générateur d'assistants IA intégré à Genesys Audio Connector, vous pouvez utiliser les types de réponse suivants dans l'assistant :

• texte

• Option

• end_session

• speech_to_text

• text_to_speech

• start_activities

• stop_activities

• dtmf

• utilisateur_défini

• connect_to_agent

• image

• audio