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.

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/path_url_platform ) 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

• 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.
• {{session_dates}} :
  Lorsqu’un utilisateur s’inscrit à une session de cours ILT, il est automatiquement inscrit à tous les événements de cette session. Les dates de la session sont celles auxquelles ces événements sont programmés.
  →Le code court {{session_dates}} récupère toutes les dates de la session, même si certaines (ou toutes) sont déjà passées.

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.

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:/<branch1_domain> doit recevoir un lien de cours avec la même URL de base 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.

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 pour entreprise étendue {{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, sur les plateformes d’entreprise étendue, vous pouvez utiliser l’option {{extend_enterprise_logo}} pour récupérer de manière dynamique l’image du logo configurée pour le client de l’entreprise étendue du destinataire. De cette manière, chaque destinataire recevra un courriel avec le logo correspondant à sa plateforme.

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.

De plus, en utilisant le shortcode, vous ne verrez plus l’aperçu de l’image dans la zone de rédaction du message. En effet, l’image correspondant à chaque destinataire n’est récupérée dynamiquement qu’au moment de l’envoi du message.

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}}” ...>

À noter : le code court {{extend_enterprise_logo}} est destiné à être utilisé uniquement sur des plateformes d’entreprise étendue.