Genesys Livechat connector


If you are using the Genesys livechat solution, Dydu can couple its solution to the Genesys livechat to perform a seamless escalation from chatbot to human.

We will detail below the configurations needed in both the Dydu BMS and Genesys to establish interoperability between the 2 applications.

We currently support the connexion between our solutions and Genesys Cloud. If you are a Genesys on-premise user, interoperability is not available at the moment.

If you do not know yet how to perform an escalation from chatbot to livechat, check this article first.

Step 1 - Configurations in the Dydu BMS

1. Activate the Livechat tab

The Livechat tab is hidden by default in your BMS. You need to activate it firt in the preference options.

  • Navigate to Preference - Bot - General - Livechat escalation - escalation type and select GENESYS in the dropdown list.

  • Save your choice and the sub-menu Livechat parameters will appear under the Preference tab.

Navigate to Preferences > Livechat parameters > External connectors.

In this section, you need to provide 3 types of information:

  • (Mandatory) Genesys connector

  • (Optional) Identity mapping

  • (Mandatory) Dydu competency and Genesys queue mapping

Below are details about how to fill out each field:

Genesys connector

This is the metadata of the Genesys connector that you will retrieve via the Genesys interface.

Here you need to fill in 3 fields:

  • Domain: select the domain name of your Genesys Cloud API in the drop-down list. It varies depending on the location of your Genesys Cloud data center. If you don’t know your Genesys domain, contact the Genesys Cloud administrator of your organization.

  • Client ID and Client Secret retrievable in Genesys. (Refer to the section below "Configurations in Genesys" for more details).

Identity mapping

If you want the Livechat operator to know the identity of your Livechat user to offer a more personalized conversation experience, you should first create a knowledge item in the BMS using variables that will capture this information the chatbot can communicate to the Livechat agent.

Genesys offers 3 types of data that Dudu will retrieve: the email address, the last and the first name of the user. Choose the type of data you want to transmit to the Livechat operator (e.g. email address) and create a corresponding free input variable in the knowledge base as below.

The name of the "mail" variable is what you should use to fill in the Email field in your Livechat settings.

Dydu competency and Genesys queue mapping

If you want to assign user messages to Livechat agents according to their expertise (Marketing, Payment, IT...), you must indicate here the correspondence between the Livechat competencies set up in BMS and those created in Genesys.

In general, you will see in the list below the Dydu Livechat competencies on the left and the queues set up in Genesys on the right.

Select the corresponding Genesys queue from the drop-down list. Leave it empty if the mapping is not necessary

(The steps to set up queues in Genesys are detailed in the next section.)

A special case: without competency

You may not have any Livechat competencies if your operators do not specialize in a particular area. In this case, to ensure the correspondence with Genesys, a "without competency" line is always displayed. Leave the dropdown list empty.

Step 2 - Configurations in Genesys Cloud


Generally, there are 5 steps to follow in your Genesys Cloud platform:

  1. Client Oauth creation.

  2. Automatic creation of Integrations in Genesys Cloud.

  3. Queue configuration.

  4. Definition of the inbound message distribution rules in the design tool Architect.

  5. Correspondence between message distribution rules and Integrations created in step 2.

1. Client Oauth creation

This step allows you to generate in Geneys Cloud the Client ID and Client Secret required by the Genesys Connector fields in the BMS.

To create your Client Oauth, navigate to Admin > Integrations > Oauth.


You need to assign roles to your Client Oauth that will determine the permissions for Dydu to use the Genesys API *.

We advise you to add the Master Admin or User role.

*The necessary permissions required by the Genesys Livechat connector are:

  • messaging:integration:add

  • messaging:integration:view

  • conversation:message:receive

  • routing:queue:view

  • analytics:queueObservation:view

Follow instructions here to create your Client Oauth on Genesys Cloud.

2. Automatic creation of Integrations in Genesys Cloud

