Codes courts dans les notifications

Introduction

Les shortcodes sont des tags tels que {{course_name}} ou {{first_name}} que vous pouvez inclure dans le texte d’une notification. Ces balises sont remplacées par les données pertinentes lors de l’envoi d’un message de notification.

Cet article fournit plus de détails sur l’utilisation de ces codes courts au sein des notifications. Pour obtenir des instructions complètes sur la configuration de ces dernières, veuillez consulter l’article principal Configurer des notifications.

Les codes courts peuvent être insérés lors de la rédaction du message d’une notification. Les codes disponibles dépendent du type d’événement déclencheur, et l’article Événements et conditions des notifications répertorie les codes courts disponibles pour chaque type d’événement.

Astuce : dans le cadre de la transition vers le nouveau service de notification, l’URL de base des liens dans vos notifications correspondra toujours au domaine de chaque destinataire de la notification. Pour plus d’informations, consultez le chapitre Codes courts de liens et domaines d’entreprise étendue.

À noter : selon le type de notification, les shortcodes {{first_name}}, {{last_name}} et {{username}} peuvent faire référence à l’utilisateur ayant effectué l’action déclenchant la notification, et non à celui qui la reçoit. Par exemple, dans certaines notifications relatives à un cours et envoyées à un Superadmin, ces codes courts contiendront les informations de l’apprenant et non celles du Superadmin. Consultez la description de chaque code court dans les tableaux de référence du chapitre « Référence des codes courts » afin de confirmer le comportement attendu pour la notification que vous configurez.

Codes courts et liens cliquables

Les codes courts faisant référence à des liens, tels que {{course_link}}, ne créent pas de liens cliquables dans les notifications. Ils se contentent d’insérer l'URL au format texte sans balises HTML.

La plupart des clients de messagerie modernes (bureau, mobile ou web) convertissent automatiquement les URL en texte brut en liens cliquables, afin d’améliorer l’expérience utilisateur. Le destinataire recevra donc un lien cliquable, même si seule l’URL a été insérée.

Cependant, si vous voulez vous assurer de créer un lien actif, vous devez intégrer l’URL dans les balises html nécessaires. Vous pouvez le faire de deux manières :

• Utilisez le bouton Insérer/modifier un lien de la barre d’outils et collez le shortcode (par exemple, {{course_link}}) dans le champ URL.
• Utilisez le bouton Code source dans la barre d’outils et insérez directement la balise HTML, en utilisant le shortcode comme attribut href. Par exemple, <a href="{{course_link}}">Mon cours</a>.

Note pour les plateformes des entreprises étendues : référez-vous au chapitre Codes courts de liens et domaines d’entreprise étendue pour découvrir comment le domaine dans l’URL du code court (https:/www.domain.xxx/url_plateforme) est associé au domaine de l’utilisateur destinataire.

Codes courts de liens vers des cours ou sessions

Lorsque vous utilisez des codes courts contenant des liens vers des cours ou sessions, gardez-en mémoire que ces liens ne fonctionnent pas comme des liens profonds. L’utilisateur recevra donc un message d’erreur s’il clique sur le lien sans être inscrit au cours.

Si vous incluez le shortcode {{course_link}} dans des notifications, les utilisateurs cliquant sur le lien seront renvoyés sur une page différente selon leur niveau utilisateur et selon leur statut d’authentification sur la plateforme:

• Si les utilisateurs cliquant sur le lien sont des Superadmins ou des Power Users (disposant de toutes les autorisations sur le cours en question) :
  • S’ils sont connectés à la plateforme, ils se retrouveront sur la page de gestion des cours.
  • S’ils n’y sont PAS connectés, ils se retrouveront sur la page du cours avec la vue apprenant.
• S’ils ont le niveau Utilisateur, ils se retrouveront toujours sur la page du cours avec la vue apprenant, qu’ils soient connectés ou non.

Codes courts avec des dates et des heures

Code court {{expire_at}}

Si vous incluez le shortcode {{expire_at}} dans une notification, l’heure affichée dans les notifications reçues par les utilisateurs tiendra compte de leurs fuseaux horaires.

Codes courts {{event_date}} et {{session_dates}}

Les cours ILT et VILT sont organisés en sessions, chacune pouvant être composée d’un ou plusieurs événements. Lorsqu’un apprenant est inscrit à une session de cours, il est automatiquement inscrit à tous les événements de cette session.

{{event_date}}:

Ce shortcode est remplacé par :

• Le nom de l’événement dans la partie supérieure

• La date et l’heure de début et de fin de l’événement. Ces informations sont fournies à la fois dans le fuseau horaire de l’apprenant et dans celui de l’événement, s’ils sont différents.

  Astuce : les formats de la date et de l’heure dépendent des paramètres de votre plateforme.

• Les détails sur le lieu et la salle de classe de l’événement, s’il s’agit d’un événement en présentiel. Ou virtuel s’il s’agit d’un webinaire.

{{session_dates}}:

Ce code court contient les informations sur la date {{event_date}} de tous les événements de la session. Toutes les informations relatives à la date de l’événement sont incluses, même si certains ou tous les événements sont passés.

Exemple (pour une session de trois événements) :

Codes courts avec identifiants de connexion

Certaines notifications, comme Utilisateur créé, peuvent inclure un shortcode {{user_password}}. Elles peuvent servir à transmettre des instructions de connexion aux utilisateurs, c’est-à-dire le lien vers la plateforme et les informations d’identification à utiliser (nom d’utilisateur et mot de passe).

Dans la notification, le code court {{user_password}} est toujours remplacé par un lien « Réinitialisez votre mot de passe ». En cliquant sur ce lien, l’utilisateur est invité à saisir son adresse e-mail, afin de recevoir un autre lien de réinitialisation pour créer enfin son mot de passe.

