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 Worklink can easily integrate with Docebo.
| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
...
There are many use cases and ways for Docebo and ScopeAR Worklink 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 graded quiz on Worklink from my Docebo course training list and when I have completed and passed my quiz, I want Docebo to display that I have completed the training.”
Step One: Turn on extra data for xAPI/Tin Can
xAPI / Tin Can is a feature within Docebo that will add extra parameters to will launch external content from Docebo. To use the Worklink integration, you will need to enable extra parameter data to be added to the external URLs that are used to launch training courses. The integration will use these extra parameters to connect the Worklink scenarios to the courses, training materials, and users within Docebo.
To turn on this feature in Docebo, log into your Docebo dashboard as an admin, and go to the Admin Menu by clicking on the gear icon on in the top right corner:
...
Next, scroll down the page to the Settings section and click on Advanced Settings link:
...
Lastly, scroll down the page and make sure the XAPI/TinCan checkbox is checked:
...
Now that the additional data for XAPI/TinCan is turned on, we need to whitelist the external URL for Worklink.
Step Two: Add
...
Worklink to E-Learning Whitelist
Now, we need to add ScopeAR’s Worklink’s getworklink service to Docebo’s xAPI external content whitelist.
What is the getworklink service? This service allows for easy sharing of ScopeAR Worklink scenarios with a getworlink URL. Each scenario within ScopeAR Worklink has a shortened getworklink URL. The WorkLink App will launch when the shortened getworklink URL is opened with a browser.
...
| Note |
|---|
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
...
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.
...
Three
...
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:
...
:
...
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:
...
Create Public Key and Secret
In order for the integration to be secure, a public and private key need needs to be generated. There are various means to create one. For the sake of this tutorial, we will use the https://cryptotools.net/rsagen
...
Copy the Private key and save it to a text file called private_key.pem:
...
Great. We now have a public and private key pair to use for our API Credentials.
Step
...
Four: 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.
...
Create a unique client ID for the API Credentials:. This can be any string you want it to be. Just make note of this string as you will need it again later.
...
Upload the public key (public_key.pem file) that was created in the earlier step:
...
From here, enable the API Credentials by clicking on the checkmark icon:
...
Step
...
Five: 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.
...
Lastly, copy and paste the private key (from the private_key.pem file) into the JWT Private Key field:
...
Congratulations! You have just setup your integration between Docebo and ScopeAR!
Step Six: Create A Course
Now, let’s create a new course in Docebo that uses the integration that you just made. 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 created a new Course. Now let’s add some training materials.
Step Seven: 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 Eight: Change the Training Material Settings
Select the menu button to the right side of the training material and select the Settings option. This will open a settings dialog for the training material.
...
Change the Launch Mode to “Play in New Window” and save your changes
Congratulations! You just created a training course that integrates with ScopeAR’s Worklink!
Step Nine: 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:
...
...
When you click Start Learning, this will launch a webpage from which you can either launch the Worklink app or you can scan the QR code on the page to launch the quiz material in the Worklink app on another device. Either way, once the scenario has been run and any quiz material completed with a passing grade, then the quiz in Docebo will be automatically marked as complete.
To find the score of the training session, go to User Stats
...
Scroll all the way to the bottom and you’ll see this. Score is the farthest right value
...