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).

The integration for Accredible allows you to import course Credential Groups from Accredible as completed External Training in Docebo as well as exporting your completed courses or learning plans from Docebo to Accredible as Credential Groups.

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

Activating Docebo Connect

Docebo Connect is a paid product. To activate Docebo Connect on your platform or sandbox, please reach out to your Docebo Account Manager.

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.

A complete list of recipes used by this integration, including which sub-recipe they call, can be found in the chapter Recipe Descriptions.

Configuring the Integration

Prior to using Docebo Connect for Accredible, you will need to configure the integration, following are the steps necessary to successfully set up the lookup tables and recipes.

Configuring the Lookup Tables

Docebo Connect for Accredible uses three different lookup tables. The first one is the standard integration-settings table where the settings for the integration are stored, next there is the Accredible Integration Mappings table which stores the mappings between Docebo Objects (such as Learning Plans and External Training) and Accredible Credential Groups. Lastly there is the Accredible Credential Groups table where Accredible Credential group data is stored.

Please Note: All boolean values must be stated as either true or false in lower-case.

Integration Settings 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 check mark icon to save the row.

Add the following rows if they do not already exist:

Integration	Key	Value
ACCREDIBLE	EXTERNAL_TRAINING_INSTITUTE_NAME	Accredible credentials are imported as External Training, this field will be used as their Institute Name
ACCREDIBLE	ACCREDIBLE_DEFAULT_EXPIRATION_DAYS	Number of days the credentials created in Accredible is valid from the issued_date. If left blank, expiration date will not be added in Accredible environment. If set to 0, the expiration date will be set to same date of issued date in Accredible
ACCREDIBLE	ACCREDIBLE_TO_DOCEBO_BATCH_SYNC_START_DATE	While this integration perform synchronization in real-time, it also provides a utility for running a batch synchronization between Docebo Objects and Accredible Credentials. This date value establishes the furthest point in time in terms of Issue date in Accredible for those items should be evaluated by the batch utility. [Format: YYYY-MM-DD]
ACCREDIBLE	DOCEBO_TO_ACCREDIBLE_BATCH_SYNC_START_DATE	While this integration performs the synchronization in real-time, it also provides a utility for running a batch synchronization between Docebo Objects and Accredible Credentials. This date value establishes the furthest point in time, the Course completion date of the user in the Docebo Learn platform for those items should be evaluated by the batch utility. [Format: YYYY-MM-DD]
ACCREDIBLE	COURSE_ADDITIONAL_FIELD	Name of the course additional field created in the Docebo Learn platform for the credential groups to be added.
ACCREDIBLE	NOTIFICATION_MAIL_ID	The email value that should be used by the recipes of this integration for error notification purposes.

Once all the values are added the lookup table should look like this:

Accredible Credential Groups Table

The Accredible Credential Groups table is populated by the Synchronisation from Accredible to Lookup table and Synchronisation from Accredible Lookup table to Docebo LMS recipes and requires no manual configuration.

Accredible Group ID	Accredible Group Name (Identifier)	IsActive	Dropdown Element ID
Integer Value The ID of the group from Accredible.	Text Value The name of the group from Accredible.	Boolean Value A boolean flag that specifies if this entry should be skipped by the integration.	Integer Value The numeric ID of the badge template as a Course Additional Field dropdown value. This value is assigned by the Docebo Learn platform during an update of the additional field.

As an example, a populated Accredible Credential Groups table would look similar to this:

Accredible Integration Mappings Table

The Accredible Integration Mappings table is utilized by both the Docebo to Accredible (map Learning Plans with Accredible Credential Groups) and Accredible to Docebo (map Accredible Credential Groups with External Training) flows.

This lookup table is used by the integration to map relations between Docebo Objects (Learning Plans, External Training) and Accredible Credential Groups and vice-versa. All values in this table must be configured manually. The columns and the expected values they contain is explained here:

