> For the complete documentation index, see [llms.txt](https://doc.cards-microlearning.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.cards-microlearning.com/apps-and-integrations/dendreo.md).

# Dendreo

L'intégration entre Cards et Dendreo vous permet : 

* d'importer vos participants automatiquement dans Cards
* d'associer vos formations Cards à vos e-learning dans Dendreo
* d'inscrire automatiquement vos apprenants à des formations sur Cards
* de proposer la connexion en 1 clic à vos participants
* de faire remonter la progression de vos participants dans Dendreo.

{% hint style="info" %}
[Contactez-nous](https://www.cards-microlearning.com/contact) pour activer l'intégration Dendreo sur votre espace Cards
{% endhint %}

### Configuration dans Cards

Une fois que nous avons activé l'intégration sur votre espace, vous pourrez accéder à la page de configuration en passant par le menu "App et intégrations" puis "Dendreo".

<figure><img src="/files/tHS3FDWaUtKppmmEynMh" alt=""><figcaption><p>Configuration de l'intégration Dendreo</p></figcaption></figure>

Sur cette page vous devrez renseigner la clé de signature fournie par Dendreo. Cette clé permet de sécuriser les échanges entre les 2 plateformes.

Vous trouverez cette clé dans Dendreo, dans Configuration > LMS E-Learning > Connecteur LMS Universel.

### Configuration dans Dendreo

Pour activer les synchronisations entre Cards et Dendreo, plusieurs informations sont à renseigner dans Dendreo. Cette configuration se passe dans Configuration > LMS E-Learning > Connecteur LMS Universel.

#### Réglages de la connexion à votre instance

<figure><img src="/files/QusiqWo0PqxpoU2epSCF" alt=""><figcaption></figcaption></figure>

La 1ère étape permet de configurer la connexion. Vous pouvez renseigner :&#x20;

* le nom du lms : Cards
* le nom de votre instance (Tenant ID) : ID de votre espace Cards.

Et c'est ici que vous trouverez la clé de signature (que vous renseignez dans Cards).

#### Configuration de l'accès API

<figure><img src="/files/wS8d16T3Bi0eXV9XJn2C" alt=""><figcaption></figcaption></figure>

Cette configuration permet de retrouver vos formations Cards dans Dendreo quand vous créez un e-learning, et donc d'associer les deux.

Le 1er champ est l'url de l'endpoint API, c'est toujours le même : `https://api.cards-microlearning.com/v1/trainings`

Le 2ème champs "Header au format JSON" contient les clés nécessaires à la bonne connexion à l'API de Cards. Le format est le suivant :&#x20;

```
{"X-Tenant": "VOTRE-ID-ESPACE-CARDS", "Authorization": "Bearer CLE-API", "Content-Type": "application/x-www-form-urlencoded"}
```

Vous devez remplacer les valeurs :&#x20;

* VOTRE-ID-ESPACE-CARDS : renseignez vos id d'espace Cards (il est affiché sur la page de configuration de l'intégration Dendreo dans Cards)
* CLE-API : une clé API Cards que vous devez créer (voir [notre documentation API](https://docapi.cards-microlearning.com/demarrage-rapide/creer-une-cle)), et qui doit avoir le périmètre d'accès au listing des formations.

Enfin, les 3 derniers champs à renseigner :&#x20;

* Nom du champ d'id : `id`
* Nom du champ nom : `title`
* Nom du champ description : `description`

#### Configuration des webhooks

<figure><img src="/files/5WNcGWYLF9D2Hfd8qCUZ" alt=""><figcaption></figcaption></figure>

Les webhooks permettent à Cards de savoir quand créer un utilisateur et l'inscrire à une formation. L'url à renseigner est la même pour les 3 champs : `https://api.cards-microlearning.com/dendreo/webhook`

{% hint style="info" %}
Le 3ème champ pour les Sessions n'est pas utilisé actuellement, car Cards n'a pas de notion de "Session".
{% endhint %}

#### URLs d'accès côté Administrateurs

<figure><img src="/files/KfbHcoOAEzkQvoim4Vj4" alt=""><figcaption></figcaption></figure>

Vous pouvez renseigner ces 2 champs afin d'avoir des liens d'accès rapide depuis votre administration Dendreo (sur la fiche d'un participant par exemple, pour accéder à son profil sur Cards).

Les urls à renseigner son :&#x20;

* fiche utilisateur : `https://app.cards-microlearning.com/manage/users/[user_id]`
* fiche formation : `https://app.cards-microlearning.com/manage/trainings/[training_id]/edit`

#### Accès au LMS par les Participants

<figure><img src="/files/RP5yc0Gzw5mfphybnYCd" alt=""><figcaption></figcaption></figure>

Cette configuration sert à faire le lien entre l'espace Particpant Dendreo et Cards. Vos participants pourront alors accéder à Cards depuis leur espace Dendreo, et être connecté automatiquement sur Cards pour compléter leur formation.

Le 1er champ permet de faire le lien vers la formation automatiquement. Vous pouvez renseigner la valeur : `https://app.cards-microlearning.com/trainings/[training_id]` .

Le 2ème champ est celui qui permet la connexion en 1 clic, entre Dendreo et Cards. Vous devez renseigner : `https://app.cards-microlearning.com/login-dendreo/ID-ESPACE-CARDS` en remplaçant "ID-ESPACE-CARDS" par votre id d'espace. L'url complète est disponible sur votre page de configuration d'intégration Dendreo sur Cards.

### Fonctionnement des synchronisations

#### Créer une formation Dendreo associée à une formation Cards

Quand vous créer une formation dans votre catalogue Dendreo, vous pouvez définir le "mode d'organisation" à "e-learning". Une bloc d'option "LMS" est alors disponible, et vous permet de choisir une formation Cards :&#x20;

<figure><img src="/files/JGr5b6eFlXgMExGPy3zv" alt=""><figcaption></figcaption></figure>

Dans ce bloc vous pouvez renseigner le 1er champ uniquement, en trouvant la formation que vous souhaitez associer.

#### Synchronisation des utilisateurs

La synchronisation des utilisateurs se fait au moment de l'association d'un particpant à une action de formation (ADF) sur Dendreo (et non à la création du particpant).

Lorsque le participant est inscrit à une ADF, il sera créé sur Cards (si son compte n'existe pas encore), et l'accès à la formation sera donné. Si son compte existe déjà sur Cards, il sera associé au particpant Dendreo.

Sur son profil utilisateur côté Cards, vous pourrez voir les accès aux formations en "direct", c'est-à-dire qu'il a accès à la formation non pas par un groupe ou une routine, mais par un accès géré en direct (via la synchro Dendreo dans notre cas).

Sur le listing des utilisateurs dans Cards, vous pouvez activer l'affichage du tag "Dendreo" pour voir quels comptes ont été créés via la synchronisation Dendreo :

<figure><img src="/files/Q52ZAkw5181J1bcjTnAy" alt=""><figcaption></figcaption></figure>

#### Connexion en 1 clic depuis l'espace participant Dendreo

Grace à la configuration de la connexion en 1 clic, le participant peut accéder à Cards depuis sont espace Dendreo, sans avoir besoin de se reconnecter.

Les modules Cards sont listés sur son espace, et un bouton permet d'y accéder :&#x20;

<figure><img src="/files/N4btNGsrNGsKaMRR6Uvw" alt=""><figcaption></figcaption></figure>

#### Remontée des progressions dans Dendreo

La remontée des informations de progression des participants se fait automatiquement. Vous pourrez donc suivre la progression et les scores obtenus pour chaque participants, directement dans Dendreo.

Ces informations sont notamment disponibles dans la partie "Reporting" de Dendreo.