TalentLMS Automations let you enhance the functionality of your portal by setting up a series of automated actions that are triggered by specific user or portal activity.
Note: Automations are available with all the Premium plans. |
Those actions include calling an external URL whenever a user completes a specific course (i.e., On course X completion, call URL Z). It’s a powerful automation that can be used on many different occasions, and it works like this:
Upon course completion, TalentLMS passes the ID of the user that has completed the course and the ID of the course as GET parameters to your specified external URL. From there on, you can take this information and use it in your own script to implement any logic you need.
For example, you can use it for:
- Updating or synchronizing an external system.
- Performing a custom action (e.g., rewarding the user for completing the course).
- Sending a custom message to the user.
- Updating a custom field in the user’s profile.
- Enrolling the user in another course.
- Calling an external API to do a custom action.
To create the automation, follow these steps:
1. Sign in to your TalentLMS account as Administrator and go to Home > Events engine.
2. On the Notifications/Automations switch, click Automations (1).
3. Click Add automation (2).
4. In the respective field, type a Name (3) for your automation.
5. From the Automation (4) drop-down list, choose On course X completion, call URL Z.
6. Specify the course that, when completed, triggers your action (5).
7. Type the external URL to be called upon course completion (6) (e.g., https://mysite.example.com/myscript.php).
8. Click Add automation to save your automated action.
Now every time a user completes the specified course, TalentLMS calls the specified URL and, at the same time, passes the user and course IDs as GET parameters to the URL (e.g., https://mysite.example.com/myscript.php?user=123&course=50).
Note: In case you need to call a specific URL upon any course completion, from the Automation drop-down list, choose On course X completion, call URL Z and select the option "Any course". |
That way, you can use the On course X completion, call URL Z automation to build your custom logic into your external script (e.g., connect to a database and update specific fields, call an API to perform a custom action, send an email, etc.).
Note: If you need more information than just the user and course ID to pass as URL parameters, you can call our API to retrieve them. For example, since you know the user's ID, you can call the “/v1/users/id:{userId}” endpoint to pull more user information (i.e., first name, last name, email, gamification level, gamification points, etc.). You can do the same for the course by calling the “/v1/courses/id:{courseId}” endpoint. |