Credential Group ID	Credential Group Name (Identifier)	Learning Plan Code	Import As External Training	IsActive
Text Value The ID Credential Group in Accredible.	Text Value The Name of the Credential Group in Accredible.	Text Value The code of the associated learning plan in Docebo Learn. The Code of the Learning Plan can be obtained by accessing the Admin Menu in Docebo Learn and then selecting Learning Plans from the left menu. The list of all available learning plans displays the code as the first column.	Boolean Value Specifies if the related Credential Group should be imported as External Training in Docebo Learn. If set to true, External training will get created, if the associated Credential Group is assigned to the user in Accredible.	Boolean Value This true / false flag specifies if this entry should be skipped by the integration or not. It is skipped if the value is set to false.

When completed, as an example, the table would look similar to this:

Configuring the Connector

Navigate to your project folder and press the down arrow on the Create button in the top right corner of the window. In the resulting drop-down menu, select Connection.

In the resulting New connection screen, type Accredible into the search text box and in the search results field, select the Accredible connector.

Next, in the Connect to Accredible window, give your connection a meaningful name and in the Location drop-down menu select the top level where you have stored your Accredible recipe clones. Next, enter your Accredible API key and in the Environment drop-down menu select Production. Then, press the Connect button.

Recipes

Please Note: Every Docebo Object that supports an expiration date property must be created with the expiration date of the related Accredible Credential Group, and vice-versa. If a Docebo Object does not support such a field, then the related Accredible Credential Group must be created with an expiration date according to the value of the ACCREDIBLE_DEFAULT_EXPIRATION_DAYS integration-settings lookup table setting.

Recipe Descriptions

Event Dispatcher - Docebo to Accredible

This recipe must be started in Docebo Connect in order for this integration to function properly. For more information on starting recipes, please see Docebo Connect Usage: Common Recipe Actions.

This recipe is responsible for real-time synchronization by receiving Webhooks events from the Docebo Learn platform when a learner completes a course.

To configure the webhook, open this recipe and click on the first item. In the resulting slide-in window, press the Copy button next to the Workato webhook address.

Next, access the Admin Menu, locate Webhooks and press Manage to access the configuration page. Press the plus button to create a new webhook and in the resulting window give your webhook a name and paste the Payload URL from the Connect recipe. Next, press Select Events.

In the resulting slide-in window, place a checkmark next to Learner completed a course in the Enrollments section and press Confirm.

Next, press Save Changes to save your webhook. Returning to the list of webhooks, locate the webhook you just created and press the grey circle next to the name of the webhook to activate it. The circle will turn green once the webhook is active.

Trigger

Course-completed via HTTP Webhook

Calls to other recipes

• Assign Accredible credential for Course Additional Field element
• Assign Accredible credentials for Learning Plans

Batch Sync - Docebo to Accredible

This recipe must be started in Docebo Connect in order for this integration to function properly. For more information on starting recipes, please see Docebo Connect Usage: Common Recipe Actions.

The recipe performs a batch synchronization for all the courses in the Docebo Learn platform with Accredible. This process is similar to a real-time synchronization but here the recipe processes all the courses present in the Docebo Learn platform.

Trigger

Triggered every five minutes automatically

Calls to other recipes

• Assign Accredible credential for Course Additional Field element
• Assign Accredible credentials for Learning Plans

Assign Accredible credential for Course Additional Field element

This recipe retrieves the selected course additional field from the user completed course and retrieves the corresponding credential group details from Accredible Credential Groups lookup table for the retrieved course additional field value.

Trigger

Called by another recipe

Calls to other recipes

• Retrieve course additional field from Docebo LMS
• Retrieve enrolled users by course ID
• Assign Accredible credentials to users

Assign Accredible credentials for Learning Plans

The recipe is responsible for retrieving the Learning Plans associated with the course.

Trigger

Called by another recipe

Calls to other recipes

• Retrieve enrolled users by course ID
• Filter learning plans retrieved from course
• Assign Accredible credentials to users

Retrieve enrolled users by course ID

This recipe retrieves the enrolled users from the course, specifically users with status completed and have completed the course on or after the DOCEBO_TO_ACCREDIBLE_BATCH_SYNC_START_DATE provided in the integration-settings lookup table will be retrieved for processing.

