Integrating with Genesys Audio Connector

Before you begin

You must have the following prerequisites before you start integrating your assistant with Genesys Audio Connector:

• A new account or log in to an existing Genesys Cloud account with access to Genesys Architect and the correct region at the Genesys Cloud portal.
• The Admin role in the Genesys Cloud organization. For more information on Genesys Cloud roles and permissions see, Roles and permissions overview.

Create the Audio Connector integration in your assistant

1. Go to the Integrations page by clicking the integrations icon () in the left menu.

Store the credentials because you cannot see them after you click Save. You require these credentials to set up the Genesys Audio Connector.

1. Click Add on the Phone tile.

2. Click Genesys Audio Connector tile.

3. In the Credentials section, copy and store the automatically generated credentials in the following fields:

   • API key
   • Client secret
   • Genesys audio connect URI
   • Bot Connector ID

4. Click Save and Exit.

Set up Audio Connector to integrate assistant

To set up Genesys Audio Connector, complete the steps in the Configure and activate Audio Connector in Genesys Cloud topic.

In the Genesys Admin page, go to Integrations > Configuration to add the Genesys audio connect URI value that you copied while creating the Audio Connector integration in your assistant.

In the Genesys Admin page, go to Integrations > Credentials to add the credentials for the API key and Client secret fields that you copied while creating the Audio Connector integration in your assistant.

Context-sharing through session variables

From the Audio Connector node in the Genesys Architect flow, you can specify session variables that can be used to pass information to watsonx Assistant. You can specify both Input and Output parameters. For the integration, both of these parameters are merged into a single object under the context object.

Both Input and Output parameters are available in the watsonx Assistant context, and the information is shared on each turn. For example, the context made available in watsonx Assistant is:

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

For Input parameters, you can access the session variable in watsonx Assistant with $integrations.genesys_audio_connector.user_id.

For Output parameters, you can assign the session variables to a state variable in Genesys (for example, State.some_variable and access them later on in your flow).

Variables can be read and set from both Dialog and Action skills.

Ending the Genesys Audio Connector flow

After receiving the audio conversation from the user, the Audio Connector node in Genesys Architect facilitates exchange of messages between the user and assistant until the end of conversation. To send the audio conversation back to Genesys, you must use the end_session response type.

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

Response types

After integrating your watsonx Assistant with Genesys Audio Connector, you can use the following response types in the assistant:

• text
• option
• end_session
• speech_to_text
• text_to_speech
• start_activities
• stop_activities