Once the Client Oauth is created and the "Client ID" and "Client Secret" are filled in BMS > External Connector, your Dydu bot's information is sent to Genesys and open-messaging-type integrations are created automatically in Genesys > Admin > Message > Platform.

You don't have to do anything in this step but you will use these integrations in step 5.

In general, the Dydu API will create an integration called DYDU bot connector.

In addition, if you have Livechat competencies set up on your Dydu bot, an additional integration per competency will be created as well.

Ex: DYDU bot connector (Marketing) is created in correspondence to the Livechat competency Marketing of the bot Dydu.


Do not change the names of the integrations even if they are editable, as they are used to establish the correspondence between Dydu and Genesys.

3. Queue configuration

Queues will allow you to define the areas of expertise of your Livechat operators and assign them to a categorized waiting list of messages called “queue”.

They are created in Genesys Cloud > Admin > Contact Center > Queues.

Follow instructions here for more details.

Note: to add an operator to a queue, go to the Member tab in the parameters of the queue in question:

Once the queues have been created, remember to go back into the BMS to match them with the Livechat competencies.

4. Definition of the inbound message distribution rules

Once you have created the queues, you must define the rules by which new messages will be assigned to these queues.

The rules are defined in the flow design tool called Architect.

Detailed steps:

  • 4.1. Go to Admin > Architect.

  • 4.2. On the Architect home page, hover over the Flows section and select Inbound Message from the drop-down list.

  • 4.3. Click on + Add. A flow creation modal will open. Fill in the fields. If you need help, refer to instructions here

  • 4.4. Once the fields are completed, click on Create Flow and the flow design interface opens.

  • 4.5. Genesys offers a wide range of message distribution rules. Let's take a simple scenario as example: if an incoming message falls under the Animal expertise, the message will be assigned to the Animal queue. Thus, our final flow diagram should look like this:

  • 4.6. This is what the default diagram looks like:

We will remove the Disconnect step that is created by default and add a step to assign the message to the Animal queue.

To do this, click on the 3 dots next to Start and then Toolbox > Transfer to ACD. (ACD: “automatic call distribution”)

  • 4.7. Next, we need to define the target queue to which incoming messages will be sent.

    We will select the Animal queue created in step 4 from the drop-down list on the right. Leave the rest of the fields empty.

  • 4.8. The last step: save and publish your flow.

5. Correspondence between message distribution rules and Integrations

This is the last step to set up the interoperability between the Genesys connector and your Dydu bot.

    • 5.1. Navigate to Admin > Routing > Message Routing.

    • 5.2. Click on + on the right to create a new correspondence.

    • 5.3. On the left, select the flow "Animal". On the right, select the address (the integrations created in step 2) that corresponds to the Livechat competency of your Dydu bot. In our example: "Dydu bot connector (Animal)".

    Congratulations! The interoperability between the Genesys Livechat Connector and your Dydu bot is established. All you have to do now is test it!

Step 3 - run a test


  1. Create a knowledge item that allows the Livechat escalation to a specific competency (e.g. Animal).

  2. (Optional) If you want to retrieve the identity of your users, create another knowledge item using mail/first name/last name variables whose values will be captured in free input.

  3. Follow the configuration steps in BMS and Gensys mentioned above.

  4. On your Genesys Cloud platform, make sure that the tester is part of the Operators in charge of the Animal queue and that the On queue option in the top right corner is enabled to receive incoming messages.

  1. Open the preview page of your chatbox created via Channels and call the knowledge created in step 1 to activate the Livechat escalation to Genesys

Expected results

  • In the Dydu chatbox: the end-user shifts to a conversation with a human operator while remaining in the same conversation and can receive messages and attachments sent by the operator in real-time.

  • On Genesys Cloud: when a new message arrives, the operator receives a notification. He/she can access the conversation via the Interaction section, view the conversation history, reply to the user and send attachments (only images at the moment).

Last updated

Tous droits réservés @ 2023 dydu.