Trigger

Called by another recipe

Calls to other recipes

• None

Retrieve Learning Plan from Course

The recipe retrieves all the Learning Plans associated with the course based on the course_id input.

Trigger

Called by another recipe

Calls to other recipes

• None

Filter learning plans retrieved from course

This recipe is responsible for filtering the retrieved Learning Plans from a course by mapping them with the Accredible Integration Mappings lookup table with the filter if IsActive is set to true.

Trigger

Called by another recipe

Calls to other recipes

• None

Assign Accredible credentials to users

This recipe assigns the respective Accredible credential to the users.

Trigger

Called by another recipe

Calls to other recipes

• Retrieve Accredible groups ids for user completed LPs
• Filter unassigned credentials

Retrieve Accredible groups ids for user completed LPs

This recipe is responsible for retrieving the respective credential group IDs from the Accredible Integration Mappings lookup table for the user's completed Learning Plans.

Trigger

Called by another recipe

Calls to other recipes

• None

Filter unassigned credentials

This recipe filters unassigned credential groups to users by checking if the user has already been assigned with the credential groups in the Accredible Environment.

Trigger

Called by another recipe

Calls to other recipes

• None

Batch Sync - Accredible to Docebo

This recipe retrieves all the entries from the Accredible Integration Mappings lookup table where IsActive is set to true.

Trigger

Called by another recipe

Calls to other recipes

• Retrieve Credentials from Accredible

Retrieve lookup table values

The recipe is used to retrieve the configurations present in the integration-settings lookup table.

Trigger

Called by another recipe

Calls to other recipes

• None

Retrieve Credentials from Accredible

The recipe is responsible for retrieving all the issued credentials from Accredible environment through pagination and process the credentials.

Trigger

Called by another recipe

Calls to other recipes

• Process credentials

Process credentials

The recipe processes the events retrieved from Accredible.

Trigger

Called by another recipe

Calls to other recipes

• Retrieve user details from Docebo LMS using user mail id
• Check if credential not issued through Docebo to Accredible Sync
• Create/Update external training for user

Retrieve user details from Docebo LMS using user mail id

This recipe retrieves the user details from Docebo Learn based on the user's email address from Accredible.

Trigger

Called by another recipe

Calls to other recipes

• None

Check if credential not issued through Docebo to Accredible Sync

This recipe is responsible for checking if the credential issued in Accredible is assigned by Docebo to Accredible Sync flow.

Trigger

Called by another recipe

Calls to other recipes

• None

Check if the recipient id from Accredible is same as that of LMS user id

This recipe checks if the recipient ID in Accredible is the same as the user ID in Docebo Learn.

Trigger

Called by another recipe

Calls to other recipes

• None

Create/Update external training for user

This recipe creates a new external training if the credential is assigned in Accredible or updates the external training if it is already present in Docebo Learn.

Trigger

Called by another recipe

Calls to other recipes

• None

Synchronisation from Accredible to Lookup table

This recipe must be started in Docebo Connect in order for this integration to function properly. For more information on starting recipes, please see Docebo Connect Usage: Common Recipe Actions.

This recipe retrieves the credential groups from the Accredible environment and populates them to the Accredible Credential Groups lookup table.

Trigger

Triggered automatically daily at 2:00 Pacific Time Zone

Calls to other recipes

• None

Synchronisation from Accredible Lookup table to Docebo LMS

This recipe must be started in Docebo Connect in order for this integration to function properly. For more information on starting recipes, please see Docebo Connect Usage: Common Recipe Actions.

This recipe is responsible for creating the course additional field (dropdown field) in Docebo Learn.

Trigger

Triggered automatically daily at 2:00 Pacific Time Zone

Calls to other recipes

• Retrieve course additional field from Docebo LMS

Retrieve course additional field from Docebo LMS

This recipe is responsible for creating a course additional field in Docebo Learn if it is not present based on the value provided in the Key: COURSE_ADDITIONAL_FIELD in the integration-settings lookup table.

Trigger

Called by another recipe

Calls to other recipes

• None