The Kore.ai XO Platform allows you to add Genesys Cloud CX Messaging as a messaging channel for your Virtual Assistants (VAs). Genesys Cloud CX Messaging integration helps instantly share your ideas with people inside your organization with the persistent chat history feature to start a conversation with your colleagues and continue it anywhere, anytime. .
Note: This integration works only with Genesys Cloud CX Messaging channel, not the older Genesys web chat.
With the Genesys Cloud CX Messaging channel integration on the Kore.ai XO Platform, you can achieve the following:
- Set up the REST API and authorization flow for events and conversations.
- Link the app to the Kore.ai XO Platform using the app’s credentials.
- Deploy the VAs and transfer conversations to a live agent in Genesys Cloud CX Messaging platform.
- Leverage various templates like Button, Quick Replies, and Bullets List provided by Genesys for message formatting.
- Accept any attachments in the chat messages that Genesys supports.
After the integration, you can do the following:
- Track Virtual Assistant conversations.
- Listen to new messages from Genesys Cloud CX Messaging.
- Have VAs post and respond to messages in Genesys Cloud CX Messaging conversations.
- Have VAs handle incoming notifications from your apps into Genesys Cloud CX Messaging.
To set up Genesys Cloud CX Messaging as a channel, use your account on the Genesys Cloud Platform and enable a webhook for the platform to receive messages.
The steps to add the channel are summarized below:
Step 1: Create a Bot Connector
A Bot Connector integration enables your bot to exchange messages with the Genesys Agent System configured on the Kore.ai XO Platform by using industry-standard REST and JSON over HTTPS.
- Log in to https://login.mypurecloud.com.
- Create a Bot Connector with the steps below:
On the Genesys Cloud CX Admin portal
On the Kore.ai XO Platform
-
-
- On the Kore.ai XO Platform, navigate to Deploy > Channels > Genesys Cloud CX Messaging.
- Copy the Webhook URL from the Configurations section of the Kore.ai XO Platform for the Genesys Cloud CX Messaging Channel screen.
On the Genesys Cloud CX Admin portal
On the Kore.ai XO Platform
-
- In the Genesys Cloud login URL field under Configuration, provide the URL of your Genesys AWS Region, which will allow the platform to route the conversation requests correctly. This is a mandatory field. You can find the URL of your region through the link provided in the field description on the screen.
- Leave the Genesys Cloud CX Messaging channel configuration open for further configuration.
- In the Genesys Cloud login URL field under Configuration, provide the URL of your Genesys AWS Region, which will allow the platform to route the conversation requests correctly. This is a mandatory field. You can find the URL of your region through the link provided in the field description on the screen.
- On the Kore.ai XO Platform, navigate to Deploy > Channels > Genesys Cloud CX Messaging.
-
-
Step 2: Create an App on the Kore.ai XO Platform
- Create an app on the Kore.ai XO platform. A JWT Token is created with the clientId and clientSecret credentials. For more information, read Adding the Web/Mobile Client Channel article.
- Click the Create App link under the Configurations section of the Genesys Cloud CX Messaging Channel.
- Use the Client ID and Client Secret value of the new app to create a JWT token using the steps mentioned here.
- Navigate back to the Bot Connector configuration screen in the Genesys Cloud Admin portal.
- Navigate to the Configuration > Credentials section and click Change.
- Create a new Field Name called Authorization.
- Paste the following in the Value field on the Change Credentials window.
- Click Ok.
- Click the Create App link under the Configurations section of the Genesys Cloud CX Messaging Channel.
-
Step 3: Create the OAuth Client App on Genesys Developer Console
- Steps to create an app on the Genesys Developer Console:
- Log in to the Genesys Developer Portal.
- Navigate to Admin > Integrations > OAuth.
- Click Add Client on the OAuth Screen.
- Enter the App Name and Description.
- Select the Grant Types as Code Authorization.
- Copy the Callback URL from the Configurations tab of the Kore.ai XO Platform for Genesys Cloud CX Messaging channel.
- In the Genesys Console, go back to the Integrations > OAuth page and paste the Callback URL that you have copied in the Authorized redirect URI field.
- Add the architect, integrations, and textbot scopes in the Scopes field.
- Click Save to update the OAuth Client configuration.
- Copy the Client ID and Client Secret from the OAuth Client App page.
- In the Kore.ai XO Platform, return to the Deploy > Channels > Genesys Cloud CX Messaging > Configurations tab and paste the Client ID and Client Secret values.
- Once you paste all the required credentials, click Authorize to validate the authorization.
- If you are still logged into your Genesys Cloud instance, your current credentials are used. Otherwise, a login screen will open. Use valid credentials for the Genesys cloud instance you are configuring
Your Bot Connector is created successfully!
Step 4: Create an Inbound Message Flow
To create an inbound message flow after connecting your VA to the Bot Connector, follow the steps below:
- Navigate to Admin > Architect on the Genesys Bot Connector page.
- Click the Flows: Inbound Message tab.
- Click the Add button.
- In the Create ‘Inbound Message Flow’ window, enter the values for the required fields.
- Click Create Flow.
After creating the Inbound Message Flow, follow these steps:
Step 5: Configure the Messenger SDK
After creating the inbound messaging flow, you should configure and deploy the messenger with the steps below:
- Navigate to the Genesys Cloud CX Admin portal.
- Navigate to Admin > Message > Messenger Deployments.
- Enter the values for Name and Description.
- Set Status to Active.
- For Select your Configuration, select the Messenger Configuration to assign it to the deployment.
- For Restrict Domain Access, select Allow all domains.
- For Select your Architect Flow, select your Message Flow created in the previous step.
- Click Save. The system routes the message sent by the user via the Genesys Messenger to the message flow.
- Paste the script generated in the messenger deployment on the HTML page where you want to add the Genesys Messenger.
Step 6: Enable the Channel
After you’ve configured the Genesys Messenger and deployed it for your Virtual Assistant, you must enable the Genesys Cloud CX Messaging Channel by following the steps below:
- Navigate to Deploy > Channels > Genesys Cloud CX Messaging on the Kore.ai XO Platform.
- Click the Configurations tab.
- Select YES for Enable Channel.
- Click Save.
Step 7: Publish the Bot
After enabling the channel and verifying all the configurations, you can test the new channel integration by publishing your virtual assistant. Learn more.
To learn more about working with messaging channels within the Kore.ai XO Platform, see Channel Enablement.