Skip to main content

Genesys Purecloud live connects with Genesys Purecloud Live, enabling users to interact with live agents. This integration helps by linking live agents from your Genesys Purecloud account with users assisted by your bot.


  1. An active Geneysys Purecloud live account
  2. An active account

Only text and images are being supported from both the user and agent side.

Obtain integration credentials from Genesys Purecloud

To connect your platform with Genesys Purecloud account, you need to perform the following actions in your Genesys Purecloud account to obtain the credentials to input in your platform.

Step 1: Create a user role

Create a custom role with certain scopes and assign that custom role to the user profile responsible for handling incoming chats from bot. To do so:

  1. Go to Admin > Roles/ Permissions.

  2. Click +Add role.

  3. In Role Details enter a name for the role and describe it. Click Permissions and enable the below mentioned scopes for the role. You can search for the scopes in the highlighted search box and click Save.

  • Messaging > Integration > All Permissions

  • Conversation > Message > All Permissions

  • Process Automation > Trigger > All Permissions

  1. Go to People and click the ellipsis button beside the name of the individual for whom the role was created. Click Edit Person.

  1. Choose All under View, enable the custom role you created in step 3 and click Save. By this way you assign the role to the respective person.

Step 2: Create an OAuth client

You need to create an OAuth client to retrieve Client ID and Client secret for your Genesys login. This OAuth client is created for the role you created in the previous step.

  1. Go to Admin > Integrations > OAuth.

  2. Click + Add client.

  3. Enter a name for your app and choose Client Credentials under Grant type.

  4. Go to Roles and choose the custom role you created in the previous section.

  5. Click Save.

    OAuth client gets created. Copy the Client ID and Client Secret.

Step 3: Add's webhook in Genesys

You need to create an integration to add's webhook in Genesys. This helps Genesys to inform the bot about user chat actions, such as drop-offs, responses, or chat endings.

  1. Go to Admin > Message > Platforms > + Create new integration > Open Messaging.

  2. Fill in the following fields:

  • In Name, enter a name for your integration.
  • In Outbound Notification Webhook URL, enter or any test URL.

A webhook is generated once the integration is established in Initially, you can provide a test URL to configure the integration. After setting it up, we'll retrieve the webhook from We will show the process in the upcoming steps.

iii. In Outbound Notification Webhook Signature Secret Token, enter an integration ID and click Save.

  1. Once you save, your integration ID will be generated. Copy it from the URL.

Step 4: Add a message route

Message route helps in rotuing the messages from bot to the live agent on Genesys.

  1. Create a flow in Genesys Purecloud. This flow should be based on the process the chat should reach the agent. Click here for steps.

  2. After creating the flow, go to Admin > Routing > Message Routing.

  3. Click + in right corner.

  4. Select the flow you created in 1 and in Addresses select the integration you created in the previous step. Click Save.

Authenticate Genesys Purecloud Live in

Enter the Client ID, Client Secret and integration ID obtained from the previous sections.

  1. Go to > Integrations > search for Genesys Purecloud Live.

  1. Fill in the following fields:
  • Give account name: Provide a name to your account.
  • Host URL: The URL of your genesys account.
  • Client ID: Client obtained in Step 2.
  • Client Secret: Client Secret obtained in Step 2.
  • Integration ID: Integration ID obtained in Step 3.
  1. Click Connect.

  2. Once the integration is setup, copy the Webhook URL by clicking on it.

  3. Go to your Genesys Purecloud Live account > Admin > Message > Platforms > integration you created in Step 3. > Configure

  4. Paste the copied Webhook in Outbound Notification Webhook URL and click Save.

Activate Genesys event in your bot

  1. Go to Studio and click Event > Integrations.

  2. Search for Genesys and click more options > Activate.


If you have added multiple accounts in your platform, enable events for each of those accounts.

Close Genesys chats in sync with

To end the chat in Genesys when a customer ends the chat in, you need to set up a workflow.

  1. Go to Admin > Integrations > Web Services Data Actions > Install. Install it and enable it.

  2. Go to Actions > + Add Action > Choose the integration enabled in the previous step.

  3. Provide a name to the action and click Add.

  4. After creating the action, go to Setup > Input Contract and paste the JSON given below the image.


"title": "data",
"type": "object",
"required": [
"properties": {
"to": {
"description": "To Address",
"type": "string"
"disconnectType": {
"description": "The type of disconnection",
"type": "string"
"conversationId": {
"description": "conversationId",
"type": "string"
"eventName": {
"description": "Event Name",
"default": "conversation-resolved",
"type": "string"
"additionalProperties": true

  1. Go to Configuration, in Request URL Template, paste the webhook URL(copied from bot) and select the method as POST. After this, click Save & Publish.

  2. Go to Admin > Architect. Hover over Flows and click Workflow.

  3. Click + Add and create a new workflow.

  1. Add three String variables. To add a variable go to Data > enter a name for the variable and click Create.

  2. Click the variable to add details.

Enable Input to flow in each variable and pass an initial value for the variable which disconnects the chat when the user ends it.

  1. Go back to Initial state and below the Start node, add a Call Data Action node. To do so, click the arrow below Start node and go to Toolbox > Data > Call Data Action.

  2. Once you add the node, in Category select Web Services Data Actions and in Data Action select the action you created in step 3.

  3. Once you select the action, corresponding fields will display. Pass the variables you created in step 8.

  4. Click Save to save your settings, and then click Publish.


Make sure to keep the workflow ID found in the URL handy, as it will be necessary to access the API.

Connect bot users to live agents on Genesys


Use Ticket-closed in the Raise Ticket node to perform specific actions when a live chat closes, instead of using the ticket-close event.

  1. Go to Studio and build a flow based on how you want the bot to take the user through the process.

  2. Include the Raise ticket node at the point in the flow where you want to let the user talk to Genesys live agent. To accomplish this, include a Raise ticket node and choose Genesys PureCloud Live Agent under Live chat agent.

  1. Fill in the following fields in the node. The variables chosen for these fields must be previously collected in the flow via node. To know more about this in detail, click here.
Field nameData typeDescriptionSample value
Live chat agent--Choose Genesys PureCloud Live agent in the drop-down
Account nameStringChoose the Genesys account to which the chats should be transferredaccount1
Message after ticket assignmentStringThe message that will be displayed to the end user after a ticket is successfully assigned to an agentRequesting live agent connection.
NameStringName of the end userJohn
MobileStringMobile number of the end user9876543210
EmailStringEmail address of the end user. This is a mandatory field[email protected]
QueryStringThe subject/topic/reason why the ticket was createdI have a concern regarding my flight ticket
PriorityStringThe priority of the ticketMEDIUM

You can enable Advanced Options to set the priority, auto-translation, custom fields, tags and department.

  1. Once you have set up the flow, chats will get automatically forwarded to live agents on Genesys live chat when this flow gets triggered.


On bot


On Genesys Purecloud Live


Document Reference