Skip to main content
The Genesys Endpoint enables you to connect your AI Agent to the Genesys Cloud CX platform using a Genesys Bot Connector.

​
Prerequisites

  • Access to Genesys Cloud.
  • Activate the Genesys Endpoint on the Cognigy.AI side:
    • If you have a shared or dedicated SaaS installation, contact Cognigy technical support.
    • If you have an on-premises installation, specify the following feature flags:
      • FEATURE_USE_GENESYS_BOT_CONNECTOR_ENDPOINT_WHITELIST="organization1,organization2". To enable the Genesys Endpoint for all organizations in your installation, use * instead of a list of organizations.
      • FEATURE_ENABLE_AGENT_ASSIST_WORKSPACE_GENESYS_CREDENTIALS_WHITELIST="organization1,organization2". Add this feature flag to use Genesys Notifications APIs with Agent Copilot. To enable this feature for all organizations within the Genesys Endpoint in your installation, use * instead of a list of organizations.

​
Generic Endpoint Settings

Learn about the generic Endpoint settings available for this Endpoint on the following pages:

​
Specific Endpoint Settings

ParameterDescription
Verify TokenA verification token for connecting the Cognigy Genesys Endpoint to the Genesys Bot Connector. This token needs to be generated on the Cognigy.AI side and can consist of letters, numbers, and punctuation marks.

​
How to Set Up

​
Setup on the Cognigy.AI Side

  1. In the left-side menu of the Project, go to Deploy > Endpoints.
  2. On the Endpoints page, click + New Endpoint.
  3. In the New Endpoint section, do the following:
    1. Select the Genesys Endpoint type.
    2. Add a unique name.
    3. Select a relevant Flow from the list.
  4. In the Configuration Information section, copy the Endpoint URL and save it for later usage in Genesys.
  5. Activate the Enable Endpoint setting.
  6. In the Genesys Bot Connector Setup section, in the Verify Token field, create a verification token for connecting the Cognigy Genesys Endpoint to the Genesys Bot Connector. The token can consist of letters, numbers, and punctuation marks. Copy this token for later use in Genesys. Save changes.

​
Setup on the Genesys Cloud CX Side

  1. Open the Genesys Cloud interface and go to Admin > Integrations.
  2. Click + Integrations in the upper-right corner.
  3. Select the Genesys Bot Connector card and click Install. Assign a unique name to your integration.
  4. On the Configuration tab, navigate to the Properties section.
  5. In the Bot Connector Handle Utterance URI field, input the Endpoint URL value saved earlier on the Cognigy side.
  6. On the Credentials tab, click +Add Credentials Field. Enter the following credentials:
    • Field Name — use verify-token as the name.
    • Value — enter the token created earlier in the Verify Token field on the Cognigy side.
  7. Click Ok, then Save.
  8. On the Details tab, click Copy Integration ID and save this ID for later use.
Your integration will be listed among integrations.
  1. Open the Genesys Developer Tools interface.
  2. From the left-side menu, select API Explorer.
  3. Navigate to Integrations > BotConnector.
  4. Select the PUT: Set a list of botConnector bots plus versions for this integration option from the list.
  5. Fill in the integrationId field with the Integration ID that you copied and saved earlier.
  6. Within the BODY editor, insert the following JSON: 
    {
   "chatBots": [
      {
         "id": "<your UUID>",
         "name": "Cognigy.AI Bot",
         "versions": [
            {
               "version": "1",
               "supportedLanguages": ["en-us"],
               "intents": [
                  {
                     "name": "Success",
                     "slots": {
                        "processedTimestamp": {
                           "name": "processedTimestamp",
                           "type": "integer"
                        }
                     }
                  }
               ]
            }
         ]
      }
   ]
}
The id field should contain your UUID, which you can create using an online UUID generator.
  1. Click Send Request.
