Seamless Integrations

eduMe's Seamless access allows your users to access content in an immediate, frictionless way through seamless links and the seamless dashboard

What's covered

What's the benefit of using seamless access?

Seamless links

How do seamless links work?

How to set up a seamless link

How to generate a seamless link

Seamless dashboard

How does the seamless dashboard work?

How to set up the seamless dashboard

FAQs


What's the benefit of using seamless access?

Seamless access removes friction from the user journey, resulting in higher completion rates which in turn leads to behaviour change across your organisation and tangible business results.

Seamless links securely take your users directly to their learning content, without the need for logging in, while the seamless dashboard exists within your own application, providing a hub for direct access to learning content.

Here are just some of the benefits of using eduMe's seamless access integration:

  • Seamless Links

    • Learners are taken straight to the content with no need for login details or passwords

    • Increase course completion rates by removing barriers to accessing content
  • Seamless Dashboard
    • Support ongoing training by providing learners with access to all of their relevant training within their current workflow

    • Reduce time to implement ongoing courses by using the eduMe admin platform to assign and reassign end-users to new training, without app releases

    • There’s no need for learners to open new browser windows or download new apps, further reducing friction

    • Provide learners with a quick insight into the current status of training to be completed


Seamless links

How do seamless links work?

We provide a base link that you add a user ID to, creating a unique link for a specific user. We also give you a secret key which you can use to generate a signature to add to the end of the link for security and authentication.

This link then allows a user to access eduMe courses without entering any user details or passwords.

On the reporting side, you will see the user ID you supply, which you can use to match to your systems. You won’t see users’ names, email addresses or phone numbers as we don’t capture this information.

How to set up a seamless link

 

Prerequisites

