Docebo Integration


What is the Docebo Integration?

The Docebo Integration populates your Docebo instance with updated courses from Pluralsight. Your user’s completion data can also be synced with Docebo in near real time providing a one stop shop for users to view and manage all their Pluralsight content in Docebo's ecosystem.

This integration is in BETA. All customers are invited to opt in to the Beta release stage, however it is meant to be used with caution. When considering using an integration that is in Beta, please be aware of some potential drawbacks:

  • Known or unknown data integrity issues (missing or incorrect data).

  • Although the integration in this stage has been tested by our team, broader and more at scale use may surface areas for improvement.

  • Changes are rare, but the integration is not guaranteed to not change before a General Release.

  • Shortened deprecation timeline for handling any breaking changes.


Considerations

  • The Docebo API does not support updates to previously created learning objects. Once a learning object has been made in a course, we are unable to programmatically alter it. For example, if you initially sync with regular course URLs, but then in the future decide you want to use SSO deep links, we are unable to update any preexisting course URLs. You will have to delete the courses with the old URLs, and then in the subsequent sync, new learning objects will be made with the SSO deep links.

  • Course completion tracking is in near real time, while the course catalog sync has a cadence of every 24 hours.


Setting up the integration

Course Completion Tracking

You have the choice to either use a user's SSO identifier or email address as the main identification value in the course completion statements.

  • If you choose SSO ID:
    • Your IdP must be configured to send the Docebo user ID to Pluralsight.

  • If you choose email:
    • Your user's usernames must be their email address

If users ID's do not match between systems, the course completion tracking will fail. Course completions will be sent back to your Docebo instance in near real time.



Generating client credentials

  1. Log into your Docebo instance and navigate to the Admin Menu > API and SSO > Manage page.
    Navigate to API

  1. On the sidebar, click on API credentials and then on the Add OAuth2 app button.
    OAuth2

  1. Fill out the required information in the modal form. After that is completed, be sure to save the credentials provided. Those will be used later.


Creating a superadmin user for the integration

Docebo requires the use of a superadmin user credentials to be used in tandem with the generated client ID and secret. We will show you how to create a superadmin user used exclusively for the Pluralsight integration. You can also use a preexisting superadmin user in your system per your discretion.


  1. Navigate to Admin Menu > E-Learning > Users

  1. On the top right corner, select the blue plus button, and select New user.

  1. Fill out the form, and be sure to click the Level dropdown and select Superadmin. Be sure to save the username and password of the superadmin user, as they will be used later.
    superadmin


Add Pluralsight to xAPI external content whitelist

Once your courses are imported, we want to make sure that your Docebo instance knows that anything referencing the Pluralsight platform is safe. This will allow your users to be navigated to the correct Pluralsight course without issue.


  1. Navigate to Admin Menu > Settings > Advanced Settings

  1. On the sidebar to the left, click on E-Learning

  1. In the xAPI (Tin Can) external content section, paste the following and then press Add: https://apps.pluralisight.com/*. After that, hit the Save button on the bottom.
    whitelist


Adding a Pluralsight catalog

Our connector will automatically look for a catalog called Pluralsight into which it will place your entire Pluralsight catalog. If no catalog called Pluralsight is found, the courses will live only at the root level of your Docebo instance.


  1. Navigate to Admin Menu > E-Learning > Course Catalog

  1. Click on the New Catalog button on the top of the screen.

  1. Fill out the modal form. Be sure that the name is Pluralsight and press confirm.
    catalog


Creating a connection with the Pluralsight system

Now that your Docebo instance is ready to go, let's go over to the Pluralsight domain to create a connection between us and your Docebo tenant.


  1. Navigate to the Integration Portal page, and enter in your API key. For API Key information and best practices please refer to this page.

  1. If you do not have a subscription to the Docebo integration powered by Pluralsight, the page will prompt you to select your LMS/LXP provider. Click the dropdown and select 'Docebo'. If you do have pre-existing subscriptions, they will display on the page and you will be able to edit them.

  1. Fill out the required information in the form.

  • Provider: Determines which LMS/LXP provider the integration will use. Select 'Docebo'.

  • Technical Contact: The email(s) where notifications will be sent regarding the integration. To use multiple emails, seperate the emails with a comma: example1@test.com, example2@test.com

  • Base URL: The URL to your Docebo instance; Here's an example: https://your-docebo-url.docebosaas.com.

  • Client ID: The client ID to retrieve an access token; Previously generated on the Docebo side.

  • Client Secret: The client password to retrieve an access token; Previously generated on the Docebo side.

  • Username: The username of the super user. Previously generated on the Docebo side.

  • Password: The password of the super user. Previously generated on the Docebo side. Most clients will generate a super user specifically for this integration.

  • Status: Determines whether your Course Catalog Sync or Course Completion Tracking subscriptions are active or not. If subscription is set to Paused, Course completion statements will NOT be sent to your statement URL and the Course Catalog sync will not update your course library on the Docebo side.

  1. Click the Save button. Your Docebo subscription is now running.


Error Handling

In the event that we encounter an error trying to sync the course catalog with your Docebo instance, we will send an email to your technical contact alerting them of the issue. For more information on how we deal with errors with course completion tracking, navigate to this page and scroll down to the Error Handling Policy section.