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 (opens in a new tab).
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:
Integration | Key | Value |
|---|---|---|
|
| (The email address of the user to receive notification if any error occurs in a job) |
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:
Please note
The HiBob Employee deleted webhook event is supported through a dedicated recipe. When an employee is deleted in HiBob, the integration uses the email address contained in the
employee.deletedevent to find and delete the corresponding user in Docebo if a matching user exists.
Recipes
Please note
In order for this integration to work properly, the following recipes need to be started first:
For more information about starting recipes, please see Docebo Connect usage: Working with recipes.
Capture user update from HiBob
This recipe captures user updates from HiBob and forwards the information on to the recipe called Retrieve employee details from HiBob. You will need to configure a webhook in HiBob using the information found in Configuring a webhook in HiBob 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, in the Events section, make sure that the following items are checked:
Employee activated
Employee created
Employee deactivated
Employee left
Employee updated
Then, press the Save button.
Trigger
This recipe is triggered by an update of users in HiBob
Calls to other recipes
Capture user create from HiBob
This recipe captures user creation from HiBob and forwards the information on to the recipe called Retrieve employee details from HiBob. 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
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
Capture user activated from HiBob
This recipe captures user activation from HiBob and forwards the information on to the recipe called Retrieve employee details from HiBob. 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 activation of users in HiBob
Calls to other recipes
Capture user deactivated from HiBob
This recipe captures user deactivation from HiBob and forwards the information on to the recipe called Retrieve employee details from HiBob. 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 deactivation of users in HiBob
Calls to other recipes
Capture user left/terminated from HiBob
This recipe captures user leaving or termination from HiBob and forwards the information on to the recipe called Retrieve employee details from HiBob. 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 leaving of users in HiBob
Calls to other recipes
Retrieve employee details from HiBob
This recipe retrieves details of the employee via the HiBob connector and passes the retrieved information to the Create / Update users from HiBob to Docebo LMS recipe.
Trigger
Triggered via function call