Embed

API and webhooks features are reserved for special accounts.

If you are interested, contact-us.

How it works

The purpose of embed features is to allow you to integrate Cards directly into your site or application.

The integration is available via a url, which you can display in an "iframe" on your side.

Some technical skills are required, but once in place, it can make accessing training easier for your learners, as they do not need to exit your application to view training content.

Controls and access to embed urls

2 levels of controls are present to activate embed windows on Cards:

  • The first is the configuration of your space. It is therefore up to the owner of the space to activate the options or not.

  • The 2nd is at the training level. The option to activate or not the embed windows is therefore done by training, for greater flexibility and security.

This 2-level operation makes it easy to block the "embed" functionality for the entire space, or to restrict the functionality to only a few formations.

To access the options for your space, you must use the upper right menu and click on “Integration”. Then go to the “Embeds” tab.

The 1st option "Activate the embed on your space" allows you to activate or not the embed on your space. If enabled, additional options appear below.

On the training side, you will find the integration options in the “Integrations” tab, on the editing page of each training course.

Let's detail the different integration options - "embed" - available.

Unique embed (via API)

This option allows you to activate or not the generation of "embed" links via the API. To learn more about this system, visit our documentation dedicated to our API.

Embed with email login

If activated, you will be able to have embed windows where users can connect with their email address + a code sent by email.

Here is the url format for this embed option:

https://embed.cards-microlearning.com/login-email/YOUR_TENANT_ID

You can find your space ID on the “My subscription” page.

You can also pass the training to display as an argument (so that people who connect arrive directly at the correct training):

https://embed.cards-microlearning.com/login-email/YOUR_TENANT_ID?training=TRAINING_ID

If a person does not have an account on your space, they will not be able to access the content.

If a person has an account but does not have access to the training, they will not be able to view it. Access to content from user groups must be managed upstream.

Embed with automatic login

How it works

This embed option will allow you to automatically connect the Internet user to their Cards account. This will not need to enter an email address, this being passed as an argument in the embed address.

Here is an url example:

https://embed.cards-microlearning.com/login-auto/YOUR_TENANT_ID?training=TRAINING_ID&email=EMAIL_IN_HEXA

You must therefore pass 2 arguments to this address:

  • the training id to display

  • the user's email address, encoded in hexadecimal

This type of embed window has 2 options to facilitate access to content.

Option on access to training

This option allows you to automatically authorize access to the training if your user is not yet entitled to it.

Access to the content will therefore be transparent for the user, who will be connected automatically, and will necessarily arrive on the training, even if there was no access yet.

Option for automatic user account creation

This 2nd option is a complement to the 1st, because if activated, it automatically triggers the creation of an account with the email address provided as a parameter (if the account does not yet exist).

Automatic user account creation may be blocked if you have reached the limit of your Cards space.

Dernière mise à jour