Certiverse Docebo Integration

Overview

Exams available in the Certiverse Exam Store can be set up to verify the eligibility of candidates in Docebo when they schedule an exam. This verification process uses API calls to confirm that a student with the same email address as the candidate booking the exam in Certiverse exists in Docebo and is enrolled in the specified course and lesson. The Docebo Configuration section below offers guidance on how to set up the Published Course, Course, and Lesson in Docebo.

Certiverse Configuration

Eligibility in the Docebo platform is set up individually for each exam in the Certiverse Exam Store (Admin Portal > Store Exams > Exam). This setup is done in the "Eligibility Configuration" tab and requires the user to provide the Client Id, Client Secret, Username/Password (Docebo account/log-in credentials), and Domain name from the Docebo platform. The Course Id is not needed; instead, a search textbox is provided to find it. *It is important to note that the Certiverse Org Admin be an Assigned User in Docebo Catalogs which will contain the list of courses available for Eligibility Configuration in the Certiverse Store Portal.*

Candidate Flow and Eligibility Verification

The eligibility verification from Certiverse into Docebo will occur once an exam is selected from either the Organization landing page or a deep link to the exam. If the candidate is not logged into Certiverse, they will need to log in or create a new account. The email address used for the Certiverse account must match the one used for their Docebo account for course enrollment. Once the Docebo API verifies eligibility, the candidate can proceed with booking the exam.

Candidate Exam Results

After the exam is completed, the Certiverse platform will use the Docebo API to update the course status with the pass/fail result, completion date, and percentage score.

Troubleshooting Candidate Eligibility Configuration and Candidate Eligibility

When verifying exam eligibility in Docebo, there are multiple steps involved. If the candidate's eligibility cannot be verified, the system will provide additional feedback. This feedback can help identify and resolve any issues.

The table below contains the list of additional feedback which can be used to troubleshoot eligibility configuration and candidate eligibility issues.

Message	Explanation	How to Resolve
Docebo authentication is not valid	Docebo credentials are not valid	Verify Docebo credentials in the Certiverse exam store for the exam are still valid
User not found	The Docebo user ID is obtained using the email address from the Certiverse candidate account. However, no candidate with this email address exists in the corresponding Docebo account.	Ensure that the user is using the same email address in the Certiverse platform and the Docebo platform.
Enrollment Not Found	An enrollment was not located in Docebo for the current user with the Course ID configured in the Certiverse platform.	If eligibility is working for other candidates, ensure that the candidate is enrolled in the correct Docebo course, and that they are not completed. If eligibility is not working for any user, verify the Published Course configured in the Certiverse platform match the Docebo Published Course, and that they are configured correctly.

Eligibility Flow with API Calls

Eligibility Verification

User ID retrieved
1. /manage/v1/user?search_text=email@email.com
2. Email address used to create Certiverse account is passed to Docebo and user_id is returned Candidate is not eligible if user not returned
3. Enrollment in Docebo Course verified
GET: /learn/v1/enrollments/{publishedCourseId}/{userId}
1. {userId} returned in step 1
2. {publishedCourseId} is configured in Certiverse Configuration
3. Candidate is not eligible if:
  1. Published Course not returned
  2. Published Course is completed
Exam completion and Docebo lesson closed
1. PUT: /learn/v1/enrollments/{publishedCourseId}/{userId}
2. Lesson marked completed, set percentage score, and pass/fail status returned to Docebo

Docebo Configuration

Organizations must ensure proper configuration within Docebo. Certiverse needs a course where a candidate is enrolled, as this course progress determines exam eligibility in Docebo. Certiverse will use API calls to Docebo to confirm that a user with the candidate's email is enrolled in the designated course. It is important to note that the Certiverse Org Admin be an Assigned User in Docebo Catalogs which will contain the list of courses available for Eligibility Configuration in the Certiverse Store Portal.*

Docebo Courses, and Published Course Configuration
The correct configuration of the Course in Docebo is critical to ensure seamless and functional integrations. Below are some pointers we have found may help when configuring exam eligibility in Docebo.

Docebo Training Material
After creating a Course in Docebo you will need to add an Assignment as Training Material, which is used to insert the deeplink to the Certiverse Exam.

Docebo Training Material Configuration
Adding a hyperlink in the Assignment Training Material to the exam in the Certiverse Exam Store will create a seamless flow. The “End Object Marker” setting must not be set to “No” to ensure the Course remains open until Certiverse verifies eligibility and closes the lesson with the pass/fail outcome and score.

Contact Us

If you have any questions or need additional assistance, please contact us by either emailing support@certiverse.com or by submitting a ticket from this article.