There are a few things you’ll need to have in place in order to use seamless links. It will also require some development effort to set up from scratch (if not using another solution, such as Braze.

Requirement Description

Unique User ID

Your organisation needs to have a unique ID for each user

Signing secret key

Ability to store the signing secrets in a secure place in your servers (not needed if using Braze)

Team or Group ID(s)

You will need to get the IDs of the teams or groups within eduMe that you want your users to join. This can be one team or multiple teams, within one group. If multiple IDs, they should be separated by a comma

Module/Lesson/Survey ID

Depending on the type of seamless link (see below) you would also need the ID of the relevant content

Access to base link in admin panel

You'll find this in the Delivery tab of your course (details below). Don't see this? Contact support@edume.com to set this up

How to generate a seamless link


Copy the base link from the admin panel
  1. Head to the Learning tab and open the course you're generating a link for
  2. Click on the Delivery tab and ensure the course has been assigned to the relevant team(s)
  3. Click the Copy link button and select Seamless link. This has now copied the base link and includes your module/lesson ID and team ID

Screenshot 2022-02-16 at 15.35.33

Here's how the base link should look for a module link:

https://learn.edume.com/e/m/:moduleId?g=:teamId

 

Generate the signature

Before you generate the signature, you must:

  • Have a pre-shared signing secret that eduMe knows

  • Know appropriate links to eduMe content that can have User ID added (you either know links we've shared with you when coordinating content creation, or know how to generate links)

  1. Locate the URL for the relevant content
  2. Add your User ID as a query parameter
  3. Create signature of step 2 URL (SHA256 HMAC of secret and step 2 URL)

  4. Add signature to URL as sig query parameter

  5. Store and share user-specific and signed URL from step 4 as appropriate


    See below for a code snippet example (Node.js):

    import crypto from 'crypto'; 



    const generateSignature = (urlWithUserId, secret) => { 

    return crypto 

    .createHmac('sha256', secret) 

    .update(urlWithUserId) 

    .digest('hex'); 





    const moduleId = 123; 

    const teamId = 5; 

    const userId = 'abc123'; 



    // store more securely! (e.g. as an environment variable) 

    const secret = 'secret_from_edume'; 

    const url = `https://learn.edume.com/e/m/${moduleID}?g=${teamId}&e=${userId}`; 

    const signature = generateSignature(url, secret); 

    const finalUrl = `${url}&sig=${signature}`;

 

Personalise the base link

  1. Add the external User ID
  2. Add the link signature (this is a hash of the rest of the url, which we use to verify that the url was legitimately created by the client)

Here's how the personalised link should look for a module link:

https://learn.edume.com/e/m/:moduleId?g=:teamId&e=:externalUserId&sig=:linkSignature

Seamless dashboard

How does the seamless dashboard work?

Once users are in your app, there will be several points at which they can interact with eduMe content. We’ve shown a few examples below in our mock app, My Rickshaw:

  1. On the home screen of the app, you’ll see a button that takes users to an intro lesson about using the app itself

  2. In the menu navigation, you’ll see a link to an example of Courier Academy. This option embeds the list of all assigned courses and is personalised to each learner

  3. Users can report issues on a selected trip. This pulls up a contextual lesson about how to keep a high score

You can also use eduMe course completion data to determine where to surface learning content, for example, restricting access to certain areas within your app until mandatory learning has been completed and the minimum pass rate achieved.

How to set up the seamless dashboard

Make sure you have access to both the seamless links and seamless dashboard features in your admin panel. If you're not sure whether you have this, reach out to your Customer Success Manager or support@edume.com

Generate the base link

  1. Go to either the Learning or People tab

  2. Click on Get a dashboard link

  3. Select the relevant teams you'd like users to join

  4. Click the Copy link button

Screenshot 2022-02-16 at 16.44.07

Here's how the base part of your link should look:

https://learn.edume.com/e/m/:moduleId?g=:teamId

 

Personalise the link

  1. Add the external User ID
  2. Add the link signature

Here's how your personalised link should look:

https://learn.edume.com/e/m/:moduleId?g=:teamId&e=:externalUserId&sig=:linkSignature

This link can then be inserted anywhere in your native application and opened in an in-app browser to provide a seamless experience to the end-user.

 

Assigning teams and users

Before sharing this link with your learners, make sure you have courses assigned to the relevant team IDs (otherwise they won't see any courses when accessing their dashboard).

To assign a user to a team, you'll need to map eduMe team IDs to specific end-user attributes within your services. This will allow you to personalise the seamless dashboard link with the correct team IDs for the end-user. An up-to-date list can be pulled from the API.

 

Ongoing user management

Once you have your seamless dashboard set up within your application, there are a few ways to assign new courses and manage what learning content your learners can see.

  • Via the seamless dashboard link

Within the seamless dashboard link, you can specify multiple team IDs. Amending this will update the user's personalised dashboard by adding them to a new team and surfacing any associated team courses in their dashboard when they next access it.

  • Via the eduMe admin panel

Once a user has been created in eduMe, you can manage them using our admin tools to publish new training to a team, reassign them to new teams for new or additional training, reassign previously taken courses or remove users from a currently assigned team.

Please note that if a user is manually removed from a team in the eduMe admin platform and their seamless dashboard link is not updated to reflect another team, they will be re-assigned to this team the next time they open it.

  • Via existing seamless Links

Once an end-user is created via an existing type of seamless link, this course and any other courses assigned to the end-user will automatically display in the seamless dashboard the next time they open it.

FAQs

Q. Can I customise the look and feel of the seamless dashboard?

A. We can customise the dashboard with your brand colours and logo. Simply request this to our support team

Q. Where can I find course completion data to customise the flow?

A. If you want to surface eduMe content based on completion of that same (or some other) content, you can use our Webhooks or Status API endpoints to get that info at the point of need.

This data can also be used to restrict access to certain parts of your app based on whether certain mandatory content has been completed

Q. Will my users receive eduMe notifications?

A. Notifications are not supported for embedded eduMe content, however you can still use Braze or other third party tools to deliver in-app messaging that links to your embedded eduMe content