Docebo is an Learning Management System (LMS) that provides course management, and other features. Many customers use Docebo to manage their courses and have asked about integrating Docebo with our systems. With the newest version of Webhooks and Integrations, we are happy to announce that ScopeAR can easily integrate Docebo.
Use Case
There are many use cases and ways for Docebo and ScopeAR to work together but this document will focus on one case in particular:
“As a Docebo user, I want to be able to launch a quiz on Worklink from my Docebo course training list and when I have completed my quiz, I want Docebo to display that I have completed the training.”
Step One: Add ScopeAR to E-Learning Whitelist
First, we need to add ScopeAR’s getworklink service to Docebo’s xAPI external content whitelist.
What is the getworklink service? This service allows for easy sharing of ScopeAR scenarios with a getworlink URL. Each scenario within ScopeAR has a shortened getworklink URL. The WorkLink App will launch when the shortened getworklink URL is opened with a browser.
This getworklink URL is going to be used with Docebo’s xAPI external content system, which will redirect the user to the URL specified in the training course (more on that later).
To whitelist the getworklink service, log into your Docebo dashboard as an admin, and go to the Admin Menu by clicking on the gear icon on top right corner:
From there go to Advanced Settings:
On Advanced Settings, click on E-Learning:
On the right side, there will be a form to add URLS to xAPI (Tin Can) external content:
Use that form to add the getworklink service to the list of whitelisted urls (make sure to add an asterisk * at the end):
Clicking on the add button will add the getworklink service to the whitelist.
Your getworklink service might be different if you are using an on-prem version of ScopeAR. You can check the getworklink service URL by going to the CMS and looking at a scenario’s getworklink URL.
Step Two: Create A Course
Now, let’s create a new course in Docebo. Begin by logging into your Docebo dashboard as an admin, and go to the Admin Menu by clicking on the gear icon on top right corner:
From there, go to Course Management:
Then Click on the Green box on the right side to bring up a menu:
On this menu, click on New Course:
Fill in the required fields and then create the course:
At this point, we have create a new Course. Now let’s add some training materials.
Step Three: Add Training Material
Once you’ve created a Course, you can add training materials to this. Click on the Training Material tab on the course management page:
Click on the Add Training Material button:
Select the xAPI (Tin Can) link:
Click on the From URL checkbox to expose the Select URL dropdown:
In the Select URL dropdown, select the getworklink URL that was created earlier:
Before we can continue, we need to locate the scenario in the Worklink CMS. Log into the Worklink CMS, navigate to the Content page, and select a scenario from the list:
On the scenario details page, locate the link:
Copy the last alphanumeric characters on the link (in this case, it’s 4mCo):
Go back to the Docebo training material form and add paste the characters into the Additional path field:
Next, you will have copy the name of the scenario and add it to the Title field of the training material (in this example its QA_Everything):
Paste the name into the title field:
Next, just save the training material. It should pop-up on the training material course list:
Step Four: Create Public Key and Secret
lorem:
Lorem:
Lorem:
Step Five: Add API Credentials
In order for the webhook subscription requests to be sent to Docebo, the requests need to be authenticated. This will require setting up the API Credentials in Docebo.
Go to the Admin Settings in Docebo:
Click on the Manage link under API AND SSO:
Next, click on the API Credentials link on the left nav menu:
Add a new set of credentials by clicking on the Add OAuth2 App button:
In order to make the correct credentials for the API integration, click on Show Advanced Settings:
Then click on JWT Bearer so that a JWT Bearer Token can be used to authenticate:
Add the URL for the Worklink CMS to the Redirect URI:
Create a unique client ID for the API Credentials:
Upload the public key (public.pem file) that was created in the earlier step:
Copy the client secret that has been generated (to be used in the next step):
Save the API Credentials by hitting the Confirm button:
This will bring you to the API Credentials list.
From here, enable the API Credentials by clicking on the checkmark icon:
Step Six: Create New Integration
This is where the magic happens. We will create the integration between Docebo and ScopeAR. We do this by creating an Integration object which is more or less a collection of Webhooks that will send data from ScopeAR to Docebo.
Log into the Worklink CMS and click on the Integrations link under Developer Tools:
You will now be on the Integration list page. Click on the Connect Integration button to create a new integration:
Clicking on the button will bring up the Connect Integration form. Select Docebo from the drop-down list:
Next, add your custom Docebo URL to the API URL text field:
Click the Save button at this point. Though we are not done yet. The API credentials (used to authenticate Webhook requests to Docebo) need to be added.
Click on the Docebo Integration link on the list of integrations:
You are now on the Integration details page. Click on the Edit Integration button to bring up the edit form:
Enter into the Client ID field the client id that was created for the API Credentials:
Paste the client secret (generated from the last step) in the Client Secret field:
Lastly, copy and paste the private key (from the into the JWT Private Key field:
Save the edited Integration by clicking on the save button:
Congratulations! You have just setup your integration between Docebo and ScopeAR!
Step Seven: Test
Now it’s time to test. This is rather straightforward: just launch the training course and complete the training in the Worklink App. If you finished all the trainings within the course, the webhooks should automatically update Docebo and state that you completed the course and the trainings:
0 Comments