To create a digital bot flow in Architect, configure the inbound message flow:
  1. Go to Admin > Architect and click or hover over the Flows menu and select Inbound Message.
  2. Click Add. The Create Flow dialog box opens. In the Name field, specify a unique name for the inbound message flow.
  3. Click the Divisions list and select the division in which to place the flow.
  4. Click Create Flow. The flow’s configuration page opens. To configure a flow, click Edit.
  5. Go to Toolbox. Drag the Call bot Connector action and drop it onto the messaging flow editor.
  6. In the right-side Call Bot Connector window, fill in the following fields:
    • Bot Integration — select the integration you created.
    • Bot Name — select the bot you created.
    • Bot Version — select the bot version you created.
  7. Drag the Send Response action and drop it below the Success action.
  8. Drag the Send Response action and drop it below the Failure action.
  9. In the Message Body of the Send Response actions, specify success message and fail message.
  10. Below the Send Response actions, place the Transfer to ACD action to transfer an interaction to a queueing system.
  11. In the Queue field of the Transfer to ACD action, select the queue to which you want to transfer the interaction.
  12. In the upper-left corner, click Save, then Publish.
After creating your inbound message flow, you will see this flow in the architect list.To learn more about designing the flow, see Configure Inbound Message Flow settings.
To create a new version of a messenger configuration and a messenger deployment, follow these steps:
  1. Go to Admin > Message > Messenger Configurations and click + New Configuration.
  2. In the Name field, provide a unique configuration name reflecting your bot integration.
  3. From the Select your Supported Languages list, pick UI languages and customize text labels. Browser language determines the user’s language.
  4. In the Select Default Language field, choose a default language for cases when the browser language isn’t detected or isn’t in the list. Click Save New Version. Your configuration will appear in the configuration list.
  5. Go to Admin > Message > Messenger Deployments and click + New Deployment.
  6. In the Name field, enter a unique deployment name that corresponds to your messenger configuration.
  7. From the Select your Configuration list, pick the message configuration you recently created.
  8. In the Restrict domain access section, select Allow all domains or specify trusted domains where the Messenger can run.
  9. From the Select your Architect Flow list, choose a published inbound message flow to trigger the bot behavior or connect users with agents.
  10. In the Deploy your snippet section, click Copy to Clipboard to copy a code snippet onto the website pages where you would like the Messenger to appear. After deploying the snippet, any future saved changes to the configuration and deployment will be applied automatically. Click Save. Your deployment will then appear in the deployment list.
  11. To test the AI Agent, visit CodeSandbox and select a default HTML project. Paste the copied code snippet into the <body> element of the HTML document.
To check the AI Agent’s performance, access the installation that your server administrator has deployed.

​
(Optional) Activate AI Copilot

If you want to use AI Copilot and Notifications APIs within the Genesys integration, create credentials on the Genesys side and configure the Copilot settings in the Endpoint.
To configure credentials, follow these steps:
  1. Open the Genesys Cloud interface and go to Admin > Integrations > OAuth. Click + Add Client.
  2. On the Client Details tab, provide a unique name in the App Name field.
  3. On the Roles tab, activate the corresponding role for the client.
  4. Return to the Client Details tab and select Client Credentials in the Grand Types list. Click Save.
  5. Copy the Client ID and Client Secret and save them for future use.
  6. From the left-side menu, select Authorized Applications. In the upper-right corner, click + Authorize a Client.
  7. In the Authorize Client window, enter the Client ID that you copied and saved previously. Click Authorize Client.
To configure the AI Copilot workspace settings, follow these steps:
  1. In the Genesys Endpoint settings, navigate to the Copilot section.
  2. Configure AI Copilot by creating an AI Copilot config and adding a Flow. For more information, refer to the AI Copilot documentation.
  3. Set up Genesys Cloud Credentials:
    • Connection Name — create a unique name for your connection.
    • oAuth2Url — enter the login URL for Genesys Cloud customers, which varies by region, such as mypurecloud.de for Germany. You can use the base domain like mypurecloud.com or cac1.pure.cloud, omitting the apps. or login. part. For more information on Genesys Cloud regions, refer to AWS regions for deployment.
    • oAuth2ClientId — enter the Client ID that you generated on the Genesys side.
    • oAuth2ClientSecret — enter the Client Secret that you generated on the Genesys side.
    • oAuth2Scope — enter *. This system field is only necessary for authorizing the application.
  4. Click Create, then Save.

​
What’s Next?

Now you can configure Say, Question, and Optional Question Nodes by selecting the Genesys channel in the Node Editor settings. It’s important to create messages that are compatible with the Genesys Endpoint, as the Genesys channel supports a limited set of output types.
⌘I