Ce flux en deux étapes permet à un administrateur de créer des utilisateurs (avec ou sans mot de passe initial, selon le mécanisme utilisé pour les créer), puis, par le biais de la notification, de demander aux utilisateurs eux-mêmes de créer ou de modifier leurs mots de passe.

Tags {{#items}} et {{/items}}

Il s’agit de balises spéciales utilisées uniquement dans les notifications récapitulatives, afin d’énumérer des listes d’éléments. Ces balises doivent toujours apparaître par paires et être placés autour des shortcodes des éléments que vous souhaitez énumérer.

Pour en savoir plus, consultez l’article sur les Notifications récapitulatives.

Remarque : les balises {{#items}} et {{/items}} sont utilisées dans toutes les notifications récapitulatives. En outre, la notification Résumé : un nouveau contenu est disponible dans les chaînes que vous suivez utilise également les balises {{#channels}} et {{/channels}} .

Codes courts de liens et domaines d’entreprise étendue

Pour les plateformes des entreprises étendues, lorsque l’on utilise des codes courts tels que {{course_link}} dans une notification, l’URL de base du lien doit correspondre au domaine du destinataire. Par exemple, un utilisateur accédant à la plateforme via https:/<branch1_domain>doit recevoir un lien vers un cours dont l’URL de base est identique : https:/<branch1_domain>/path_to_course.

Toutefois, lorsqu’un utilisateur appartient à plusieurs clients d’une entreprise étendue (ce qui est possible sur les plateformes à branches imbriquées ou sur les plateformes permettant de placer des utilisateurs dans plusieurs branches), les notifications n’utilisent pas toujours l’URL de base attendue. Consultez le chapitre Codes courts de liens et branches imbriquées d’entreprise étendue.

Codes courts de liens et branches imbriquées d’entreprise étendue

Si vous avez un domaine d’entreprise étendue associé à une branche mère et un autre domaine associé à une sous-branche, veuillez noter que les utilisateurs de la sous-branche peuvent recevoir des notifications utilisant l’URL de base du domaine parent. Cependant, ils pourront toujours accéder à la ressource du lien.

Code court de logo dynamique {{extend_enterprise_logo}}

Comme indiqué dans le chapitre précédent sur les codes courts, lorsqu’une notification comprend des shortcodes, le système ajuste dynamiquement l’URL de base de ces liens pour qu’elle corresponde au domaine de chaque utilisateur destinataire.

De la même façon, vous pouvez utiliser l’option {{extend_enterprise_logo}} pour récupérer de manière dynamique l’image du logo configurée pour la plateforme du destinataire (qu’il s’agisse de la plateforme racine ou d’un des clients de l’entreprise étendue). De cette manière, chaque destinataire recevra un e-mail avec le logo correspondant à sa plateforme.

Astuce : les notifications incluant des modèles préconfigurés avec un logo utilisent désormais automatiquement ce shortcode pour fournir une image de logo dynamique. Cependant, si vous avez créé des notifications avec une ancienne version du modèle, elles peuvent encore inclure un chemin d’accès fixe à l’image du logo. Dans ce cas, vous pouvez soit recréer la notification avec le modèle actuel, soit modifier manuellement le corps du message pour utiliser le shortcode {{extend_enterprise_logo}} .

Insérer une image de logo dynamique

Pour ce faire, dans la source html du corps de votre message, insérez la balise d’une image contenant le shortcode au lieu d’un chemin d'accès fixe vers l’image :

<img src=”{{extend_enterprise_logo}}” ...>

Astuce : notez que le code court n’insère que le chemin d’accès à l’image du logo en texte clair, et n’affiche pas d’image. Vous devez intégrer le shortcode dans une balise <img src > pour qu’il fonctionne.

Rendre l’image de logo du modèle dynamique

Certaines notifications fournissent des modèles de message préconfigurés qui incluent également une image de logo. Notez que ces modèles font référence par défaut à un chemin d’accès fixe à l’image, tel que :

<img src="/public/images/core/docebo_logo.png" ...>

Ainsi, tous les destinataires recevront des messages avec la même image de logo fixe.

Si vous souhaitez plutôt que les destinataires voient un logo correspondant à celui de leur plateforme d’entreprise étendue, modifiez le corps du message en mode source pour remplacer le chemin d’image fixe par le shortcode :

<img src={{extend_enterprise_logo}}” ...>

Référence des codes courts

Les tableaux ci-dessous répertorient les codes courts disponibles dans les notifications Docebo, classés par catégorie de notification. Les codes courts ne sont pas tous disponibles pour tous les types de notifications. L’article Événements et conditions des notifications dresse une liste des codes courts disponibles pour chaque type d’événement spécifique.

Notifications pour les utilisateurs

Codes courts des managers et subordonnés

Notifications relatives aux cours

Notifications relatives aux cours et sessions ILT

Notifications relatives au contenu pédagogique de type exercice

Notifications relatives aux contenus pédagogiques

Notifications relatives au contenu pédagogique de type test

Notifications e-commerce

Notifications relatives aux certifications

Notifications relatives à la gamification

Notifications relatives à la politique de confidentialité et aux conditions générales

Notifications relatives aux emprunts d’identité

Notifications relatives à l’apprentissage informel

Notifications relatives au forum

Notifications relatives aux plans de formation

Notifications relatives aux checklists d’observation

Notifications relatives aux packs d’abonnements

À noter : les codes courts {{transaction_code}} et {{note}} sont des champs personnalisés auxquels aucune valeur n’est attribuée automatiquement lors de l’achat. Il est déconseillé de les utiliser dans la notification « Le plan d’abonnement a été acheté », sauf si vous êtes certain qu’une valeur a été attribuée.

Notifications relatives aux tags de contenu

Notifications relatives aux compétences