Overview
This article provides a step-by-step guide on integrating Skilljar courses with AdvocateHub to reward advocates for their progress in online training. It covers setting up custom events in AdvocateHub and creating Zaps in Zapier to automate the process.
Information
SkillJar's Zapier trigger offers three options, which means that you may use these same three options to reward your advocates in AdvocateHub. Those options are:
- New Course Enrollment
- New Domain Enrollment
- Course Completion
We'll look at how to complete a custom event and award points to an advocate once they have completed a SkillJar course. If you opt for another trigger, change your choice in Part 2 of this article. The workflow will be straightforward:
- Skilljar user completes the course
- Check if an Advocate exists with that email address in your AdvocateHub. If they do not exist, we will create an account for them.
- We then log the custom event to the Member's profile. If the Skilljar user is not a member of your AdvocateHub, the event will still be logged, but they will be added to the Invite List with the name "unknown nominee" and their Skilljar user email. You can invite them later.
- As an optional step, if there is no current Advocate found with Step 2, we can automatically send an invite to the profile we created for them.
Pre-requisites
- Your AdvocateHub plan must include API access.
- You must have a Skilljar course created with at least one completion.
- You must have a Zapier account (free or paid).
Setup Custom Event
Follow the steps in this article to create a custom event in your AdvocateHub called skilljar_course_completion. Replace "skilljar_course_completion" with your custom event's API code if different.
Setup Zap
Let's head over to Zapier and make a new Zap.
- Choose your trigger: Skilljar > Course Completion
- Connect your Skilljar account. You'll need to grab your API key from Skilljar.
- Note: Test your trigger before moving on to the next step.
- Before you create an Action, click the (+) icon and add a Filter.
- Choose "Only continue if..." and hit Continue.
- Make a filter with the following criteria:
-
Course Published Course ID | (Text) Exactly matches | Skilljar published course ID
- Get your Published Course ID by going to the Domains and Publishing section of Skilljar, and clicking the pencil under the Edit column on the course you're looking to award points for.
- Next, copy the number/letter code in the URL of that page (the bit after publish/ and before /edit). That's your Published Course ID.
- Here's an example of what your filter should look like:
-
- In the next step, we will log the Custom Event. Choose the ‘Log Custom Event’ action in the Influitive Zapier app:
- Here, you will add the Email from the Skilljar trigger along with adding the Points you want to be awarded and the API code of the custom event you created earlier. It should look something like this:
- As a final optional step, you can automatically send an invite to the Advocate you may have created. Choose the ‘Send an Invite to a Member in Influitive’ action and add the UUID from the 2nd step in the Zap we have created:
FAQ
What are the prerequisites for integrating Skilljar with AdvocateHub?
You need an AdvocateHub plan with API access, a Skilljar course with at least one completion, and a Zapier account.
How do I set up a custom event in AdvocateHub?
Follow the guide provided in the linked article to create a custom event named skilljar_course_completion or another name as per your preference.
How do I set up a Zap in Zapier for this integration?
Create a new Zap in Zapier, choose the Skilljar Course Completion trigger, connect your Skilljar account, test the trigger, add a filter with specific criteria, and log the custom event in AdvocateHub.