Introduction

Docebo Connect is a Docebo module acting as a connector between your platform and third-party SaaS systems, helping you to integrate your platform with more than 400 third-party external systems, reducing the integration effort.

Docebo Connect offers a large catalog of connectors for the most popular SaaS systems, to manage automated workflows (called recipes) shared among systems in order to exchange and share data on the basis of triggers.

Please note that Docebo Connect takes advantage of the APIs and business logic already existing in the integrating systems and does not create new ones. In addition, Docebo Connect does not manage SSO flows with Identity Providers (such as SAML, OpenID Connect, etc), JavaScript integrations (such as Google Analytics or Google Tag Manager) or iframe integrations (such as Docebo OEM or Salesforce Canvas).

This article describes the process of using Docebo Connect recipes to facilitate the importing and updating of users via HiBob.

Tip: For information on associating a user with a manager, please see the Creating and Managing Users article.

For more information on the definition of terms and concepts used throughout this article, please read Docebo Connect Glossary of Terms.

Activating Docebo Connect

To activate Docebo Connect on your platform or sandbox, please reach out to your Docebo account manager. Please note that depending on the integration requirements, there may be associated costs.

Before you start

All the recipes for this integration can be found in the project's folder. This folder should be considered a “special folder” as all the recipes contained within are subject to automatic updates. As such, any customizations you make to recipes located within the folder can be overwritten by Docebo. In order to prevent such an occurrence, it is strongly advised to create a new project folder for any recipes you wish to use in production and copy or clone the recipes from the project's folder inside.

Prior to configuring and using the integration, you need to make clones of all the recipes used in this integration. For more information on how to clone and edit a cloned recipe, please see Docebo Connect usage: Copying recipes. The list of recipes that need to be cloned can be found in the Recipes chapter of this article. All recipes that call a sub-recipe will require editing, the called sub-recipes can be found in a list inside the recipe description.

Creating a service user in HiBob

In order to connect your HiBob account with Docebo Connect, you will need to create a service user in HiBob. To do so, log in to HiBob using an administrator account and in the side menu press Settings. In the resulting slide-out menu, press Integrations to access the correct screen.

Next, locate the Service Users item, found in the Automation section, and press Manage.

In the following screen, press the New Service User button to begin. In the resulting window, enter a Service User name and the Display Name for the new service user and then press the Next button.

You will then be presented with the ID of the service user as well as the access Token. Make sure that you copy and paste the information presented here into a text editor, such as Notepad or Kate, for safe keeping. You will not be able to retrieve this information at a later time and will have to recreate the Token if you lose these credentials. Once you have copied all the information, press the Done button.

Lookup table

Click on the gear icon and locate Docebo Connect, then click on Manage. Next, click on the Lookup Table tab and then click on the integration-settings table.

Please make sure that the table in the platform matches the table presented here, if any of the following rows are missing, please add them by typing the values in the relevant text boxes and then pressing the green check mark icon to save the row.

Add the following row if it does not already exist:

The populated table will look as follows:

You can now move on to configuring the necessary connections for this integration.

Connectors

You will need two connectors for these recipes, HiBob and your default Docebo Connect connector.

The default Docebo connector will already be located inside your project folder, described here are the steps necessary to add the HiBob connector to Docebo Connect.

The HiBob connector can be found by first pressing the down arrow next to the Create recipe button in the HiBob folder, then pressing Create connection.

In the following screen, type HiBob into the search box and press enter. Then, click on the HiBob connector in the search results:

You will then need to configure the connector by filling in the relevant fields using the information you copied into a text editor earlier in the account creation process:

Recipes

Please note: In order for this integration to work properly, the following recipes need to be started first:

• Capture user update from HiBob
• Capture user create from HiBob
• Create / Update users from HiBob to Docebo LMS

For more information about starting recipes, please see Docebo Connect usage: Common recipe actions.

Capture user update from HiBob

This recipe captures user updates from HiBob and forwards the information on to the recipe called Create / Update users from HiBob to Docebo LMS. You will need to configure a webhook in HiBob using the information found in this recipe before you can start using this recipe.

Configuring a webhook in HiBob

Open this recipe using the recipe editor by pressing the ellipsis button to the right of the recipe and, in the resulting drop-down menu, pressing Edit recipe.

Next, in the recipe editor press on the first item labelled Trigger. In the resulting slide-out window locate the Webhook and copy the URL into a text editor for later use. Press the Exit button in the recipe editor to return to the recipe list.

Next, log in to HiBob using an administrator account and in the side menu press Settings. In the resulting slide-out menu, press Integrations to access the correct screen.

Next, locate the Webhooks item, found in the Automation section, and press Manage.

In the following screen, press the Add a new Subscriber button to begin. In the resulting window, enter a Subscriber name and paste the URL for the webhook you copied from the recipe in the URL textbox. Next, make sure that the following items are checked:

• Employee Created
• Employee Inactivated
• Employee Terminated
• Employee Update
• Employee Activated
• Employee Deleted

Then, press the Save button. 

Trigger

This recipe is triggered by an update of users in HiBob

Calls to other recipes

• Create / Update users from HiBob to Docebo LMS

Capture user create from HiBob

This recipe captures user creation from HiBob and forwards the information on to the recipe called Create / Update users from HiBob to Docebo LMS. This recipe uses the same webhook as the recipe Capture user update from HiBob and therefore requires no further configuration.

Trigger

This recipe is triggered by the creation of users in HiBob

Calls to other recipes

• Create / Update users from HiBob to Docebo LMS

Create / Update users from HiBob to Docebo LMS

This recipe performs the creation and updating of users in the Docebo platform. It is called by another recipe whenever a user is updated or created and requires no further configuration.

Trigger

Triggered via function call

Calls to other recipes

• None