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.

Docebo Notification Configuration

Establishing Docebo Eligibility Connector

Log in to Certiverse
Navigate to the Admin Portal
Select the Connectors tab
In the left menu, choose Eligibility
Click Connect on the Docebo card
Click Add Connector (top-right)

Connector Setup

General Settings

Connector Type: Eligibility
Connector Name: Provide a display name for the connector

Docebo Eligibility Credential Settings

Provide the following information
1. API Credentials
  1. Client Id
  2. Client Secret
User Authentication Credentials

1. Username
2. Password
Partner Endpoint
1. Domain
Click Validate to ensure the connection is valid
Click Create

Store Configuration

Navigate the Store tab
Click EDIT for the desired exam
Locate the Eligibility Configuration tab within the Exam
Select the configured Organization Connector
Configure Exam Enrollment Status for candidates
1. Define how a candidate’s enrollment status is updated when they receive a Failed exam result or complete a Non Graded (Beta) exam.
2. Options Available:
  1. Failed
  2. Non Graded
Click Save

Docebo API Integration Behavior

Candidate Flow and Eligibility Verification

Eligibility verification between Certiverse and Docebo occurs when a candidate selects an exam from either the Organization landing page or a direct exam deep link. If the candidate is not already logged in to Certiverse, they will be prompted to log in or create a new account. The email address associated with the Certiverse account must match the email address on the candidate’s Docebo account used for course enrollment. Once the Docebo API confirms eligibility, the candidate may proceed to book the exam.

Candidate Exam Results

After the exam is completed, Certiverse uses the Docebo API to update the learner’s course status with the pass/fail outcome, 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 lists common system feedback messages that you can use to diagnose and resolve eligibility configuration and candidate eligibility issues.

System Feedback 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 LMS 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.

Ensure that the Certiverse Org Admin is configured as an Assigned User in the relevant Docebo Catalogs. These catalogs define the list of courses that will be available for Eligibility Configuration in the Certiverse Store Portal.

Docebo Courses, and Published Course Configuration

Properly configuring the Course in Docebo is essential for seamless, reliable integrations. The following guidance outlines best practices for setting up exam eligibility in Docebo.

Docebo Training Material
After you create a Course in Docebo, you must add an Assignment as Training Material. This Assignment will contain the deep link to the Certiverse exam.

Docebo Training Material Configuration
Add a hyperlink in the Assignment Training Material that directs learners to the exam in the Certiverse Exam Store to create a seamless experience. Ensure the “End Object Marker” setting is not set to “No” so the Course remains open until Certiverse verifies eligibility and updates the lesson with the pass/fail result 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.