Disclaimer: This article describes the synchronization process and how to use the integration in detail. Please note, however, that the integration covers a large number of scenarios and it is not possible to list all of them here. If this documentation does not provide enough information for your specific case, please contact us via the Help Center.
Introduction
This article will help you in configuring the synchronization of enrollment data between Docebo and Salesforce so that both systems are aligned and synchronized. The data master for enrollment data is Docebo. This data is always synchronized from Docebo to Salesforce, not the other way round. Further information on the Salesforce V3 data model.
Because of its nature, enrollment data is linked to users and course data, so when running the first synchronization, it is not possible to synchronize enrollments if users and course data have not been synchronized. For this reason, the right section of the Sync Enrollments area is enabled only after the users and course synchronization has been properly configured and successfully run.
In order to configure the synchronization process, after installing the Salesforce package, access the Navigation menu > Add-ons and integrations (jigsaw icon) > Salesforce.
Move now to the Synchronization tab. The Sync Enrollments section of this tab is used to configure the synchronization of this data.
Configuring enrollments' synchronization from Docebo to Salesforce
The Sync Enrollments section of the Synchronization tab is used to configure the synchronization of enrollment data from Docebo to Salesforce. Enable the Enrollment toggle and click on Configure. From the right panel select whether to configure:
- Manual synchronization
-
When this option is selected, enrollments data is manually synchronized, meaning that you will have to run the synchronization when needed by selecting the Resynchronize option from the ellipsis menu of the Sync Enrollments section of this tab.
Tip: When choosing this option, remember that if the synchronization is not run by a user, data is not synchronized by the system.
- Realtime synchronized replication
When this option is selected, enrollments data is constantly synchronized by the system, incrementally, every 15 minutes. If you need to resynchronize all enrollment data, or data updated in a specific timeframe, select the Resynchronize option from the ellipsis menu of the Sync Enrollments section of this tab and select a timeframe for your synchronization.
Select the synchronization mode that suits you the best, and press Confirm to go back to the Salesforce synchronization page. Press Start.
Running the synchronization
From the Synchronization tab of the Salesforce configuration page, press Start in the Sync Enrollments area to launch the synchronization process. A panel will open for you to select the period of enrollment data to synchronize. Select a timeframe and press the Confirm button to start the synchronization.
The enrollment synchronization is managed by seven background jobs:
- Salesforce Sync Data enrollments
- Sync Unenrollments Ilt Sessions
- Sync Unenrollments Courses
- Sync Unenrollments Learning Plans
- Sync Enrollments Ilt Sessions
- Sync Enrollments Courses
- Sync Enrollments Learning Plans
You can stop the synchronization at any time while it is running. Click the ellipsis button in the Sync Enrollments box and select Stop Synchronization. In order to re-launch the synchronization, click the ellipsis button again, and select Resynchronization. The synchronization will restart from scratch, it will not restart from where you left off.
Once the synchronization is over, the Synchronization Status will be shown in the right section of the Sync Enrollments area.
If the synchronization process fails or ends with errors, click on the View Logs button to move to the Logs section of the Salesforce configuration page that will open on the event generating the synchronization error or the failure. Further information on synchronization logs.
After the first synchronization, the timestamp of the last synchronization, together with the number of imported enrollments will be displayed on the right side of the Sync Enrollment area.
After the first synchronization, the Start button will no longer be available but you can re-run the synchronization again at any time, by clicking on the ellipsis button under the number of imported enrollments, and selecting Resynchronize.
Thanks to the integration between Docebo and Salesforce, you can monitor the training activity of your learners directly from the Salesforce reports area.
Notes on unenrollments:
- When the enrollment synchronization is run, unenrollments are synchronized as well. Remember that unenrollments are synchronized after the first enrollment synchronization is run. This means that if a user unenrolled (or was unenrolled) from a course or from a learning plan before you run the enrollment synchronization for the first time, the unenrollment will not be tracked, as if the user was never enrolled in the course (or learning plan).
- When you unenroll a user, the user's status does not change in Salesforce. Instead, the field
unenrollmentDateis populated with the date of unenrollment. You can use this field to track unenrollments in Salesforce.- If an enrollment sync is failing with an error referencing missing required fields (such as
docebo_v3__Course__cordocebo_v3__DoceboUser__c), this typically means a user was unenrolled before the initial enrollment sync was run for that record. To troubleshoot missing enrollments, identify the enrollment date of the affected user and course in Docebo, then run a manual resync covering that date range to include the missing record.