Embed
Les fonctionnalités d'API et de webhooks sont réservées aux comptes supérieurs.
Si vous êtes intéressé, n'hésitez pas à nous contacter.
Principe et fonctionnement
Les fonctionnalités d'embed ont pour but de vous permettre d'intégrer Cards directement sur votre site ou votre application.
L'intégration est disponible via une url, que vous pouvez afficher en "iframe" de votre côté.
Quelques compétences techniques sont nécessaires, mais une fois en place, cela peut faciliter l'accès aux formations pour vos apprenants, ces derniers n'ayant pas besoin de sortir de votre application pour consulter les contenus de formation.
Contrôles et accès aux urls embed
2 niveaux de contrôles sont présents pour activer les fenêtres embed sur Cards :
Le premier est au niveau de la configuration de votre espace. C'est donc au propriétaire de l'espace d'activer ou non les options.
Le 2ème est au niveau des formations. L'option d'activer ou non les fenêtre embed se fait donc par formation, pour plus de souplesse et de sécurité.
Ce fonctionnement à 2 niveaux permet de facilement bloquer la fonctionnalité "embed" au niveau de tout l'espace, ou de restreindre la fonctionnalité à quelques formations seulement.
Pour accéder aux options de votre espace, il faut utiliser le menu supérieur droit, et cliquer sur "Intégration". Rendez-vous ensuite sur l'onglet "Embeds".
![](https://doc.cards-microlearning.com/~gitbook/image?url=https%3A%2F%2F1899807099-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAsW3Pbi7E5c7rFM4FYSg%252Fuploads%252FI6BCCfSJ95gR6FXDgl6Y%252Ftenant-embed-options.jpg%3Falt%3Dmedia%26token%3Dcd32be2a-d062-4191-ac2e-ec3d1e6e2ef1&width=768&dpr=4&quality=100&sign=6460a71b&sv=1)
La 1ère option "Activer l'embed sur votre espace" permet d'activer ou non l'embed sur votre espace. Si activée, les options supplémentaires s'affichent en dessous.
Côté formation, vous retrouverez les options d'intégration dans l'onglet "Intégrations", sur la page d'édition de chaque formation.
Détaillons les différentes options d'intégration - "embed" - disponibles.
Embed uniques (via l'API)
Cette option permet d'activer ou non la génération de lien "embed" via l'API. Pour en savoir plus sur ce système, rendez-vous sur notre documentation dédiée à notre API.
Embed avec connexion par mail
Si activée, il vous sera possible d'avoir des fenêtres embed où les utilisateurs pourront se connecter avec leur adresse mail + un code envoyé par email.
![](https://doc.cards-microlearning.com/~gitbook/image?url=https%3A%2F%2F1899807099-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAsW3Pbi7E5c7rFM4FYSg%252Fuploads%252Fc3TW9tm8JlAYGoGl84wR%252Flogin-email-embed.jpg%3Falt%3Dmedia%26token%3D1bd93f83-16a2-441a-beb3-76b3b69abb8f&width=768&dpr=4&quality=100&sign=bcfc236c&sv=1)
Voilà le format d'url pour cette intégration :
Vous pouvez retrouver l'identifiant de votre espace sur la page "Mon abonnement".
Vous pouvez également passer la formation à afficher en argument (pour que les personnes qui se connectent arrivent directement sur la bonne formation) :
Si une personne n'a pas de compte sur votre espace, elle ne pourra pas accéder au contenu.
Si une personne a un compte mais n'a pas accès à la formation, elle ne pourra pas la voir. Il faut en amont gérer l'accès au contenu à partir des groupes d'utilisateurs.
Embed avec connexion automatique
Fonctionnement
Cette option embed va vous permettre de connecter automatiquement l'internaute à son compte Cards. Celui-ci n'aura pas besoin de saisir d'adresse mail, celle-ci étant passée en argument dans l'adresse embed.
Voilà un exemple d'url :
Vous devez donc passer 2 arguments à cette adresse :
l'id de la formation à afficher
l'adresse email de l'utilisateur, encodée en hexadécimale
Ce type de fenêtre embed possède 2 options pour faciliter l'accès aux contenu.
Option sur les accès aux formations
Cette option permet d'autoriser automatiquement l'accès à la formation si votre utilisateur n'y a pas encore droit.
L'accès au contenu sera donc transparent pour l'utilisateur, qui sera connecté automatiquement, et arrivera forcément sur la formation, même s'il n'y avait pas encore accès.
Option sur la création automatique de compte utilisateur
Cette 2ème option est un complément de la 1ère, car si activée, elle permet de déclencher automatiquement la création d'un compte avec l'adresse mail fournie en paramètre (si le compte n'existe pas encore).
La création de compte utilisateur automatique peut être bloquée si vous avez atteint la limite de votre espace Cards.
Dernière mise à jour