Codes courts dans les notifications

Attention : cet article explique comment utiliser le nouveau service de notification, qui sera publiquement disponible pour tous les clients début 2025. Pour en savoir plus sur le calendrier de déploiement, consulter le post sur le déploiement progressif du nouveau service de notification sur le portail communautaire de Docebo.
→Si vous observez des différences entre votre plateforme et ce qui est décrit dans cet article, merci de consulter l’article sur la version héritée de l’application de notification.
Plus d’informations sur le cycle de publication de Docebo.

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.

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

Shortcode {{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.

Shortcodes {{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.
  → 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 du code {{event_date}}, et ce pour 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.

Balises {{#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, en utilisant 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 qui accède à la plateforme à l’adresse https:/ doit recevoir un lien de cours avec la même URL de base https:/https://chemin_vers_cours .

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.

Par exemple, avec la configuration suivante :

Un utilisateur appartenant au groupe Sales pourrait s’attendre à recevoir des notifications avec des liens utilisant l’URL de base de son domaine (academy70.docebosaas.com/paperoga)
Toutefois, étant donné qu’un tel utilisateur appartient aussi implicitement à la branche Marketing (parent de Sales), il pourrait recevoir des liens utilisant l’autre URL de base (academy70.docebosaas.com/academy)

→ Dans un tel scénario parent/enfant, il n’est pas garanti que les liens du code court contiennent l’URL de base attendue, bien que même avec l’URL « parent », les ressources seront toujours accessibles pour l’utilisateur.

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 :

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 :
 

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 :