Générer un lien de connexion à l'espace apprenant

Wedof vous permet de générer un lien de connexion magique pour un dossier de formation, afin que l'apprenant accède directement à son espace personnel sur ce dossier, sans avoir à créer de mot de passe.

Le lien est généré par l'organisme de formation propriétaire du dossier, puis transmis à l'apprenant par le canal de votre choix (email, SMS…).

Prérequis

Être connecté à Wedof avec un compte ayant les droits d'édition sur le dossier
Être l'organisme de formation propriétaire du dossier de formation

Si vous n'êtes pas autorisé sur le dossier, la génération est refusée (« Erreur, vous n'êtes pas autorisé à générer un lien de connexion pour ce dossier. »)

Génération du lien

Endpoint : POST /api/registrationFolders/{externalId}/generateAttendeeMagicLink

Le lien retourné connecte l'apprenant puis le redirige vers son espace sur le dossier indiqué (/apprenant-{externalId} ).

Rediriger vers un document précis (optionnel)

Vous pouvez faire en sorte que l'apprenant arrive directement sur un document du dossier après connexion, plutôt que sur l'accueil de son espace.

Pour cela, ajoutez le champ fileId dans le corps de la requête :

json { "fileId": 1234 }

fileId est l'identifiant du document du dossier concerné. L'apprenant est alors redirigé directement vers ce document après s'être connecté.

Note : si le fileId fourni ne correspond à aucun document de ce dossier, la requête échoue avec une erreur (« Le document associé à l'id … n'a pas été trouvé pour ce dossier. »).

Le champ fileId est facultatif. Sans lui, le lien redirige vers l'accueil de l'espace du dossier.

Réponse

En cas de succès, l'endpoint renvoie un JSON contenant l'URL du lien de connexion à transmettre :

json { "url": "https://www.wedof.fr/auth/magic-link-auth?..." }

Cette URL est à transmettre à l'apprenant par le canal de votre choix.

Traçabilité

Note : chaque génération de lien est tracée dans l'historique du dossier sous forme d'activité de type « connexion » (« Un lien de connexion à l'espace apprenant a été généré »).