

**Avis de fin de support :** le 30 octobre 2026, le support d'Amazon Pinpoint AWS prendra fin. Après le 30 octobre 2026, vous ne pourrez plus accéder à la console Amazon Pinpoint ni aux ressources Amazon Pinpoint (points de terminaison, segments, campagnes, parcours et analytique). Pour plus d’informations, consultez [Fin de la prise en charge d’Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Remarque :** en ce qui APIs concerne les SMS, la voix, le push mobile, l'OTP et la validation des numéros de téléphone ne sont pas concernés par cette modification et sont pris en charge par AWS la messagerie utilisateur final.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Modèles de messages Amazon Pinpoint
<a name="messages-templates"></a>

Si vous concevez et envoyez fréquemment un certain type de message, tel qu'un bulletin hebdomadaire ou un rappel de rendez-vous, vous pouvez le créer et l'enregistrer en tant que modèle de message. Vous pouvez ensuite utiliser le modèle comme point de départ chaque fois que vous avez besoin d’envoyer ce type de message, au lieu de concevoir et d'écrire à nouveau le message.

Un *modèle de message* est un ensemble de contenu et de paramètres que vous pouvez créer, enregistrer, puis réutiliser dans les messages que vous envoyez pour l’un de vos projets Amazon Pinpoint. Lorsque vous créez un modèle de message, vous spécifiez le contenu que vous souhaitez réutiliser dans les divers composants de messages qui sont basés sur le modèle. 

Ces composants sont appelés des *parties de modèle*. Elles peuvent contenir du texte statique, du contenu personnalisé, des images et d'autres éléments de conception, selon le type de modèle. Une partie de modèle peut également contenir des paramètres spécifiques au canal. Par exemple, une partie de modèle d’un modèle de notifications push peut spécifier un son personnalisé à lire ou une image à afficher lorsqu'un destinataire reçoit une notification push basée sur le modèle.

Lorsque vous créez un message, vous pouvez choisir un modèle à utiliser pour le message. Si vous choisissez un modèle, Amazon Pinpoint renseigne le message avec le contenu et les paramètres du modèle.

Vous pouvez créer les types de modèles de message suivants dans Amazon Pinpoint :
+ **Email templates (Modèles d'e-mail)** pour les e-mails que vous envoyez à partir de campagnes ou de parcours, ou à un public restreint en tant que messages directs ou de test.
+ **Push notification templates (Modèles de notifications push)** pour des notifications push que vous envoyez à partir de campagnes ou à un public restreint en tant que messages directs ou de test.
+ **SMS templates (Modèles de SMS)** pour les SMS que vous envoyez à partir de campagnes ou à un public restreint en tant que messages directs ou de test.
+ **Voice templates (Modèles vocaux)** pour les messages vocaux que vous envoyez en tant que messages directs ou de test.

En plus de prendre en charge plusieurs types de modèles de message, Amazon Pinpoint prend en charge la gestion des versions des modèles de message. La gestion des versions permet de concevoir et de modifier un modèle au fil du temps, tout en créant et en conservant un historique. Elle permet également de préciser la version d'un modèle qui peut être utilisée dans les messages. Pour en savoir plus sur les versions des modèles, reportez-vous à la section [Gestion des versions des modèles de message](message-templates-versioning.md).

Les rubriques de ce chapitre expliquent comment créer et gérer des modèles de message pour votre compte Amazon Pinpoint.

**Topics**
+ [

# Création de modèles d'e-mail
](message-templates-creating-email.md)
+ [

# Création de modèles intégrés à l’application
](message-templates-creating-inapp.md)
+ [

# Création de modèles de notification push
](message-templates-creating-push.md)
+ [

# Création de modèles de SMS
](message-templates-creating-sms.md)
+ [

# Création de modèles vocaux
](message-templates-creating-voice.md)
+ [

# Ajout de contenu personnalisé aux modèles de messages
](message-templates-personalizing.md)
+ [

# Utilisation des assistants de modèles de messages
](message-template-helpers.md)
+ [

# Gestion des modèles de message
](message-templates-managing.md)
+ [

# Gestion des versions des modèles de message
](message-templates-versioning.md)

# Création de modèles d'e-mail
<a name="message-templates-creating-email"></a>

Un *modèle d’e-mail* est un type de modèle de message qui contient le contenu et les paramètres que vous souhaitez créer, enregistrer et réutiliser dans les messages électroniques que vous envoyez pour l’un de vos projets Amazon Pinpoint. Vous pouvez utiliser un modèle d’e-mail dans n’importe quel type de message par e-mail que vous créez et envoyez à l’aide d’Amazon Pinpoint.

Lorsque vous créez un modèle de message, vous spécifiez le contenu et les paramètres que vous souhaitez réutiliser dans les divers composants de messages qui sont basés sur le modèle. Ces composants, appelés *parties de modèle*, peuvent être l'objet du message, le corps du message ou les deux. Le contenu peut être du texte statique, du contenu personnalisé, des images ou d'autres éléments de conception. Une partie de modèle peut également être un paramètre, notamment le corps du message à utiliser si l'application de messagerie d'un destinataire n'affiche pas de contenu HTML.

Lorsque vous créez un message e-mail basé sur un modèle, Amazon Pinpoint le remplit avec le contenu et les paramètres que vous avez définis dans le modèle. 

**Pour créer un modèle d’e-mail**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sélectionnez **Create template (Créer un modèle)**.

1. Sous **Channel (Canal)**, choisissez **Email (E-mail)**.

1. Sous **Template details (Détails du modèle)**, pour **Template name (Nom du modèle)**, entrez un nom pour le modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (\$1) ou des traits d’union (‐).

1. (Facultatif) Pour **Version description (Description de la version)**, saisissez une brève description du modèle. La description peut contenir jusqu'à 500 caractères.

1. Sous **Email details (Détails de l'e-mail)**, utilisez les options suivantes pour spécifier le contenu des messages qui utilisent le modèle :
   + Pour **Subject (Objet)**, saisissez le texte que vous souhaitez afficher dans la ligne d'objet du message.
   + Pour **Message**, saisissez le contenu que vous souhaitez afficher dans le corps du message.
**Astuce**  
Pour le corps du message, vous pouvez saisir le contenu en mode HTML ou Design (Conception). En mode HTML, vous pouvez saisir manuellement un contenu HTML, y compris le formatage, les liens, ainsi que d'autres fonctions que vous souhaitez inclure dans le message. En mode Design (Conception), vous pouvez utiliser un éditeur de texte enrichi pour saisir le contenu. Utilisez la barre d'outils de mise en forme pour appliquer la mise en forme et ajouter des liens et d'autres fonctionnalités au contenu. Pour changer de vue, choisissez **HTML** ou **Design** dans le sélecteur de vue situé au-dessus de l’éditeur de messages.  
Vous pouvez également inclure du contenu personnalisé dans l’objet et le corps du modèle. Pour cela, ajoutez des variables de message qui font référence à des attributs spécifiques qu’Amazon Pinpoint ou vous-même avez créés (attribut qui stocke le prénom d’un utilisateur, par exemple). En utilisant des variables de message, vous pouvez afficher différents contenus pour chaque destinataire d'un message qui utilise le modèle. Pour utiliser une variable de message, choisissez le nom d’un attribut existant dans l’outil de **Recherche d’attributs**. Amazon Pinpoint crée une variable de message pour l’attribut et la copie dans votre presse-papiers. Collez la variable à l'emplacement souhaité. Pour de plus amples informations, veuillez consulter [Ajout de contenu personnalisé aux modèles de messages](message-templates-personalizing.md).

1. 
**Note**  
Vous devez configurer un rôle d'envoi d'orchestration d'e-mails avant de pouvoir utiliser les en-têtes d'e-mail. Pour de plus amples informations, veuillez consulter [Création d'un rôle d'envoi d'orchestration d'e-mails dans Amazon Pinpoint](channels-email-orchestration-sending-role.md).

   Sous **En-têtes**, choisissez **Ajouter de nouveaux en-têtes** pour ajouter jusqu'à 15 en-têtes pour le message électronique. Pour obtenir la liste des en-têtes pris en charge, consultez les [champs d'en-tête Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/header-fields.html) dans le manuel [Amazon Simple Email Service Developer Guide](https://docs.aws.amazon.com//ses/latest/dg/Welcome.html).
   + Pour **Nom**, entrez le nom de l’en-tête.
   + Dans **Valeur**, entrez la valeur de l'en-tête.

   (Facultatif) Pour ajouter un lien de désabonnement en un clic à un e-mail promotionnel, ajoutez les deux en-têtes suivants :

   1. Créez un en-tête avec `List-Unsubscribe` for **Name et attribuez** une **valeur** à votre lien de désinscription. Ce lien doit prendre en charge les demandes HTTP POST pour permettre le traitement de la demande de désinscription du destinataire.

   1. Créez un en-tête avec `List-Unsubscribe-Post` for **Name** et définissez **Value** sur`List-Unsubscribe=One-Click`.

1. (Facultatif) Sous **Plain text version (Version texte brut)**, entrez le contenu que vous souhaitez afficher dans le corps des messages qui utilisent le modèle et qui sont envoyés aux destinataires dont les applications de messagerie n'affichent pas le contenu HTML.

1. Si vous avez ajouté du contenu personnalisé au modèle en utilisant des variables de message, spécifiez une valeur par défaut pour chaque variable. Si vous procédez ainsi, Amazon Pinpoint remplace la variable par la valeur que vous spécifiez s’il n’existe aucune valeur pour un destinataire. Nous vous recommandons de procéder ainsi pour chaque variable du modèle.

   Pour spécifier des valeurs par défaut pour des variables, développez la section **Default attribute values (Valeurs d’attribut par défaut)**. Puis, saisissez la valeur par défaut que vous souhaitez utiliser pour chaque variable. Si vous ne spécifiez pas de valeur par défaut et qu’il n’existe pas de valeur pour un destinataire, Amazon Pinpoint n’envoie pas le message.

1. Lorsque vous avez terminé de saisir le contenu et les paramètres du modèle, choisissez **Create (Créer)**.

Pour tester le modèle avant de l'utiliser dans un message électronique que vous envoyez aux utilisateurs, vous pouvez [envoyer un message de test](messages-email.md) utilisant le modèle. Dans ce cas, assurez-vous d'avoir d'abord effectué l'étape 9 pour spécifier les valeurs par défaut pour toutes les variables du modèle. Dans le cas contraire, il se peut que le message ne soit pas envoyé ou qu'il ne s'affiche pas correctement.

## Inclure des liens de désabonnement dans les modèles de messages
<a name="message-templates-creating-email-optout"></a>

L’inclusion d’un lien de désabonnement dans votre e-mail est une bonne pratique, et dans certains pays, c’est une obligation légale. Dans vos liens de désabonnement, vous pouvez inclure un attribut spécial`ses:tags="unsubscribeLinkTag:value"`, où se *value* trouve toute valeur que vous définissez. Si un destinataire clique sur un lien contenant cet attribut spécial, Amazon Pinpoint le considère comme un événement de désabonnement à des fins d’analyse (par exemple, dans l’indicateur du taux de désabonnement sur la [page de présentation des analyses](analytics-overview.md)). L’exemple suivant présenter la syntaxe de ce type de lien :

```
<a ses:tags="unsubscribeLinkTag:optout" href="https://www.example.com/preferences">Unsubscribe</a>
```

Si votre modèle inclut un lien avec cet attribut, vous devez tout de même développer un système pour gérer les demandes de désinscription. Pour un exemple de système qui traite les demandes de désinscription, consultez la [solution Amazon Pinpoint Preference Center](https://aws.amazon.com/solutions/implementations/amazon-pinpoint-preference-center/) dans la bibliothèque de AWS solutions.

**Note**  
La solution Amazon Pinpoint Preference Center fait désormais office de guide. La solution ne peut plus être déployée mais le schéma architectural et le code ont été laissés comme référence.

# Création de modèles intégrés à l’application
<a name="message-templates-creating-inapp"></a>

Un *modèle intégré à l’application* est un modèle pour les messages que vous envoyez depuis Amazon Pinpoint aux utilisateurs de votre application. Utilisez des modèles intégrés à l’application pour créer, enregistrer et réutiliser les paramètres et le contenu de vos messages intégrés à l’application.

Lorsque vous créez un modèle intégré, vous spécifiez les paramètres et le contenu que vous souhaitez réutiliser dans le corps des messages intégrés qui utilisent le modèle. Lorsque vous créez un message à l’aide du modèle, Amazon Pinpoint le remplit avec les paramètres et le contenu que vous avez définis.

Les messages intégrés à l’application sont hautement personnalisables. Ils peuvent inclure des boutons qui ouvrent des sites Web ou redirigent les utilisateurs vers des parties spécifiques de votre application. Vous pouvez configurer les couleurs d’arrière-plan et de texte, positionner le texte et ajouter des images à la notification. Vous pouvez envoyer un seul message ou créer un *carrousel* contenant jusqu’à cinq messages uniques que vos utilisateurs peuvent faire défiler.

**Pour créer un modèle intégré**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sélectionnez **Create template (Créer un modèle)**.

1. Sous **Canal**, choisissez **Messagerie intégrée à l’application**.

1. Sous **Template details (Détails du modèle)**, pour **Template name (Nom du modèle)**, entrez un nom pour le modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (\$1) ou des traits d’union (‐).

1. (Facultatif) Pour **Version description (Description de la version)**, saisissez une brève description du modèle. La description peut contenir jusqu'à 500 caractères.

1. Dans la section **Détails du message intégré à l’application**, sous **Mise en page**, choisissez le type de mise en page du modèle de message. Choisissez parmi les options suivantes :
   + **Bannière en haut** : un message qui s’affiche sous la forme d’une bannière en haut de la page.
   + **Bannière en bas** : un message qui s’affiche sous la forme d’une bannière en bas de la page.
   + **Bannière au milieu** : un message qui s’affiche sous forme de notification au milieu de la page.
   + **Plein écran** : message qui couvre la totalité de l'écran.
   + **Modal** : un message qui s’affiche dans une fenêtre en face de la page.
   + **Carrousel** : une mise en page déroulante contenant jusqu’à cinq messages uniques.

1. Sous **En-tête**, configurez le titre qui apparaît au début du message. Si vous avez créé un message de carrousel, vous devez créer le premier message pour le carrousel, qui inclut l’en-tête.

   1. Pour que le **Texte d’en-tête** s’affiche dans la bannière. Vous pouvez entrer jusqu’à 64 caractères.

   1. Pour **Couleur du texte de l’en-tête**, choisissez la couleur du texte de l’en-tête. Vous pouvez éventuellement saisir des valeurs RGB ou un code couleur hexadécimal.

   1. Pour **Alignement de l’en-tête**, choisissez si vous souhaitez que le texte soit justifié à **Gauche**, au **Centre** ou à **Droite**.

1. Sous **Message**, configurez le corps du message.

   1. Pour **Message**, saisissez le corps du texte du message. Le nom peut contenir jusqu’à 150 caractères.

   1. Pour **Couleur du texte**, choisissez la couleur du texte du corps du message. Vous pouvez éventuellement saisir des valeurs RGB ou un code couleur hexadécimal.

   1. Pour **Alignement du texte**, choisissez si vous souhaitez que le texte soit justifié à **Gauche**, au **Centre** ou à **Droite**.

1. (Facultatif) Modifiez la couleur d’arrière-plan du message. Sous **Arrière-plan**, choisissez une couleur d’arrière-plan pour le message. Vous pouvez éventuellement saisir des valeurs RGB ou un code couleur hexadécimal.

1. (Facultatif) Ajoutez une image au message. Sous **URL de l’image**, entrez l’URL de l’image que vous souhaitez voir apparaître dans le message. Seuls les fichiers .jpg et .png sont acceptés. Les dimensions de l’image dépendent du type de message :
   + Pour une **Bannière**, l’image doit mesurer 100 pixels sur 100 pixels, soit au format 1:1.
   + Pour un **Carrousel**, l’image doit mesurer 300 pixels sur 200 pixels, soit au format 3:2.
   + Pour un message en **Plein écran**, l’image doit mesurer 300 pixels sur 200 pixels, soit au format 3:2.

1. (Facultatif) Ajoutez un bouton au message. Sous **Bouton principal**, procédez comme suit :

   1. Choisissez **Ajouter un bouton principal**.

   1. Pour **Texte du bouton**, entrez le texte à afficher sur le bouton. Vous pouvez entrer jusqu’à 64 caractères.

   1. (Facultatif) Pour **Couleur du texte du bouton**, choisissez une couleur pour le texte du bouton. Vous pouvez éventuellement saisir des valeurs RGB ou un code couleur hexadécimal.

   1. (Facultatif) Pour **Couleur d’arrière-plan**, choisissez une couleur d’arrière-plan pour le bouton. Vous pouvez éventuellement saisir des valeurs RGB ou un code couleur hexadécimal.

   1. (Facultatif) Pour **Rayon de bordure**, entrez une valeur de rayon. Des valeurs faibles se traduisent par des angles plus nets, tandis que des valeurs élevées entraînent des coins plus arrondis. 

   1. Sous **Actions**, choisissez l’événement qui se produit lorsque l’utilisateur appuie sur le bouton :
      + **Fermer** : ignore le message.
      + **Accéder à l’URL** : ouvre un site Web.
      + **Accéder au lien profond** : ouvre une application ou ouvre un endroit précis dans une application. 

      Si vous souhaitez que le comportement des boutons soit différent selon les types d’appareils, vous pouvez annuler l’action par défaut. Sous **Action**, utilisez les onglets pour choisir le type d’appareil dont vous souhaitez modifier le comportement des boutons. Par exemple, choisissez **iOS** pour modifier le comportement des boutons sur les appareils iOS. Ensuite, choisissez **Remplacer les actions par défaut**. Enfin, spécifiez une action.

1. (Facultatif) Ajoutez un bouton secondaire au message. Sous **Bouton secondaire**, choisissez **Ajouter un bouton secondaire**. Suivez les procédures de l’étape précédente pour configurer le bouton secondaire.

1. (Facultatif) Ajoutez des données personnalisées au message. Les données personnalisées sont des paires clé-valeur livrées avec votre message. Par exemple, il se peut que vous souhaitiez transmettre un code promotionnel à votre message. Si vous envoyez un message sous forme de carrousel, vous pouvez ajouter des données personnalisées à chacun des messages de carrousel. Pour ajouter des données personnalisées, procédez comme suit :

   1. Sous **Données personnalisées**, choisissez **Ajouter un nouvel élément**.

   1. Saisissez une **Clé**. Par exemple, *PromoCode*. 

   1. Saisissez une **Valeur** pour la clé. *PromoCode*Peut-être que vous l'êtes*12345*.

   1. Lorsque le message est envoyé, le code *12345* est inclus dans votre message.

   1. Pour ajouter d’autres paires clé-valeur, choisissez **Ajouter un nouvel élément**. Vous pouvez ajouter jusqu’à dix paires clé-valeur au message. Une fois que vous avez fini d’ajouter des données personnalisées, passez à l’étape suivante.

1. Si votre message est un carrousel, vous pouvez ajouter jusqu’à quatre autres messages uniques. Pour ajouter des messages à un carrousel, développez la section de **Aperçu du carrousel**. Ensuite, choisissez **Ajouter un nouveau message**. Répétez les étapes précédentes pour configurer le message.

   Lorsque vous ajoutez des messages au carrousel, la page d'**aperçu** est mise à jour en affichant des icônes en bas de page indiquant le nombre de messages inclus dans le carrousel.

   L'image suivante montre un carrousel avec deux messages :  
![\[\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/userguide/images/channels-inapp-carousel.png)

1. Lorsque vous avez terminé, choisissez **Create (Créer)**.

# Création de modèles de notification push
<a name="message-templates-creating-push"></a>

Un *modèle de notification push* est un modèle de message qui contient du contenu et des paramètres que vous pouvez utiliser avec vos projets Amazon Pinpoint. Lorsque vous utilisez un modèle pour envoyer une notification push, Amazon Pinpoint remplit la notification avec le contenu et les paramètres que vous avez définis dans le modèle.

Lorsque vous créez un modèle de notification push, vous spécifiez le contenu et les paramètres que vous souhaitez réutiliser dans divers composants des notifications push basés sur le modèle. Ces composants, appelés *parties de modèle*, peuvent contenir du texte (tel que le titre ou le corps d'une notification) ou des paramètres (tels qu'un son personnalisé à lire lorsqu'un destinataire reçoit une notification).

Pour personnaliser un modèle pour des canaux de notification push spécifiques, vous pouvez créer plusieurs ensembles de parties de modèle dans chaque modèle : un ensemble par défaut et, éventuellement, un ou plusieurs ensembles spécifiques à un service. Le jeu par défaut contient le contenu et les paramètres que vous souhaitez utiliser par défaut pour n'importe quel canal de notification push. Un ensemble spécifique à un service contient le contenu et les paramètres que vous souhaitez utiliser pour un service de notification spécifique, tel que le service Apple Push Notification ou Firebase Cloud Messaging. En ajoutant des paramètres spécifiques à un service à un modèle, vous pouvez personnaliser vos notifications afin d’afficher un contenu propre au type d’appareil de chaque destinataire.

Vous pouvez également [créer des modèles contenant des données de message brutes](#message-templates-creating-push-raw). Cette option est plus avancée, mais elle est utile si vous souhaitez définir des paramètres pour un canal spécifique qui ne figurent pas dans le modèle de notification push Amazon Pinpoint standard.

## Création d’un modèle standard de notification push
<a name="message-templates-creating-push-standard"></a>

Suivez cette procédure pour spécifier le contenu de base du message, tel que le titre, le corps du message, l'image et l'action. Pour spécifier le contenu brut du message, complétez [Création d’un modèle de notification push avec des données de message brutes](#message-templates-creating-push-raw) plutôt la procédure dans.

**Pour créer un modèle de notification push**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sélectionnez **Create template (Créer un modèle)**.

1. Sous **Channel (Canal)**, choisissez **Push notifications (Notifications push)**.

1. Sous **Template details (Détails du modèle)**, pour **Template name (Nom du modèle)**, entrez un nom pour le modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (\$1) ou des traits d’union (‐).

1. (Facultatif) Pour **Version description (Description de la version)**, saisissez une brève description du modèle. La description peut contenir jusqu'à 500 caractères.

1. Sous **Détails de notification push**, procédez comme suit :
   + Pour **Type de notification**, choisissez **Message standard**.
   + Pour **Titre**, saisissez le titre que vous souhaitez afficher au-dessus du corps du message.
   + Pour **Body (Corps)**, entrez le texte que vous souhaitez afficher dans le corps du message de notification.
**Astuce**  
Vous pouvez inclure du contenu personnalisé dans le titre et le corps du modèle. Pour cela, ajoutez des variables de message qui font référence à des attributs spécifiques, tel qu’un attribut qui stocke le prénom d’un utilisateur, par exemple. En utilisant des variables de message, vous pouvez afficher différents contenus pour chaque destinataire d'une notification push qui utilise le modèle.   
Pour utiliser une variable de message, choisissez le nom d’un attribut existant dans l’outil de **Recherche d’attributs**. Amazon Pinpoint crée une variable de message pour l’attribut et la copie dans votre presse-papiers. Collez la variable à l'emplacement souhaité. Pour de plus amples informations, veuillez consulter [Ajout de contenu personnalisé aux modèles de messages](message-templates-personalizing.md).
   + Pour le **Custom alert sound (Son d'alerte personnalisé)**, entrez le nom du fichier audio contenant le son personnalisé que vous souhaitez lire lorsqu'un destinataire reçoit la notification push. Ce nom doit correspondre au nom d'un fichier audio sur l'appareil du destinataire.
   + Pour **Action**, choisissez ce que vous voulez que le périphérique d'un destinataire fasse si le destinataire appuie sur la notification push :
     + **Ouvrir votre application** : ouvrez votre application ou mettez-la au premier plan si elle a été envoyée en arrière-plan.
     + **Accéder à une URL** : ouvrez le navigateur par défaut sur l’appareil du destinataire et chargez une page Web spécifique. Si vous choisissez cette option, saisissez l'URL de la page web dans la zone **Destination URL (URL de destination)**.
     + **Ouvrir un lien profond** : ouvrez votre application et affichez une interface utilisateur spécifique dans l’application. Si vous choisissez cette option, entrez l'URL de l'interface dans la zone **Destination URL (URL de destination)**.

1. (Facultatif) Pour personnaliser le modèle pour des services de notification push spécifiques, choisissez l’onglet de service approprié sous **Personnaliser le contenu pour les services push individuels)**. Choisissez ensuite les options que vous souhaitez pour ce service.

   Si vous cochez la case **Remplacer le contenu push par défaut** dans l’onglet d’un service, Amazon Pinpoint remplace automatiquement le contenu et les paramètres par défaut que vous avez choisis à l’étape précédente par les options que vous avez sélectionnées dans l’onglet. Si vous souhaitez conserver le contenu et les paramètres par défaut et simplement personnaliser le modèle pour utiliser des paramètres supplémentaires spécifiques à la chaîne, ne cochez pas cette case.  
**Apple**  
Utilisez ces options pour définir le contenu et les paramètres personnalisés des notifications push que vous envoyez via le canal du service de notifications push d'Apple (APNs) aux applications exécutées sur des appareils iOS.  
En plus du contenu et des paramètres standard, vous pouvez inclure une image ou une vidéo personnalisée dans les notifications push qui utilisent le modèle. Pour ce faire, entrez l'URL du fichier image ou vidéo dans la zone **iOS media (média iOS)**. L'URL doit être accessible au public. Sinon, l'appareil du destinataire ne pourra pas afficher l'image ou la vidéo.   
**Google**  
Utilisez ces options pour spécifier le contenu personnalisé et les paramètres des notifications push que vous envoyez via le canal Google Firebase Cloud Messaging (FCM) aux applications exécutées sur des appareils Android.  
Outre le contenu et les paramètres standard, vous pouvez choisir les options suivantes pour afficher des images personnalisées dans les notifications push qui utilisent le modèle :  
   + **Image Android** : entrez l’URL de l’image à afficher dans le corps de la notification push.
   + **Icône Android** : entrez l’URL de l’image de grande icône à afficher dans la vue de contenu de la notification push.
   + **Petite icône Android** : saisissez l’URL de l’image de petite icône à afficher dans la barre d’état et la vue de contenu de la notification push.  
**Amazon**  
Utilisez ces options pour spécifier du contenu et des paramètres personnalisés pour les notifications push que vous envoyez via le canal Amazon Device Messaging (ADM) aux applications exécutées sur des appareils Amazon, telles que les tablettes Kindle Fire.  
Outre le contenu et les paramètres standard, vous pouvez choisir les options suivantes pour afficher des images personnalisées dans les notifications push qui utilisent le modèle :  
   + **Image Android** : entrez l’URL de l’image à afficher dans le corps de la notification push.
   + **Icône Android** : entrez l’URL de l’image de grande icône à afficher dans la vue de contenu de la notification push.
   + **Petite icône Android** : saisissez l’URL de l’image de petite icône à afficher dans la barre d’état et la vue de contenu de la notification push.  
**Baidu**  
Utilisez ces options pour spécifier du contenu et des paramètres personnalisés pour les notifications push que vous envoyez via le canal Baidu aux applications qui utilisent la plateforme Baidu Cloud Push.  
Outre le contenu et les paramètres standard, vous pouvez choisir les options suivantes pour afficher des images personnalisées dans les notifications push qui utilisent le modèle :  
   + **Image Android** : entrez l’URL de l’image à afficher dans le corps de la notification push.
   + **Icône Android** : entrez l’URL de l’image de grande icône à afficher dans la vue de contenu de la notification push.
   + **Petite icône Android** : saisissez l’URL de l’image de petite icône à afficher dans la barre d’état et la vue de contenu de la notification push.

1. Si vous avez ajouté du contenu personnalisé au modèle en utilisant des variables de message, spécifiez une valeur par défaut pour chaque variable. Si vous procédez ainsi, Amazon Pinpoint remplace la variable par la valeur que vous spécifiez s’il n’existe aucune valeur pour un destinataire. Nous vous recommandons de procéder ainsi pour chaque variable du modèle.

   Pour spécifier des valeurs par défaut pour des variables, développez la section **Default attribute values (Valeurs d’attribut par défaut)**. Puis, saisissez la valeur par défaut que vous souhaitez utiliser pour chaque variable. Si vous ne spécifiez pas de valeur par défaut et qu’il n’existe pas de valeur pour un destinataire, Amazon Pinpoint n’envoie pas le message.

1. Lorsque vous avez terminé de saisir le contenu et les paramètres du modèle, choisissez **Create (Créer)**.

## Création d’un modèle de notification push avec des données de message brutes
<a name="message-templates-creating-push-raw"></a>

Effectuez cette procédure pour spécifier manuellement la charge utile brute des messages. Vous devez uniquement spécifier la charge utile brute des messages si vous souhaitez utiliser une fonctionnalité d’un service de notification push spécifique qu’Amazon Pinpoint ne vous autorise pas à configurer. Si vous n’avez pas besoin de spécifier le contenu brut du message, suivez plutôt la procédure détaillée dans [Création d’un modèle standard de notification push](#message-templates-creating-push-standard).

Par exemple, vous devez utiliser un modèle de message brut lorsque vous souhaitez envoyer des messages aux utilisateurs du navigateur Web Safari pour ordinateur de bureau. Dans ce cas, vous devez inclure un attribut spécifique dans la charge utile du message brut. Pour plus d'informations, consultez la section [Envoi d'un message](https://docs.aws.amazon.com/push-notifications/latest/userguide/reference-send-message.html) dans le *Guide de l'utilisateur AWS final pour la messagerie push*.

**Pour créer un modèle de notification push**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sélectionnez **Create template (Créer un modèle)**.

1. Sous **Channel (Canal)**, choisissez **Push notifications (Notifications push)**.

1. Sous **Template details (Détails du modèle)**, pour **Template name (Nom du modèle)**, entrez un nom pour le modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (\$1) ou des traits d’union (‐).

1. (Facultatif) Pour **Version description (Description de la version)**, saisissez une brève description du modèle. La description peut contenir jusqu'à 500 caractères.

1. Sous **Détails des notifications push**, pour **Type de notification**, sélectionnez **Message brut**. L’éditeur de message affiche un aperçu du code à utiliser pour le modèle. Dans l’éditeur de message, entrez les paramètres que vous souhaitez utiliser pour chaque service de notification push, y compris les paramètres facultatifs (tels que les images, les sons et les actions) que vous souhaitez spécifier pour le modèle. Pour plus d’informations, consultez la documentation relative aux services de notification push que vous utilisez.

1. Lorsque vous avez fini de saisir le contenu du message brut, choisissez **Créer**.

Pour tester le modèle avant de l'utiliser dans une notification push que vous envoyez aux utilisateurs, vous pouvez [envoyer une notification de test](messages-mobile.md) utilisant le modèle. Dans ce cas, assurez-vous d'avoir d'abord effectué l'étape 10 pour spécifier les valeurs par défaut de toutes les variables du modèle. Dans le cas contraire, il se peut que la notification push ne soit pas envoyée ou qu’elle ne s'affiche pas correctement.

# Création de modèles de SMS
<a name="message-templates-creating-sms"></a>

Un *modèle de SMS* est un type de modèle de message qui contient le contenu et les paramètres que vous souhaitez créer, enregistrer et réutiliser dans les messages SMS que vous envoyez pour l’un de vos projets Amazon Pinpoint. Vous pouvez utiliser un modèle de SMS dans les messages texte que vous envoyez à partir de campagnes ou à un public limité en tant que messages directs ou de test.

Lorsque vous créez un modèle SMS, vous spécifiez les paramètres et le contenu que vous souhaitez réutiliser dans le corps des messages texte basés sur le modèle. Lorsque vous créez un message basé sur le modèle, Amazon Pinpoint remplit le message avec les paramètres et le contenu que vous avez définis dans ce modèle.

**Pour créer un modèle SMS**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sélectionnez **Create template (Créer un modèle)**.

1. Sous **Channel (Canal)**, choisissez **SMS**.

1. Sous **Template details (Détails du modèle)**, pour **Template name (Nom du modèle)**, entrez un nom pour le modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (\$1) ou des traits d’union (‐).

1. (Facultatif) Pour **Version description (Description de la version)**, saisissez une brève description du modèle. La description peut contenir jusqu'à 500 caractères.

1. Sous **SMS Details (Détails SMS)**, pour **Message**, entrez le contenu que vous souhaitez afficher dans le corps des messages qui utilisent le modèle. Le corps du message peut contenir jusqu'à 1 600 caractères.
**Astuce**  
Vous pouvez inclure du contenu personnalisé dans le corps du modèle. Pour cela, ajoutez des variables de message qui font référence à des attributs spécifiques qu’Amazon Pinpoint ou vous-même avez créés (attribut qui stocke le prénom d’un utilisateur, par exemple). En utilisant des variables de message, vous pouvez afficher différents contenus pour chaque destinataire d'un message qui utilise le modèle.  
Pour utiliser une variable de message, choisissez le nom d’un attribut existant dans l’outil de **Recherche d’attributs**. Amazon Pinpoint crée une variable de message pour l’attribut et la copie dans votre presse-papiers. Collez la variable à l'emplacement souhaité. Pour de plus amples informations, veuillez consulter [Ajout de contenu personnalisé aux modèles de messages](message-templates-personalizing.md).

1. Si vous avez ajouté du contenu personnalisé au modèle en utilisant des variables de message, spécifiez une valeur par défaut pour chaque variable. Si vous procédez ainsi, Amazon Pinpoint remplace la variable par la valeur que vous spécifiez s’il n’existe aucune valeur pour un destinataire. Nous vous recommandons de procéder ainsi pour chaque variable du modèle.

   Pour spécifier des valeurs par défaut pour des variables, développez la section **Default attribute values (Valeurs d’attribut par défaut)**. Puis, saisissez la valeur par défaut que vous souhaitez utiliser pour chaque variable. Si vous ne spécifiez pas de valeur par défaut et qu’il n’existe pas de valeur pour un destinataire, Amazon Pinpoint n’envoie pas le message.

1. Lorsque vous avez terminé de saisir le contenu et les paramètres du modèle, choisissez **Create (Créer)**.

Pour tester le modèle avant de l'utiliser dans un message que vous envoyez aux utilisateurs, vous pouvez [envoyer un message de test](messages-sms.md) utilisant le modèle. Dans ce cas, assurez-vous d'avoir d'abord effectué l'étape 8 pour spécifier les valeurs par défaut pour toutes les variables du modèle. Dans le cas contraire, il se peut que le message ne soit pas envoyé ou qu'il ne s'affiche pas correctement.

# Création de modèles vocaux
<a name="message-templates-creating-voice"></a>

Un *modèle vocal* est un type de modèle de message qui contient le contenu et les paramètres que vous souhaitez créer, enregistrer et réutiliser dans les messages vocaux que vous envoyez pour l’un de vos projets Amazon Pinpoint. Vous pouvez utiliser un modèle vocal dans les messages vocaux que vous envoyez en tant que messages directs ou de test.

Lorsque vous créez un modèle vocal, vous spécifiez le contenu et les paramètres que vous souhaitez réutiliser dans les divers composants des messages vocaux qui sont basés sur le modèle. Ces composants sont appelés des *parties de modèle*. Elles peuvent contenir le texte du script ou les paramètres du message, par exemple, la voix à utiliser lors de la remise du message. Le script de message peut inclure du texte statique et, éventuellement, du contenu personnalisé que vous définissez.

Lorsque vous créez un message vocal basé sur un modèle, Amazon Pinpoint remplit le message avec le contenu et les paramètres que vous avez définis dans le modèle.

**Pour créer un modèle vocal**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sélectionnez **Create template (Créer un modèle)**.

1. Sous **Channel (Canal)**, choisissez **Voice (Voix)**.

1. Sous **Template details (Détails du modèle)**, pour **Template name (Nom du modèle)**, entrez un nom pour le modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (\$1) ou des traits d’union (‐).

1. (Facultatif) Pour **Version description (Description de la version)**, saisissez une brève description du modèle. La description peut contenir jusqu'à 500 caractères.

1. Sous **Voice message details (Détails du message vocal)**, pour **Message**, saisissez le texte que vous souhaitez utiliser comme script de message pour les messages qui utilisent le modèle. Le script peut contenir jusqu'à 10 000 caractères et doit être au format texte brut.
**Astuce**  
Vous pouvez inclure du contenu personnalisé dans le script du message. Pour cela, ajoutez des variables de message qui font référence à des attributs spécifiques qu’Amazon Pinpoint ou vous-même avez créés (attribut qui stocke le prénom d’un utilisateur, par exemple). En utilisant des variables de message, vous pouvez lire différents contenus pour chaque destinataire d'un message qui utilise le modèle.   
Pour utiliser une variable de message, choisissez le nom d’un attribut existant dans l’outil de **Recherche d’attributs**. Amazon Pinpoint crée une variable de message pour l’attribut et la copie dans votre presse-papiers. Collez la variable à l'emplacement souhaité. Pour de plus amples informations, veuillez consulter [Ajout de contenu personnalisé aux modèles de messages](message-templates-personalizing.md).

1. Dans **Langue et région**, choisissez la langue dans laquelle le texte du script du message est écrit. Amazon Pinpoint utilise ce paramètre pour déterminer les phonèmes et autres paramètres spécifiques à la langue à utiliser lors de la conversion du texte du script en parole.

1. Pour **Voice (Voix)**, choisissez la voix que vous souhaitez utiliser pour lire le message aux destinataires. Chaque voix est créée à l'aide de locuteurs natifs et, par conséquent, il y a des variations d'une voix à une autre, même au sein de la même langue. Il est donc conseillé de tester chaque voix avec votre script.

   La liste des voix change en fonction de la langue que vous choisissez à l'étape 8. Dans la plupart des cas, la liste comprend au moins une voix masculine et une voix féminine. Dans certains cas, une seule voix est disponible. Nous ajoutons continuellement des langues supplémentaires et créons des voix pour les langues prises en charge.

1. Choisissez **Play message (Lire le message)** pour tester le son lorsqu'il est délivré aux destinataires. Ajustez le contenu et les paramètres jusqu'à obtenir le modèle souhaité.

1. Si vous avez ajouté du contenu personnalisé au modèle en utilisant des variables de message, spécifiez une valeur par défaut pour chaque variable. Si vous procédez ainsi, Amazon Pinpoint remplace la variable par la valeur que vous spécifiez s’il n’existe aucune valeur pour un destinataire. Nous vous recommandons de procéder ainsi pour chaque variable du modèle.

   Pour spécifier des valeurs par défaut pour des variables, développez la section **Default attribute values (Valeurs d’attribut par défaut)**. Puis, saisissez la valeur par défaut que vous souhaitez utiliser pour chaque variable. Si vous ne spécifiez pas de valeur par défaut et qu’il n’existe pas de valeur pour un destinataire, Amazon Pinpoint n’envoie pas le message.

1. Lorsque vous avez terminé de saisir le contenu et les paramètres du modèle, choisissez **Create (Créer)**.

# Ajout de contenu personnalisé aux modèles de messages
<a name="message-templates-personalizing"></a>

Pour diffuser du contenu dynamique et personnalisé dans des messages qui utilisent un modèle, ajoutez des *variables de message* au modèle de message. Une *variable de message* est un espace réservé qui fait référence à un attribut spécifique que vous ou Amazon Pinpoint avez créé pour stocker des informations sur vos utilisateurs. Chaque attribut correspond généralement à une caractéristique d'un utilisateur, comme le prénom d'un utilisateur ou la ville où il habite. En ajoutant des variables de messages aux modèles, vous pouvez utiliser ces attributs pour fournir du contenu personnalisé à chaque destinataire d'un message qui utilise un modèle.

Si un modèle contient des variables de messages, Amazon Pinpoint remplace chaque variable par la valeur actuelle correspondante de l’attribut pour chaque destinataire. Il le fait lors de chaque envoi d’un message qui utilise le modèle. Cela signifie que vous pouvez envoyer du contenu personnalisé à chaque destinataire sans créer plusieurs versions personnalisées d'un message ou d’un modèle de message. Vous pouvez également être sûr que le message contient les dernières informations dont vous disposez pour un destinataire.

Par exemple, si votre projet est une application de fitness pour les coureurs et qu'il comprend des attributs pour le prénom de chaque utilisateur, son activité préférée et son enregistrement personnel, vous pouvez utiliser les variables de texte et de messages suivantes dans un modèle :

`Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!`

Lorsque vous envoyez un message qui utilise le modèle, Amazon Pinpoint remplace les variables par la valeur actuelle de chaque attribut pour chaque destinataire. Voici quelques exemples :

**Exemple 1**  
`Hi Sofia, congratulations on your new half marathon record of 1:42:17!`

**Exemple 2**  
`Hi Alejandro, congratulations on your new 5K record of 20:52!`

Si aucune valeur d’attribut n’existe pour un destinataire, Amazon Pinpoint peut remplacer une variable par une valeur par défaut que vous spécifiez pour cette dernière. Par exemple, si un utilisateur de votre application de fitness n'a pas choisi son activité préférée, vous pouvez utiliser `running` comme valeur par défaut pour la variable `{{User.UserAttributes.Activity}}`. Dans ce cas, Amazon Pinpoint remplace la variable comme illustré dans les exemples suivants.

**Exemple 1**  
`Hi Jane, congratulations on your new running record of 1:42:17!`

**Exemple 2**  
`Hi John, congratulations on your new running record of 20:52!`

Si vous ne spécifiez pas de valeur par défaut et qu’il n’existe aucune valeur pour un destinataire, Amazon Pinpoint omet tout le texte de la variable lorsqu’il envoie un message à ce destinataire. Par exemple :

`Hi Mary, congratulations on your new record of 20:52!`

Nous vous recommandons de spécifier une valeur par défaut pour chaque variable que vous incluez dans un modèle.

## Ajout de variables de messages
<a name="message-templates-add-variables"></a>

Vous pouvez ajouter des attributs de message à un nouveau modèle que vous créez ou à un modèle existant. Si vous ajoutez des variables à un modèle existant, Amazon Pinpoint n’applique pas nécessairement les modifications aux messages qui utilisent le modèle et qui n’ont pas encore été envoyés, par exemple, les messages de campagne qui doivent être envoyés ultérieurement. Cela dépend de la version du modèle à laquelle vous ajoutez des variables et de la façon dont vous avez configuré les messages qui utilisent le modèle. Pour de plus amples informations, veuillez consulter [Gestion des versions des modèles de message](message-templates-versioning.md).

**Note**  
Les modèles de messagerie intégrés à l'application ne prennent pas en charge l'utilisation de variables de message.

**Pour ajouter une variable de message à un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sur la page **Message templates (Modèles de message)** effectuez l'une des opérations suivantes : 
   + Pour créer un nouveau modèle et y ajouter une variable de message, choisissez **Create a template (Créer un modèle)**. Ensuite, sur la page du modèle, saisissez un nom pour ce dernier et, éventuellement, une description.
   + Pour ajouter une variable de message à un modèle existant, choisissez le modèle auquel vous souhaitez ajouter une variable. Ensuite, sur la page du modèle, choisissez **Edit (Modifier)**. Sous **Template details (Détails du modèle)**, utilisez le sélecteur de version pour choisir la version du modèle que vous souhaitez utiliser comme point de départ. Si vous choisissez la version la plus récente du modèle, vous pouvez enregistrer vos modifications directement dans cette version du modèle. Dans le cas contraire, vous pouvez enregistrer vos modifications en tant que nouvelle version du modèle.

1. Dans la section des détails du message, déterminez où vous souhaitez ajouter une variable de message. Vous pouvez ajouter une variable au corps de tout type de modèle. Pour les modèles de notification par e-mail et push, vous pouvez également ajouter une variable à l'objet ou au titre du message. 

1. Dans **Attribute finder (Recherche d'attributs)**, développez la section correspondant au type d'attribut pour lequel vous souhaitez ajouter une variable de message. Vous pouvez choisir parmi les types d'attributs suivants :  
**Attributs standard**  
Il s’agit d’attributs créés automatiquement par Amazon Pinpoint pour n’importe quel projet. Cela signifie que vous pouvez les utiliser dans les messages que vous envoyez pour n'importe quel projet. Pour de plus amples informations sur chacun de ces attributs, veuillez consulter [Attributs pris en charge](#message-templates-variables).  
Pour ajouter une variable pour un attribut standard, choisissez l'attribut dans la liste.  
**Custom attributes (Attributs personnalisés)**  
Il s'agit d'attributs que vous pouvez éventuellement créer pour des projets individuels. Étant donné que ces attributs ne sont peut-être pas disponibles pour certains de vos projets, Amazon Pinpoint ne sera peut-être pas en mesure de remplacer la variable par une valeur pour chaque destinataire d'un message utilisant le modèle. Pour vous aider à éviter ce problème, Amazon Pinpoint fournit des options pour vous aider à choisir un attribut existant pour des projets spécifiques ou tous vos projets.  
Pour ajouter un attribut personnalisé :  

   1. Choisissez **Attributs personnalisés**, puis sélectionnez **Charger des attributs personnalisés**. Dans la fenêtre qui apparaît, Amazon Pinpoint répertorie tous les projets que vous avez créés. Lorsque vous choisissez chaque projet, les attributs communs aux projets sélectionnés s’affichent dans le volet de navigation de droite. Si aucun attribut n’est affiché, cela signifie qu’il n’existe aucun attribut commun entre ces projets. 

   1. Effectuez l’une des actions suivantes :
      + Pour utiliser tous les attributs communs aux projets sélectionnés, choisissez **Charger des attributs personnalisés**.
      + Pour utiliser un attribut spécifique de la liste, entrez n'importe quelle partie du nom de l'attribut dans le champ de recherche. Les attributs correspondant au texte saisi s’affichent. Choisissez **Charger des attributs personnalisés** lorsque l’attribut que vous souhaitez utiliser s’affiche. L’outil de **Recherche d’attributs** affiche les attributs personnalisés récemment ajoutés. 
**Note**  
Vous ne pouvez pas ajouter d'attributs communs provenant de différents ensembles de projets, ou vous pouvez modifier la section **Attributs personnalisés** de l'outil de recherche d'**attributs**. Pour modifier les attributs personnalisés, choisissez **X** pour effacer le moteur de **recherche d'attributs,** puis recommencez.

   1. Dans **Attribute finder (Recherche d'attributs)**, choisissez l'attribut pour lequel vous souhaitez ajouter une variable.  
**Recommended attributes (Attributs recommandés)**  
Il s’agit des attributs que vous créez éventuellement pour votre compte lorsque vous configurez Amazon Pinpoint pour récupérer des recommandations personnalisées à partir d’un modèle de recommandation. Pour de plus amples informations sur l'utilisation des modèles de recommandation, veuillez consulter [Modèles de machine learning](ml-models.md). Vous pouvez ajouter des variables pour ce type d'attribut aux modèles d'e-mail, de notification push et de SMS. Vous ne pouvez pas les ajouter à des modèles vocaux.  
Pour ajouter une variable pour un attribut recommandé, choisissez l'attribut dans la liste. Si l'outil de **recherche d'attributs ne répertorie aucun attribut** recommandé, vous devez d'abord connecter le modèle à un modèle de recommandation.   
Pour ajouter un attribut recommandé :  

   1. Choisissez ensuite **Connecter un modèle**. 

   1. Sélectionnez le modèle à partir duquel vous souhaitez récupérer les recommandations lorsque vous envoyez des messages qui utilisent le modèle. 

   1. Choisissez ensuite **Connecter un modèle**.


1. Lorsque vous choisissez un attribut dans **Recherche d’attributs**, Amazon Pinpoint crée une variable de message pour l’attribut et la copie dans votre presse-papiers. Collez la variable à l'emplacement souhaité. Si votre liste d’attributs est longue, entrez le texte de recherche pour affiner la liste. Choisissez **X** pour effacer le champ de recherche.

   Une fois que vous avez collé la variable, Amazon Pinpoint l’affiche sous forme de nom de l’attribut associé, entre deux ensembles d’accolades, par exemple, `{{User.UserAttributes.FirstName}}`.

1. Répétez les étapes 4 à 6 pour chaque variable de message que vous souhaitez ajouter.

1. Pour spécifier une valeur par défaut pour une variable de message, développez la section **Default attribute values (Valeurs d'attribut par défaut)**. Ensuite, dans la liste des variables, saisissez la valeur par défaut que vous souhaitez utiliser pour la variable.
**Note**  
Nous vous recommandons de procéder ainsi pour chaque variable du modèle. Sinon, Amazon Pinpoint peut ne pas être en mesure d’envoyer un message utilisant le modèle, ou le message peut s’afficher de manière inattendue ou indésirable.

1. Lorsque vous avez terminé, effectuez l'une des opérations suivantes :
   + Si vous avez ajouté des variables de message à un nouveau modèle, choisissez **Create (Créer)**.
   + Si vous avez ajouté des variables de message à un modèle existant et que vous souhaitez enregistrer vos modifications en tant que nouvelle version du modèle, choisissez **Enregistrer en tant que nouvelle version**.
   + Si vous avez ajouté des variables de message à un modèle existant et que vous souhaitez enregistrer vos modifications en tant que mise à jour de la version la plus récente du modèle, choisissez **Update version (Mettre à jour la version)**. Cette option n'est disponible que si vous avez ouvert la version la plus récente du modèle à l'étape 3.

## Attributs pris en charge
<a name="message-templates-variables"></a>

Chaque projet peut posséder des attributs standard et des attributs personnalisés. Les attributs standard sont des attributs qu’Amazon Pinpoint créé automatiquement pour tout projet. Les attributs personnalisés sont des attributs que vous créez de manière facultative pour un projet. Il existe trois types d'attributs personnalisés :
+ **Attributs utilisateur** : ces attributs décrivent un utilisateur, par exemple son prénom, son nom de famille et sa date de naissance. Un *utilisateur* est une personne qui possède un ID utilisateur unique pour un projet.
+ **Attributs du point de terminaison** : ces attributs décrivent un point de terminaison spécifique pour un utilisateur. Un *point de terminaison* est une destination à laquelle vous pouvez envoyer des messages, par exemple une adresse électronique, un numéro de téléphone ou un appareil mobile. Chaque utilisateur peut être associé à un ou plusieurs points de terminaison. Par exemple, si vous communiquez avec un utilisateur par e-mail, SMS ou téléphone, l’utilisateur peut être associé à trois points de terminaison : un pour son adresse e-mail, un autre pour son numéro de téléphone portable et un autre pour son numéro de téléphone personnel (fixe).
+ **Attributs de métrique** : ces attributs sont des métriques numériques que votre application envoie à Amazon Pinpoint pour des points de terminaison individuels, notamment le nombre de sessions pour une application mobile ou le nombre d’éléments restant dans un panier.
+ **Pincez les attributs : ces attributs sont des identifiants uniques pour votre application, votre campagne ou votre parcours**.

En plus des attributs personnalisés et standard créés par Amazon Pinpoint ou par vous-même pour vos projets, Amazon Pinpoint prend en charge les *attributs recommandés*. Un *attribut recommandé* est un attribut qui stocke temporairement des recommandations personnalisées pour les utilisateurs ou les points de terminaison. Amazon Pinpoint extrait ces recommandations à partir des modèles de recommandation que vous configurez pour utiliser. Les attributs recommandés ne sont pas associés à des projets spécifiques. Au lieu de cela, ils sont associés à votre compte Amazon Pinpoint. Pour de plus amples informations sur l'utilisation des modèles de recommandation, veuillez consulter [Modèles de machine learning](ml-models.md).

Vous pouvez utiliser n'importe quel attribut standard, personnalisé ou recommandé dans une variable de message. Le tableau suivant indique le texte qui s'affiche dans la variable de message pour chaque attribut pris en charge et décrit chaque attribut. Dans le tableau, *custom\$1attribute* indique le texte qui apparaît dans une variable pour un attribut personnalisé. Dans ce cas, remplacez *custom\$1attribute* par le nom de l'attribut personnalisé. Par exemple, si votre projet stocke les prénoms des utilisateurs dans un attribut utilisateur personnalisé nommé `FirstName` et que vous ajoutez une variable pour cet attribut, le texte de la variable est `{{User.UserAttributes.FirstName}}`.


| Attribut | Description | 
| --- | --- | 
| Address | Adresse de destination pour les messages ou les notifications push que vous envoyez au point de terminaison, par exemple, une adresse e-mail, un numéro de téléphone ou un jeton d’appareil. | 
| Pinpoint.ApplicationId | Identifiant unique de l'application. | 
| Attributes.custom\$1attribute | Attribut de point de terminaison personnalisé décrivant le point de terminaison. | 
| Pinpoint.CampaignId | Identifiant unique de la campagne. | 
| ChannelType | Canal à utiliser lors de l'envoi de messages ou de notifications push au point de terminaison. Par exemple :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/userguide/message-templates-personalizing.html) | 
| CreationDate | Date et heure auxquelles le point de terminaison a été ajouté au projet, au [format ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Par exemple, 2019-06-30T11:45:25.220Z pour 11:45 UTC le 30 juin 2019. | 
| Demographic.AppVersion | Numéro de version de l'application associée au point de terminaison. | 
| Demographic.Locale | Les paramètres régionaux du point de terminaison, au format suivant : code [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/ISO_639-1) suivi d'un trait de soulignement (\$1), suivi d'une valeur [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) . Par exemple, en\$1US est l’anglais pour les États-Unis. | 
| Demographic.Make | Fabricant du terminal de point de terminaison, comme apple ou samsung. | 
| Demographic.Model | Nom ou numéro du modèle du périphérique du point de terminaison, notamment iPhone ou SM-G900F. | 
| Demographic.ModelVersion | Version du modèle du terminal de point de terminaison. | 
| Demographic.Platform | Système d'exploitation du terminal de point de terminaison, notamment ios ou android. | 
| Demographic.PlatformVersion | Version du système d'exploitation sur le périphérique du point de terminaison. | 
| Demographic.Timezone | Fuseau horaire du point de terminaison, en tant que valeur de [base de données tz](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Par exemple, America/Los\$1Angeles pour Heure du Pacifique (Amérique du Nord). | 
| EffectiveDate | Heure et date de la dernière mise à jour du point de terminaison, au [format ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Par exemple, 2019-08-23T10:54:35.220Z pour 10:54 UTC le 23 août 2019. | 
| EndpointId | Identifiant unique du point de terminaison. | 
| EndpointStatus | S'il faut envoyer des messages ou des notifications push au terminal : ACTIVE envoyer des messages au terminal ou ne pas envoyer de messages au terminal. INACTIVE | 
| Id | Identifiant unique du point de terminaison. | 
| Pinpoint.JourneyId | L'identifiant unique du trajet. | 
| Location.City | Ville où se trouve le point de terminaison. | 
| Location.Country | Code à deux lettres du pays ou de la région dans lequel/laquelle se trouve le point de terminaison, au [format ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Par exemple, US pour les États-Unis. | 
| Location.Latitude | Latitude du point de terminaison, arrondie à une décimale. | 
| Location.Longitude | Longitude du point de terminaison, arrondie à une décimale. | 
| Location.PostalCode | Code postal ou ZIP de la zone où se trouve le point de terminaison. | 
| Location.Region | Nom de la région, notamment un État ou une province, où se trouve le point de terminaison. | 
| Metrics.custom\$1attribute | Métrique numérique personnalisée que votre application indique à Amazon Pinpoint pour le point de terminaison. | 
| OptOut | Si l'utilisateur a choisi de ne pas recevoir de messages et de notifications push de votre part : ALL s'il s'est désinscrit et ne souhaite pas recevoir de messages ou de notifications pushNONE, ou s'il ne s'est pas désinscrit et souhaite recevoir tous les messages et notifications push. | 
| RecommendationItems | Attribut recommandé standard qui stocke une recommandation pour le point de terminaison ou l'utilisateur. Cet attribut contient du texte fourni directement par un modèle de recommandation. | 
| RecommendationItems.[\$1] |  Attribut recommandé standard qui stocke une liste ordonnée de 2 à 5 recommandations pour le point de terminaison ou l’utilisateur. Cet attribut contient du texte fourni directement par un modèle de recommandation. L'espace réservé numérique (.[\$1]) indique que l'attribut contient plusieurs valeurs. Une variable de message pour cet attribut peut faire référence à une valeur spécifique dans la liste.  | 
| Recommendations.custom\$1attribute | Attribut recommandé personnalisé qui stocke une recommandation pour le point de terminaison ou l'utilisateur. Cet attribut contient du contenu fourni par un modèle de recommandation et amélioré par une AWS Lambda fonction. | 
| Recommendations.custom\$1attribute.[\$1] |  Attribut recommandé personnalisé qui stocke plusieurs recommandations pour le point de terminaison ou l'utilisateur. Cet attribut contient du contenu fourni par un modèle de recommandation et amélioré par une fonction AWS Lambda . L'espace réservé numérique (.[\$1]) indique que l'attribut contient plusieurs valeurs. Une variable de message pour cet attribut peut faire référence à l'une de ces valeurs spécifiquement.  | 
| RequestId | Identifiant unique de la dernière demande de mise à jour du point de terminaison. | 
| User.UserAttributes.custom\$1attribute | Attribut utilisateur personnalisé décrivant l'utilisateur. | 
| User.UserId | Un identifiant unique pour l'utilisateur. | 

# Utilisation des assistants de modèles de messages
<a name="message-template-helpers"></a>

Avec les modèles Amazon Pinpoint, les clients peuvent créer des modèles de messages réutilisables basés sur le langage Handlebars.js. Les assistants fournissent diverses fonctionnalités, telles que le formatage d’un prix dans la devise d’une région spécifique ou l’ajout d’un lieu basé sur un fuseau horaire. Un assistant peut utiliser une chaîne ou un nombre entier spécifique pour la valeur ou une variable de message Amazon Pinpoint spécifique.

Voici les catégories d’assistants, décrites dans les sections suivantes :

## Assistants par défaut
<a name="defaulthelpers"></a>

Cette section décrit les assistants **intégrés** fournis par Handlebars. Pour la liste complète, voir les [assistants intégrés](https://handlebarsjs.com/guide/builtin-helpers.html) sur [handlebarsjs.com](https://handlebarsjs.com). Voici les assistants intégrés :
+ `each` : itère une liste.
**Note**  
La taille maximale de la liste est de 15 éléments.
+ `if` : évalue une déclaration.

*each*  
Itère une liste. Cet assistant utilise uniquement une instruction de bloc. Si vous le souhaitez, vous pouvez :   
+ envoyer `@index` dans la demande pour référencer l’indice de boucle actuel.
+ utiliser l’assistant `this` pour référencer l’élément en cours d’itération.
+ renvoyer la réponse de l’assistant sous forme de liste, à l’aide de la balise `<li>`.
**Utilisation**  
`{{#each value}}`  
La valeur à la position `{{@index}}` est `{{this}}`.  
`{{else}}`  
La condition est false.  
`{{/each}}`  
`each` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/each}}` fermant dans l’instruction de bloc.  
**Exemple**  
Dans cet exemple, `each` est utilisé pour renvoyer une liste des couleurs préférées d’un utilisateur. Dans le cas d’une valeur `false`, une déclaration `else` est renvoyée. Si la demande est la suivante :  
`{{#each User.UserAttributes.FavoriteColors}}`  
`<li>{{this}}</li>`  
`{{else}}`  
*You have no favorite colors.*  
`{{/each}}` renvoie  
+ *red*
+ *blue*
+ *yellow*
pour une déclaration true.

*if*  
Évalue si quelque chose est « true » et renvoie une réponse basée sur l’évaluation.   
**Utilisation**  
`{{#if value}}`  
La valeur est indéfinie  
`{{else}}`  
La valeur est indéfinie  
`{{/if}}`  
`if` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/if}}` fermant dans l’instruction de bloc.  
**Exemple**  
Dans cet exemple, l’assistant `if` est utilisé pour évaluer le prénom d’un utilisateur. Si le nom est trouvé, un message d’accueil est renvoyé qui transmet le prénom de l’utilisateur dans la réponse. Dans le cas contraire, l’instruction `else` renvoie un autre message d’accueil.  
`{{#if User.UserAttributes.FirstName.[0]}}`  
`Hello {{User.UserAttributes.FirstName.[0]}},`  
`{{else}}`  
*Hello,*  
`{{/if}}`  
renvoie *Hello, Jane* si l'`if`assistant est vrai.

## Assistants conditionnels
<a name="conditionhelpers"></a>

Cette section décrit les assistants **conditionnels**. 

Les assistants conditionnels peuvent être utilisés sur une seule ligne ou dans une instruction de bloc. Vous pouvez personnaliser la réponse quelle que soit la méthode d’assistance que vous utilisez. Vous pouvez transmettre des aides conditionnelles supplémentaires dans les instructions sur une seule ligne et dans les instructions par blocs. Les assistants conditionnels suivants indiquent d’abord l’utilisation d’une seule ligne, puis d’une instruction de bloc à l’aide d’une clause `else` facultative. Voici les assistants conditionnelles :
+ `and` : compare si tous les éléments transmis sont égaux.
+ `eq` : teste si deux éléments sont égaux.
+ `gt` : teste si un élément est supérieur à un autre.
+ `gte` : teste si un élément est supérieur ou égal à un autre.
+ `if` : évalue si quelque chose est vrai.
+ `lt` : teste si un élément est inférieur à un autre.
+ `lte` : teste si un élément est inférieur ou égal à un autre.
+ `neq` : évalue si deux éléments ne sont pas égaux.
+ `not` : inverse la réponse d’une opération booléenne.
+ `or` : compare si l’un des éléments de l’argument est égal.

*and*  
Compare si *tous* les éléments transmis dans un argument sont égaux, puis renvoie la réponse en fonction du résultat. Cet assistant peut être utilisé pour les valeurs non booléennes. Vous devez transmettre au moins deux éléments pour la condition.  
**Utilisation**  
+ `{{and valuea valueb valuec valued yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#and valuea valueb}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/and}}`

  `and` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/and}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cet exemple, `eq` est utilisé dans l’instruction de bloc `and` pour déterminer si les deux chaînes transmises pour les attributs `Location.City ` et `Location.Country` sont vraies. Si les deux conditions sont égales, une déclaration true est renvoyée. Si l’un de ces attributs est faux, une déclaration `else` est renvoyée.  
`{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}`  
*You live in Los Angeles and the US.*  
`{{else}}`  
*You don’t live in Los Angeles and the US.*  
`{{/and}}`

*eq*  
Teste si deux éléments sont égaux ou si la valeur d’un élément est égale à une chaîne passée.  
**Utilisation**  
+ `{{eq valuea valueb yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#eq valuea valueb}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/eq}}`

  `eq` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/eq}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cet exemple, `eq` est utilisé pour évaluer si la valeur de `User.UserAttributes.FavoriteColors.[0]` est*Red*. Si la réponse est `true`, une déclaration true est renvoyée. Si la réponse est `false`, une déclaration `else` est renvoyée.  
`{{#eq User.UserAttributes.FavoriteColors.[0] "red"}}`  
*Your favorite color is red.*  
`{{else}}`  
*You don't like red.*  
`{{/eq}}`

*gt*  
Teste si la valeur d’un élément est supérieure à celle d’un autre.   
**Utilisation**  
+ `{{gt valuea valueb yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#gt valuea valueb}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/gt}}`

  `gt` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/gt}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cet exemple, l'assistant compare la valeur de l'`User.UserAttributes.UserAge.[0]`attribut à une chaîne *17* afin de vérifier si l'âge de l'utilisateur est supérieur à 17 ans. Si la réponse est `true`, une déclaration true est renvoyée. Si la réponse est `false`, une déclaration `else` est renvoyée.  
`{{#gt User.UserAttributes.UserAge.[0] "17"}}`  
*You are old enough to rent a car.*  
`{{else}}`  
*You are not old enough to rent a car.*  
`{{/gt}}`

*gte*  
Teste si la valeur d’un élément est supérieure ou égale à celle d’un autre.  
`Usage`  
+ `{{gte valuea valueb yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#gte valuea valueb}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/gte}}`

  `get` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/gte}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cet exemple, l'assistant compare l'`User.UserAttributes.UserAge.[0]`attribut à une chaîne *18* afin de vérifier si l'âge de l'utilisateur est supérieur ou égal à 18 ans. Si la réponse est `true`, une déclaration true est renvoyée. Si la réponse est `false`, une déclaration `else` est renvoyée.  
`{{#gte User.UserAttributes.UserAge.[0] "18"}}`  
*You are old enough to rent a car.*  
`{{else}}`  
*You are not old enough to rent a car.*  
`{{/gte}}`

*if*  
Évalue si quelque chose est « true » et renvoie une réponse basée sur l’évaluation.  
**Utilisation**  
+ `{{#if value}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#if value}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/if}}`

  `if` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/if}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cet exemple, l’assistant est utilisé pour évaluer le prénom d’un utilisateur. Si le nom est trouvé, un message d’accueil est renvoyé qui transmet le prénom de l’utilisateur dans la réponse. Dans le cas contraire, l’instruction « else » renvoie un autre message d’accueil.  
`{{#if User.UserAttributes.FirstName.[0]}}`  
*Hello* `{{User.UserAttributes.FirstName.[0]}}`*,*  
`{{else}}`  
*Hello,*  
`{{/if}}`  
renvoie *Hello Jane,* si l'assistant est vrai.

*lt*  
Teste si la valeur d’un élément est inférieure à la valeur d’un autre.  
**Utilisation**  
+ `{{lt valuea valueb yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#lt valuea valueb}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/lt}}`

  `lt` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/lt}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cet exemple, l'assistant compare l'`User.UserAttributes.UserAge.[0]`attribut à une chaîne *18* afin de vérifier si l'âge de l'utilisateur est inférieur à 18 ans. Si la réponse est `true`, une déclaration true est renvoyée. Si la réponse est `false`, une déclaration `else` est renvoyée.  
`{{#lt User.UserAttributes.UserAge.[0] "18"}}`  
*You are not old enough to rent a car.*  
`{{else}}`  
*You are old enough to rent a car.*  
`{{/lt}}`

*lte*  
Teste si la valeur d’un élément est inférieure ou égale à celle d’un autre.  
**Utilisation**  
+ `{{lte valuea valueb yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#lte valuea valueb}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/lte}}`

  `lte` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/lte}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cette instruction de bloc, l'assistant compare l'`User.UserAttributes.UserAge.[0]`attribut à une chaîne *17* afin de vérifier si l'âge de l'utilisateur est inférieur ou égal à 17 ans. Si la réponse est `true`, une déclaration true est renvoyée. Si la réponse est `false`, une déclaration `else` est renvoyée.  
`{{#lte User.UserAttributes.Age.[0] "17"}}`  
*You are not old enough to rent a car.*  
`{{else}}`  
*You are old enough to rent a car.*  
`{{/lte}}`

*neq*  
Vérifiez si deux éléments *ne sont pas* égaux.  
**Utilisation**  
+ `{{neq valuea valueb yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#neq valuea valueb}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/neq}}`

  `neq` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/neq}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cette instruction de bloc, l’attribut `User.UserAttributes.FavoriteColors.[0]` est comparé à la chaîne `Red`. Si la réponse est `true`, une déclaration true est renvoyée. Si la réponse est `false`, une déclaration `else` est renvoyée.  
`{{#neq User.UserAttributes.Favorite.Colors.[0] "red"}}`  
*You do not like red.*  
`{{else}}`  
*You like red.*  
`{{/neq}}`

*not*  
Inverse la réponse d’une opération booléenne, de sorte que si `not` est une comparaison positive, une instruction `true` soit renvoyée. Si la réponse est false, une instruction « else » est renvoyée.   
**Utilisation**  
+ `{{not value yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.
+ `{{#not value}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/not}}`

  `not` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/not}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cette instruction de bloc, l'`User.UerAttributes.FavoriteColors.[0]`attribut est comparé à une chaîne à *red* l'aide de l'`eq`assistant. L’assistant `not` renvoie alors le contraire de l’assistant `eq`. Si la réponse renvoie une couleur autre que*red*, `true` une instruction est renvoyée. Si la réponse est renvoyée*red*, une `else` déclaration indiquant une fausse déclaration est renvoyée.  
`{{#not (eq User.UserAttributes.Favorite.Colors.[0] "red")}}`  
*You do not like red.*  
`{{else}}`  
*You like red.*  
`{{/not}}`  
**Exemple**  
Dans cet exemple,   
`{{not (eq User.UserAttributes.FavoriteColors.[0] "red")}}`  
renvoie faux si `User.UserAttributes.FavoriteColors.[0]` c'est le cas*red*.

*or*  
Compare si *l’un* des éléments de l’argument est égal, puis renvoie une réponse basée sur le résultat. Cet assistant peut être utilisé pour les valeurs non booléennes.  
**Utilisation**  
+ `{{or valuea valueb valuec valued yes='y' no='n'}}`

  Vous pouvez remplacer *y* et par *n* d'autres valeurs, telles que *yes* et*no*, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition. Vous devez transmettre au moins deux éléments pour la condition.
+ `{{#or valuea valueb}}`

  La condition est true.

  `{{else}}`

  La condition est false.

  `{{/or}}`

  `or` doit être précédé d’un signe dièse (`#`) et se terminer par un symbole `{{/or}}` fermant dans l’instruction de bloc.
**Exemple**  
Dans cette instruction de bloc `or`, deux chaînes de l’attribut `Location.City` sont également comparées à l’aide de l’assistant `eq`. Si l’un des attributs est `true`, une déclaration true est renvoyée. Si une ou plusieurs réponses sont `false`, une instruction `else` est renvoyée.  
`{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}`  
*You live on the West Coast of the United States.*  
`{{else}}`  
*You do not live on the West Coast of the United States.*  
`{{/or}}`

## Assistants de chaîne
<a name="stringhelpers"></a>

Cette section décrit les assistants de **chaîne** suivants :
+ `abbreviate` : tronque une valeur.
+ `capitalize` : met en majuscule chaque mot entre des espaces blancs.
+ `capitalizeFirst` : met en majuscule le premier caractère d’une valeur.
+ `center` : centre une valeur.
+ `cut` : supprime une valeur.
+ `dateFormat` : définit le style de date.
+ `inflect` : renvoie une chaîne au singulier ou au pluriel en fonction du nombre.
+ `join` : joint un tableau, un itérateur ou un objet itérable.
+ `ljust` : justifie une valeur dans la marge de gauche.
+ `lower` : convertit une valeur en minuscules.
+ `now` : imprime la date actuelle.
+ `ordinalize` : ordinalise une valeur numérique.
+ `replace` : remplace une chaîne par une autre.
+ `rjust` : justifie une valeur par la marge droite.
+ `slugify` : convertit une valeur en minuscules et supprime les caractères autres que des mots, convertit les espaces en tirets et supprime les espaces blancs de fin.
+ `stripTags` : supprime les balises HTML [X] d’une valeur.
+ `substring` : renvoie une nouvelle chaîne sous forme de sous-chaîne d’une valeur transmise.
+ `upper` : convertit la valeur transmise en majuscules.
+ `yesno` : remplace true, false et « no » par « Oui », « Non » et « Peut-être ».

*abbreviate*  
Tronque une valeur si celle-ci dépasse le nombre spécifié. Les espaces blancs sont inclus dans le décompte des longueurs. Des points de suspension apparaissent dans la réponse pour indiquer une valeur tronquée. Les points de suspension sont pris en compte dans la valeur tronquée de la réponse. Ce type d’assistant est pratique si vous avez une grande table et un espace minimal. Le fait de tronquer les valeurs d’une cellule permet d’uniformiser l’apparence du tableau.  
**Utilisation**  
 `{{abbreviate value X}}`, en *X* remplaçant par une valeur numérique indiquant le nombre de caractères à conserver. Les nombres négatifs ne sont pas pris en charge.  
**Exemple**  
Dans cet exemple, `abbreviate` est utilisé pour tronquer `User.UserAttributes.LastName.[0]` à six (6) caractères. La réponse comprend des points de suspension, dont les points sont pris en compte dans le total des six caractères.  
`{{abbreviate User.UserAttributes.LastName.[0] 6}}` renvoie  
*Ale...*si *Alejandro* est la valeur de`[0]`.

*capitalize*  
Met en majuscule chaque mot entre des espaces blancs.  
**Utilisation**  
 `{{capitalize value}}`  
**Exemple**  
Dans cet exemple, la capitalisation initiale est appliquée à chaque mot de l’entrée `Attributes.description.[0]`.  
`{{capitalize Attributes.description.[0]}}`  
Si `Attributes.description.[0]` renvoie   
 *My First Post*, si la valeur de `Attributes.description.[0]` est*my first post*.

*capitalizeFirst*  
Met en majuscule le premier caractère d’une valeur.  
**Utilisation**  
`{{capitalizeFirst value}}`  
**Exemple**  
Dans cet exemple, la mise en majuscule est appliquée au premier caractère du premier mot de l’entrée `Attributes.description.[0]`.  
`{{capitalizeFirst Attributes.description.[0]}}` renvoie  
 *My first post*, si la valeur de `Attributes.description.[0]` est*my first post*.  
**Exemple**

*center*  
Centre la valeur dans un champ d’une largeur donnée par le nombre spécifié. Vous pouvez éventuellement transmettre un caractère à afficher pour le remplissage ou laisser le champ vide. Si aucun caractère n’est transmis, un espace blanc est utilisé.  
**Utilisation**  
 `{{center value size=X [pad=" "}}`, en *X* remplaçant par une valeur numérique.  
Si `pad` est laissé vide, un espace blanc est utilisé comme remplissage dans la réponse. Si vous transmettez un caractère, celui-ci apparaît dans chaque espace du remplissage. Les nombres négatifs ne sont pas pris en charge.  
**Exemple**  
Dans cet exemple, la valeur de `Location.City ` est centrée sur une taille de*19*.  
`{{center Location.City size=19}}` renvoie   
*"    Los Angeles    "*Si `Location.City` c'est le cas*Los Angeles*. Notez que les guillemets affichés dans l’exemple de sortie sont uniquement fournis pour souligner la valeur.

*cut*  
Supprime la valeur spécifiée d’une chaîne de caractères.   
**Utilisation**  
 `{{cut value [" "]}}`, en remplaçant l’espace dans le paramètre entre guillemets par la valeur à couper. Si aucune valeur de paramètre n’est transmise, un espace blanc est utilisé.   
**Exemple**  
Cet exemple supprime la lettre *e* de l'`Location.City`attribut.  
`{{cut Location.City "e"}}` renvoie  
*Los Angls*si `[Location.City` c'est le cas*Los Angeles*.

*dateFormat*  
Définit le style de date par défaut pour la date dans n’importe quelle réponse. Pour obtenir la liste des fuseaux horaires IDs, voir[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).  
**Utilisation**  
`{{dateFormat date [inputFormat="format1"] [outputFormat="format2"] [tz=timeZoneId] [locale=localeID]}}`  
Le paramètre `format` doit être défini sur .  
+ « `full` » : format de date complet. Par exemple : *Tuesday, September 19, 2020*
+ « `long` » : format de date long. Par exemple : *September 19, 2020*
+ « `medium` » : format de date moyen. Par exemple : *Sept 19, 2020*
+ « `short` » : format de date court. Par exemple : *9/19/20*
+ « `pattern` » : utilise un format de modèle de date personnalisé. Pour plus d’informations sur les modèles de date, consultez [https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html).
« `locale` » : utilise un format de date basé sur des paramètres régionaux donnés. Pour plus d’informations concernant les paramètres régionaux, consultez [https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-).  
Si un format n’est pas transmis, `medium` est utilisé par défaut.   
**Exemple**  
Dans cet exemple, l'`[0]`entrée `User.UserAttributes.StartDate.[0]` est **09/19/2020** et un message est envoyé à un utilisateur en utilisant le format de `full` date basé sur le *America/Los\$1Angeles* fuseau horaire.  
`We can meet with you any time on ``{{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.` renvoie  
*We can meet with you any time on Tuesday, September 19, 2020.*

*inflect*  
Renvoie une chaîne au singulier ou au pluriel en fonction de la valeur du décompte.  
**Utilisation**  
 `{{inflect count singular plural [includeCount=false]}}`  
+ Entrez les formes singulière et plurielle de la chaîne que vous souhaitez transmettre dans l’argument.
+ Si `includeCount` est défini sur `false`, aucun nombre n’est renvoyé dans la réponse. S’il est défini sur `true`, le `count` est inclus dans la réponse.
**Exemple**  
Les exemples suivants montrent l’inflexion d’un achat de pommes, avec ou sans `includeCount`.  
`Thank you for your purchase of {{inflect 3 apple apples includeCount=false}}.` renvoie :  
*Thank you for your purchase of apples.*  
Si `includeCount` est défini sur `true`, la réponse est  
*Thank you for your purchase of 3 apples.*

*joindre*  
Joint un tableau, un itérateur ou un objet itérable. La réponse renvoie une liste, chaque valeur de la liste étant concaténée par le caractère que vous avez transmis à `join`. Par exemple, vous pouvez séparer les valeurs à l’aide d’une virgule (`,`). La valeur de cet assistant doit être une liste sans indice de position d’attribut. Par exemple, `Attributes.custom_attribute`.  
**Utilisation**  
`{{join value " // " [prefix=""] [suffix=""]}}`  
**Exemple**  
Dans cet exemple, une liste de couleurs est renvoyée, séparée par une virgule et un espace (`", "`) :  
`{{join Attributes.favorite_colors ", "}}` renvoie   
*blue, red, green*si `Attributes.favorite_colors` c'est la liste*blue,red,green*.

*ljust*  
Justifie la valeur dans la marge de gauche et ajoute de l’espace sur la droite pour que la longueur de la valeur corresponde au nombre. Les nombres négatifs ne sont pas pris en charge.  
Vous pouvez éventuellement transmettre un caractère à afficher pour le `pad` ou laisser le champ vide. Si vous laissez la valeur `pad` vide, la valeur par défaut est un espace blanc.  
**Utilisation**  
`{{ljust value size=X [pad=" "]}}`, où *X* est la longueur totale de la valeur, espaces blancs compris.   
**Exemple**  
Dans cet exemple, une valeur de justification gauche de *15 * est appliquée à Location.City.  
`{{ljust Location.City size=15}}` renvoie  
*"Los Angeles    "*si la valeur de `Location.City` est*Los Angeles*. Notez que les guillemets affichés dans l’exemple de sortie sont uniquement fournis pour souligner la valeur.

*lower*  
Convertit une valeur en minuscules.  
**Utilisation**  
`{{lower value}}`  
**Exemple**  
Dans cet exemple, l’entrée `[0]` pour `User.UserAttributes.LastName.[0]` est remplacée par des minuscules.  
`{{lower User.UserAttributes.LastName.[0]}}` renvoie  
*santos*si *Santos* est la valeur de`[0]`.

*maintenant*  
Imprime la date actuelle en fonction de l’ID de fuseau horaire passé. Pour obtenir la liste des fuseaux horaires IDs, voir[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).  
**Utilisation**  
`{{now [format="format"] [tz=timeZoneId] [locale=localeID]}}`  
Le paramètre `format` doit être défini sur .  
+ « `full` » : format de date complet. Par exemple : *Tuesday, September 19, 2020*
+ « `long` » : format de date long. Par exemple : *September 19, 2020*
+ « `medium` » : format de date moyen. Par exemple : 19 sept 2020
+ « `short` » : format de date court. Par exemple : 19/9/20
+ « `pattern` » : un modèle de date. Pour plus d’informations sur les modèles de date, consultez [https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html). 
« `locale` » : utilise un format de date basé sur des paramètres régionaux donnés. Pour plus d’informations concernant les paramètres régionaux, consultez [https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-).  
Si un format n’est pas transmis, `medium` est utilisé par défaut.  
**Exemple**  
Dans cet exemple, la date actuelle à Los Angeles est renvoyée au format `medium`.  
`{{now "medium" tz=America/Los_Angeles}}` renvoie   
*Sept 19, 2020*.

*ordinalize*  
Ordinalise la valeur numérique transmise dans l’argument. Par exemple, *1* est ordinalisé comme *1st* et *2* comme*2nd*. Seules les valeurs numériques sont prises en charge.  
**Utilisation**  
`{{ordinalize [number]}} `  
**Exemple**  
Dans cet exemple, l’entrée `[0]` de `User.UserAttributes.UserAge` est ordinalisée et renvoyée, accompagnée d’un message.   
`Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!`renvoie *22* ordinalisé comme*22nd*.  
*Congratulations on your 22nd birthday\$1*

*replace*  
Remplace une chaîne par une autre. Une chaîne ou une valeur numérique doit être littérale. Les caractères génériques ne sont pas pris en charge.  
**Utilisation**  
`{{replace stringToReplace replacementValue}}`  
**Exemple**  
Dans cet exemple, un trait de soulignement (\$1) remplace un espace blanc.  
`{{replace Location.City " " "_"}}` renvoie  
*Los\$1Angeles*si `Location.City ` c'est le cas*Los Angeles*.

*rjust*  
Justifie la valeur par la marge de droite et ajoute de l’espace vers la gauche pour que la longueur de la valeur corresponde au nombre. Les nombres négatifs ne sont pas pris en charge.  
Vous pouvez éventuellement transmettre un caractère à afficher pour le `pad` ou laisser le champ vide. Si vous conservez la valeur `pad` vide, la valeur par défaut est un espace blanc.  
**Utilisation**  
`{{rjust value size=X [pad=" "]}}`, où *X* est la longueur totale de la valeur, espaces blancs compris.   
**Exemple**  
Dans cet exemple, une valeur de justification correcte de *15* est appliquée à l'`Location.City`attribut.  
`{{rjust Location.City size=15}}` renvoie  
*"    Los Angeles" *. si `Location.City` c'est le cas*Los Angeles*. Notez que les guillemets affichés dans la sortie ne sont fournis qu’à titre d’accentuation.

*slugify*  
Convertit la valeur transmise en minuscules, supprime les caractères autres que les mots (alphanumériques et traits de soulignement), convertit les espaces en traits d’union et supprime tout espace blanc en début ou en fin de texte.  
**Utilisation**  
`{{slugify value}}`  
**Exemple**  
Dans cet exemple, l’opération slugify est effectuée pour l’attribut `Location.City`.   
`{{slugify Location.City}}` renvoie  
*los-angeles*si `Location.City` c'est le cas*Los Angeles*.

*stripTags*  
Supprime les balises HTML [X] d’une valeur.  
**Utilisation**  
 `{{stripTags value}}`  
**Exemple**  
Dans cet exemple, les balises HTML pour l'utilisateur. UserAttributes.interest. [0] sont supprimés.   
`{{stripTags User.UserAttributes.interests.[0]}}` renvoie  
*Art*, si `User.UserAttributes.interests.[0]` c'est le cas`<h1>Art</h1>`.

*substring*  
Renvoie une nouvelle chaîne sous forme de sous-chaîne de la valeur transmise. La longueur et la position sont déterminées par les paramètres `startOffset` et `endOffset`, qui doivent être des entiers. Les nombres négatifs ne sont pas pris en charge. Si un `endOffset` n’est pas transmis, la sous-chaîne utilise la valeur de fin d’origine de la chaîne.  
**Utilisation**  
`{{substring value startOffset [endOffset]}}`  
**Exemple**  
Dans cet exemple, un décalage de 4 et un endOffset de 9 sont appliqués à l’attribut Location.City.   
`{{substring Location.City 4 9}} ` renvoie  
`Angel`si Los Angeles nous `Location.City` vaut*Los Angeles*.

*upper*  
Convertit la valeur transmise en majuscules.  
**Utilisation**  
`{{upper value}}`  
**Exemple**  
Dans cet exemple, l’entrée `[0] ` de l’attribut `User.UserAttributes.LastName` est convertie en majuscules.  
`{{upper User.UserAttributes.LastName.[0]}}` renvoie  
*ROE*si la `User.UserAttributes.LastName.[0]` valeur est*Roe*.

*yesno*  
Remplace `true`, `false` et `NULL` par `Yes`, `No` et `Maybe`.  
**Utilisation**  
`{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}`  
**Exemple**  
Dans cet exemple, l’attribut `IsUserSubscribed` indique si un utilisateur est abonné à une liste particulière.  
`{{yesno Attributes.IsUserSubscribed}}` renvoie   
*yes*si `Attributes.IsUserSubscribed` c'est le cas*true*.

## Assistants mathématiques et d’encodage
<a name="mathhelpers"></a>

Cette section décrit les assistants **mathématiques et d’encodage**.
+ `add` : renvoie la somme de deux nombres.
+ `ceiling` : arrondit un entier à son plafond mathématique.
+ `decode64` : décode en chaîne une valeur encodée en base64.
+ `divide` : renvoie le quotient de deux nombres.
+ `encode64` : encode une chaîne en base64.
+ `floor` : arrondit un entier à son plancher mathématique.
+ `md5`— Hache une chaîne transmise à l'aide de l' MD5algorithme.
+ `modulo` : renvoie le reste de deux nombres avec des virgules flottantes.
+ `multiply` : renvoie le produit de deux nombres.
+ `round` : arrondit une valeur décimale au nombre entier le plus proche.
+ `sha256` : hache une chaîne transmise en utilisant SHA-256.
+ `sha512` : hache une chaîne transmise en utilisant SHA-512.
+ `subtract` : renvoie la différence de deux nombres.
+ `uuid` : génère aléatoirement un UUID au format 128 bits.

*ajouter*  
Renvoie la somme de deux nombres avec des virgules flottantes.  
**Utilisation**  
`{{add arg1 arg2}}`  
**Exemple**  
`{{add 5 2.3}} ` renvoie  
*7.3*

*ceiling*  
Arrondit un entier à son plafond mathématique, qui est le nombre entier le plus élevé le plus proche de la valeur transmise.  
**Utilisation**  
`{{ceiling value}}`  
**Exemple**  
`{{ceiling 5.23}}` renvoie  
*6*

*decode64*  
Décode en chaîne une valeur encodée en base64.  
**Utilisation**  
`{{decode64 "string"}}`  
**Exemple**  
`{{decode64 "SGVsbG8gd29ybGQ="}}` renvoie  
*Hello World*

*divide*  
Renvoie le quotient de deux nombres, virgules flottantes comprises.  
**Utilisation**  
 `{{divide arg1 arg2}}`  
**Exemple**  
`{{divide 5 2.3}}` renvoie  
*2.17391304*

*encode64*  
Encode la chaîne transmise dans l’argument avec base64.  
**Utilisation**  
`{{encode64 "string"}}`  
**Exemple**  
`{{encode64 "Hello World"}}`  
*SGVsbG8gd29ybGQ=*

*floor*  
Arrondit un entier à son plancher mathématique, qui est le plus petit nombre entier le plus proche de la valeur transmise.  
**Utilisation**  
`{{floor value}}`  
**Exemple**  
`{{floor 5.23}}` renvoie  
*5*

*md5*  
Hache une chaîne transmise à l'aide de l' MD5 algorithme.  
**Utilisation**  
`{{md5 "string"}}`  
**Exemple**  
`{{md5 "Hello World"}}`  
*3e25960a79dbc69b674cd4ec67a72c62*

*modulo*  
Renvoie le reste de deux nombres en utilisant des nombres à virgule flottante.  
**Utilisation**  
`{{modulo arg1 arg2}}`  
**Exemple**  
`{{modulo 7 2}}` renvoie  
*1*

*multiply*  
Renvoie le produit de deux nombres, avec les virgules flottantes éventuelles.  
**Utilisation**  
`{{multiply arg1 arg2}}`  
**Exemple**  
`{{multiply 5 2.3}}` renvoie  
*11.5*

*round*  
Arrondit une décimale vers le haut ou vers le bas au nombre entier le plus proche.  
**Utilisation**  
`{{round value}}`  
**Exemple**  
`You spent an average of {{round 19.21}} minutes on our website each day.` renvoie :  
*You spent an average of 19 minutes on our website each day.*

*sha256*  
Hache une chaîne transmise à l’aide de la sécurité cryptographique SHA-256.  
**Utilisation**  
`{{sha256 "string"}}`  
**Exemple**  
`{{sha256 "Hello World"}}` renvoie  
*a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e*

*sha512*  
Hache une chaîne transmise à l’aide de la sécurité cryptographique SHA-512.  
**Utilisation**  
`{{sha512 "string"}}`  
**Exemple**  
`{{sha512 "Hello World"}}` renvoie  
*2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b*

*subtract*  
Renvoie la différence de deux nombres, avec des virgules flottantes éventuelles.  
**Utilisation**  
`{{subtract arg1 arg2}}`  
**Exemple**  
`{{subtract 5 2.3}} ` renvoie  
*2.7*

*uuid*  
Génère aléatoirement un UUID dans un format standard de 128 bits. Aucune valeur ne doit être transmise dans l’argument.  
**Utilisation**  
`{{uuid}}`  
**Exemple**  
`{{uuid}} ` renvoie  
**95f36680-152c-4052-99ec-cc3cdf7ca594**

## Partiels en ligne
<a name="inlinepartials"></a>

Bien qu’ils ne soient techniquement pas des assistants, les partiels en ligne sont un moyen utilisé par Handlebar pour simplifier les modèles qui incluent des chaînes répétées, afin de faciliter leur réutilisation. Pour plus d’informations, consultez [Partiels en ligne](https://handlebarsjs.com/guide/partials.html#inline-partials) sur [handlebarsjs.com](https://handlebarsjs.com). 

**Utilisation**

`{{#* inline "inlineName"}}Content to reuse{{/inline}}`

Pour référencer le contenu du partiel en ligne ailleurs, utilisez :

` {{> inlineName}}`

**Exemple**

L’exemple suivant crée un partiel en ligne qui inclut le prénom du destinataire et, s’il est disponible, son nom de famille, en ajoutant le code suivant au début du modèle :

`{{#* inline "fullName"}}`

`{{User.UserAttributes.FirstName.[0]}} {{#if User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}`

`{{/inline}}`

Après avoir créé le partiel `fullName`, vous pouvez l’inclure n’importe où dans votre modèle en faisant précéder le nom du partiel d’un symbole `>` (plus grand que), suivi d’un espace, comme dans l’exemple suivant : `{{> fullName}}`.

*` Hello {{> fullName}}`*

renvoie le prénom et le nom de famille de l'utilisateur s'ils sont vrais, par exemple*Hello Jane Doe*. Sinon, si aucun nom de famille n'est trouvé, *Hello Jane* il est renvoyé.

Handlebars inclut d’autres fonctionnalités en plus de celles documentées ici. Pour plus d’informations, consultez [handlebarsjs.com](https://handlebarsjs.com/).

## Utilisation de variables avec des assistants de modèles de messages
<a name="template-helpers-variables"></a>

Les attributs personnalisés d’Amazon Pinpoint, tels que `User.UserAttributes.LastName`, sont stockés sous forme de liste, qu’il s’agisse d’un ou de plusieurs éléments. Lorsque vous transmettez une liste dans un assistant qui attend une chaîne, vous devez spécifier la valeur de l’index d’attribut ainsi que le nom de l’attribut. Cette valeur d’index d’attribut indique la position d’une valeur dans la liste d’attributs : `.[0]` pour la première entrée de la liste, `.[1]` pour la deuxième, `.[2]` pour la troisième, etc. Par exemple, supposons que vous utilisiez l’assistant `upper` pour convertir la première entrée (`[0]`) de `User.UserAttributes.LastName` en majuscules. L’utilisation de l’assistant est `{{upper value}}`, et l’attribut formaté comme `User.UserAttributes.LastName`. Remplacez *value* par le nom de l'attribut et la valeur de l'index de l'attribut `.[0]` comme suit :`{{upper User.UserAttributes.LastName.[0]}}`. La réponse renvoie ensuite l’entrée `[0]` de la liste, mise en forme entièrement en majuscules. Par exemple, si la valeur de `[0]` est*Santos*, la réponse est renvoyée*SANTOS*. 

Les noms des attributs personnalisés Amazon Pinpoint prennent en charge les espaces. Pour qu'un attribut personnalisé soit appelé`"Last Name"`, vous devez formater l'attribut comme suit`User.UserAttributes.[Last Name]`. Pour accéder à la première entrée de la liste des index d'attributs, le format est le suivant`User.UserAttributes.[Last Name].[0]`.

Un nom d’attribut personnalisé peut contenir jusqu’à 50 caractères. Une valeur d’attribut peut contenir jusqu’à 100 caractères. Lorsque vous définissez le nom d’un attribut personnalisé, évitez d’utiliser les caractères suivants : signe numérique (\$1), deux-points (:), point d’interrogation (?) et barres obliques (\$1/). La console Amazon Pinpoint ne peut pas afficher les noms d’attributs contenant ces caractères. Cette restriction ne s’applique pas aux valeurs d’attributs.

## Utilisation d’assistants imbriqués
<a name="template-helpers-nesting"></a>

 Vous pouvez imbriquer plusieurs modèles de messages d’assistance les uns dans les autres. L’exemple suivant montre comment formater deux assistants : `{{ first helper (second helper)}}`. Le second assistant est traité en premier, suivi du premier assistant. N’oubliez pas que le premier assistant détermine toujours la sortie. Les assistants suivants doivent être imbriqués dans l’assistant précédent comme suit : `{{ first helper (second helper (third helper) )}}`.

L’exemple suivant montre comment imbriquer deux assistants pour transformer **JANE** en **Jane** : `{{capitalizeFirst (lower "JANE")}}`. `lower` convertit d’abord **JANE** en **jane**. Puis `capitalizeFirst` convertit **jane** en **Jane**.

# Gestion des modèles de message
<a name="message-templates-managing"></a>

La page des **modèles de messages** de la console Amazon Pinpoint fournit un emplacement unique où vous pouvez créer, consulter et gérer tous les modèles de messages pour votre compte Amazon Pinpoint dans la région actuelle. AWS En utilisant cette page, vous pouvez gérer vos modèles de messages en tant que collection unique. Cela peut vous aider à concevoir des messages cohérents et à réutiliser le contenu plus facilement et plus efficacement. Vous pouvez utiliser cette page pour effectuer des tâches de gestion telles que l'affichage et la modification de modèles, ainsi que la copie, la suppression et la création de modèles.

**Topics**
+ [

# Affichage de votre collection de modèles de message
](message-templates-managing-view-all.md)
+ [

# Ouverture d'un modèle de message
](message-templates-managing-open.md)
+ [

# Modification d'un modèle de message
](message-templates-managing-edit.md)
+ [

# Copie d'un modèle de message
](message-templates-managing-copy.md)
+ [

# Suppression d'un modèle de message
](message-templates-managing-delete.md)
+ [

# Ajout d’une balise à un modèle
](message-templates-managing-add-tag.md)
+ [

# Supprimer une balise d’un modèle
](message-templates-managing-remove-tag.md)

Pour plus d'informations sur la création d'un modèle de message, consultez [Création de modèles d'e-mail](message-templates-creating-email.md), [Création de modèles de notification push](message-templates-creating-push.md), [Création de modèles de SMS](message-templates-creating-sms.md) ou [Création de modèles vocaux](message-templates-creating-voice.md), selon le type de modèle que vous souhaitez créer.

Pour plus d'informations sur l'affichage et la gestion des versions des modèles, consultez [Gestion des versions des modèles de message](message-templates-versioning.md).

# Affichage de votre collection de modèles de message
<a name="message-templates-managing-view-all"></a>

La page **Modèles de messages** affiche une liste de tous les modèles de messages actuels pour votre compte Amazon Pinpoint. Région AWS Pour parcourir la liste ou trouver rapidement des modèles spécifiques, vous pouvez trier et filtrer la liste, choisir les colonnes à afficher et modifier les autres paramètres d'affichage de la liste.

**Pour afficher votre collection de modèles de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**. La page **Message templates (Modèles de message)** s'ouvre et affiche le nombre de modèles dans votre collection ainsi qu'une liste de ces modèles.

1. Pour personnaliser la liste ou trouver rapidement un modèle spécifique, choisissez l'une des options suivantes :
   + Pour trier la liste selon un type de valeur spécifique, sélectionnez l'en-tête de colonne correspondant à cette valeur. Pour modifier l'ordre de tri croissant à décroissant ou inversement, sélectionnez à nouveau l'en-tête de colonne. 
   + Pour appliquer un filtre qui affiche uniquement un type spécifique de modèle, utilisez le sélecteur de canal en haut de la page pour choisir le canal. Pour supprimer le filtre, choisissez **Tous les canaux de messages (All message channels)** dans le sélecteur de canaux.
   + Pour appliquer un filtre qui affiche uniquement les modèles dont les noms contiennent un texte spécifique, saisissez le texte dans la zone **Search (Rechercher)** au-dessus de la liste. Pour supprimer le filtre, cliquez sur **X** dans la zone **Search (Rechercher)**.
   + Pour modifier le nombre de modèles affichés dans la liste, choisissez l'icône Paramètres en haut de la page. Ensuite, pour **Page size (Taille de la page)**, choisissez le nombre de modèles à afficher, puis choisissez **Save changes (Enregistrer les modifications)**.
   + Pour ajouter ou supprimer des colonnes de la liste, choisissez l'icône Paramètres en haut de la page. Ensuite, dans **Choose visible columns (Choisir les colonnes visibles)**, activez ou désactivez chaque colonne, puis choisissez **Save changes (Enregistrer les modifications)**.

# Ouverture d'un modèle de message
<a name="message-templates-managing-open"></a>

À l'aide de la page **Message templates (Modèles de message)**, vous pouvez rapidement rechercher et ouvrir un modèle de message spécifique pour afficher le contenu du modèle et des informations sur le modèle. Par exemple, vous pouvez afficher les versions actuelles et précédentes du modèle et déterminer la date de la dernière mise à jour du modèle. Après avoir ouvert un modèle, vous pouvez également le [modifier](message-templates-managing-edit.md).

**Pour ouvrir un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Dans la page **Message templates (Modèles de message)** choisissez le modèle que vous souhaitez ouvrir. La page du modèle s'ouvre et affiche des informations le concernant. Est également présenté le contenu de la version active du modèle.

1. Pour afficher une version différente du modèle, utilisez le sélecteur de version sous **Template details (Détails du modèle)** pour choisir la version à afficher.

# Modification d'un modèle de message
<a name="message-templates-managing-edit"></a>

Vous pouvez ouvrir un modèle de message à modifier de deux façons : lorsque vous créez un message qui utilise le modèle, et à l'aide de la page **Message templates (Modèles de message)**. Cette rubrique explique comment ouvrir et modifier un modèle à l'aide de la page **Message templates (Modèles de message)**.

Si vous modifiez un modèle, Amazon Pinpoint peut appliquer vos modifications aux messages existants qui utilisent le modèle et qui n’ont pas encore été envoyés, par exemple, les messages de campagne qui doivent être envoyés ultérieurement. Cela dépend de si vous modifiez la version active du modèle et de la façon dont vous avez configuré les messages qui utilisent le modèle. Pour de plus amples informations, veuillez consulter [Gestion des versions des modèles de message](message-templates-versioning.md).

**Pour modifier un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Dans la page **Message templates (Modèles de message)** choisissez le modèle à modifier. La page du modèle s'ouvre et affiche des informations le concernant. Sont également présentés le contenu et les paramètres de la version active du modèle.

1. Choisissez **Modifier**.

1. Sous **Template details (Détails du modèle)**, utilisez le sélecteur de version pour choisir la version du modèle que vous souhaitez utiliser comme point de départ de vos modifications. Si vous choisissez la version la plus récente du modèle, vous pouvez enregistrer vos modifications directement dans cette version du modèle. Dans le cas contraire, vous pouvez enregistrer vos modifications en tant que nouvelle version du modèle.

1. Apportez les modifications que vous souhaitez. Vous pouvez modifier le contenu ou les paramètres du modèle, à l'exception du nom. Pour modifier le nom du modèle, vous pouvez [créer une copie du modèle](message-templates-managing-copy.md), enregistrer la copie avec le nom de votre choix, puis supprimez le modèle d'origine.

1. Lorsque vous avez terminé d'apporter des modifications, effectuez l'une des opérations suivantes :
   + Pour enregistrer vos modifications en tant que nouvelle version du modèle, choisissez **Save as new version (Enregistrer en tant que nouvelle version)**. Pour garantir que vos modifications n'affectent aucun message existant, nous vous recommandons de choisir cette option.
   + Pour enregistrer vos modifications en tant que mise à jour de la version la plus récente du modèle, choisissez **Update version (Mettre à jour la version)**. Cette option n'est disponible que si vous avez choisi la version la plus récente du modèle à l'étape 5. Si vous choisissez cette option, vos modifications peuvent affecter les messages existants qui utilisent le modèle.

# Copie d'un modèle de message
<a name="message-templates-managing-copy"></a>

Pour créer rapidement un modèle de message similaire à un modèle existant, vous pouvez en créer une copie. Vous pouvez ensuite modifier la copie du modèle, sans modifier le modèle d'origine.

**Pour copier un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Dans la page **Message templates (Modèles de message)** activez la case à cocher en regard du modèle que vous souhaitez copier.

1. Dans le menu **Actions**, sélectionnez **Duplicate (Dupliquer)**.

1. Pour **Template name (Nom du modèle)**, saisissez un nom pour la copie du modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (\$1) ou des traits d’union (‐). 

1. Après avoir saisi le nom, choisissez **Duplicate template (Dupliquer le modèle)**. La page du modèle s'ouvre et affiche l'ensemble du contenu et des paramètres de la version active du modèle que vous avez copié.

1. (Facultatif) Pour modifier la copie du modèle, choisissez **Edit (Modifier)**, apportez les modifications souhaitées, puis choisissez **Save as new version (Enregistrer en tant que nouvelle version)**.

# Suppression d'un modèle de message
<a name="message-templates-managing-delete"></a>

Si vous souhaitez supprimer complètement un modèle de message d’Amazon Pinpoint, vous pouvez le supprimer. Si vous supprimez un modèle, cela n'affecte pas les messages existants qui l'utilisent, par exemple, les messages de campagne qui doivent être envoyés ultérieurement.

**Avertissement**  
Si vous supprimez un modèle, Amazon Pinpoint supprime toutes les versions, le contenu et les paramètres du modèle. En outre, le modèle devient indisponible pour tous les messages futurs. Vous ne pouvez pas récupérer un modèle après l'avoir supprimé. 

**Pour supprimer un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Dans la page **Message templates (Modèles de message)** activez la case à cocher en regard de chaque modèle que vous souhaitez supprimer.

1.  Dans le menu **Actions**, sélectionnez **Delete (Supprimer)**.

# Ajout d’une balise à un modèle
<a name="message-templates-managing-add-tag"></a>

Une balise est une étiquette que vous pouvez définir et associer à AWS des ressources, notamment à certains types de ressources Amazon Pinpoint.

L’ajout d’une balise à un modèle peut vous aider à classer et à gérer les modèles de différentes manières, par exemple en fonction de l’objectif, du propriétaire, de l’environnement ou d’autres critères. Vous pouvez utiliser des balises pour trouver rapidement des modèles existants ou pour contrôler quels utilisateurs peuvent accéder à des modèles spécifiques. Vous pouvez ajouter au maximum 50 paires clé-valeur, chaque clé étant unique.

**Pour ajouter une balise**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Dans la page **Modèles de message** choisissez le modèle auquel vous souhaitez ajouter une balise.

1. Sous **Balises**, choisissez **Gérer les balises**.

1. Sélectionnez **Ajouter une nouvelle balise**.

1. Entrez la clé de balise et la paire de valeurs que vous souhaitez ajouter.

1. (Facultatif) Pour ajouter des balises supplémentaires, choisissez **Ajouter une nouvelle balise**.

1. Lorsque vous avez terminé, choisissez **Enregistrer les balises**.

# Supprimer une balise d’un modèle
<a name="message-templates-managing-remove-tag"></a>

Si vous jugez que vous n’avez plus besoin d’une balise à appliquer à un modèle, vous pouvez la supprimer via la console. 

**Pour supprimer une balise**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Dans la page **Modèles de message** choisissez le modèle dans lequel vous souhaitez supprimer une balise.

1. Sous **Balises**, choisissez **Gérer les balises**.

1. En regard de la balise que vous souhaitez supprimer, sélectionnez **Supprimer**.

1. Choisissez **Enregistrer les balises**.

Pour plus d’informations sur l’utilisation des balises dans les politiques IAM, consultez la section [Gestion des balises](https://docs.aws.amazon.com/pinpoint/latest/developerguide/tagging-resources.html).

# Gestion des versions des modèles de message
<a name="message-templates-versioning"></a>

Afin de vous aider à gérer le développement et l’utilisation de modèles de message individuels, Amazon Pinpoint prend en charge la gestion des versions pour tous les types de modèles de message. La gestion des versions vous permet de créer un historique des modifications apportées à un modèle : chaque version est un instantané d’un modèle à un moment donné. La gestion des versions permet également de contrôler le contenu et les paramètres des messages qui utilisent un modèle.

Chaque fois que vous modifiez un modèle, vous pouvez spécifier si vous souhaitez enregistrer vos modifications en tant que nouvelle version du modèle ou en tant que mise à jour de la version existante la plus récente du modèle. Lorsque vous concevez, développez et affinez un modèle, chacune de ces versions sert d'instantané qui peut vous aider à suivre la progression et l'état du modèle. Autrement dit, vous pouvez utiliser la gestion des versions pour stocker, suivre et gérer un modèle au fur et à mesure qu'il change au fil du temps. Vous pouvez effectuer les actions suivantes :
+ **Suivre l’historique d’un modèle** : pour chaque modèle, Amazon Pinpoint fournit une liste des versions du modèle. Cette liste présente le nom de chaque version et indique la date de dernière modification de la version. La liste est triée par ordre chronologique décroissant, la version la plus récente apparaissant en premier.
+ **Afficher et comparer les versions d’un modèle** : à l’aide de la liste des versions, vous pouvez parcourir les versions précédentes d’un modèle. Si vous choisissez une version dans la liste, Amazon Pinpoint affiche le contenu et les paramètres stockés dans cette version.
+ **Restaurer une version précédente d’un modèle** : si vous trouvez des problèmes dans la version la plus récente d’un modèle, vous pouvez ouvrir et modifier une version précédente qui ne contient pas ces problèmes. Vous pouvez ensuite enregistrer cette version précédente en tant que nouvelle version du modèle. Celle-ci devient alors la version la plus récente du modèle.

Vous pouvez également utiliser la gestion de versions pour contrôler la version d'un modèle qui peut être utilisée dans les messages. Pour ce faire, vous devez désigner une version spécifique comme *version active* d'un modèle. La *version active* est généralement la version la plus récente vérifiée et approuvée pour utilisation dans les messages, en fonction du flux de travail de votre organisation pour le développement et la gestion des modèles. 

Lorsque vous définissez une version en tant que version active, vous activez cette version pour l'utiliser dans les messages. Un modèle évoluant au fil du temps, vous pouvez désigner une version différente comme version active, et vous pouvez changer cette désignation plusieurs fois. 

**Note**  
Si vous devez modifier un modèle activement utilisé, nous vous recommandons de créer une nouvelle version du modèle. 

**Topics**
+ [

## Fonctionnement de la gestion des versions
](#message-templates-versioning-overview)
+ [

## Affichage des versions d'un modèle de message
](#message-templates-versioning-view-versions)
+ [

## Affichage de la version active d'un modèle de message
](#message-templates-versioning-view-active)
+ [

## Désignation de la version active d'un modèle de message
](#message-templates-versioning-set-active)
+ [

## Modification de la version active d'un modèle de message
](#message-templates-versioning-edit-active)

## Fonctionnement de la gestion des versions
<a name="message-templates-versioning-overview"></a>

Dans un flux de travail de développement classique, un modèle de message comporte de nombreuses versions. Ces versions s'échelonnent entre le début de la conception et du développement en passant par le test, la vérification et l'approbation de l'utilisation dans les messages. Dans certains cas, vous pouvez créer et approuver des versions supplémentaires après l'approbation initiale, à mesure que vous affinez et mettez à jour un modèle. Par exemple, vous pouvez ajouter des liens ou modifier la présentation d'un modèle en réaction aux données d'analyse d'une campagne qui utilise le modèle.

### Numérotation des versions
<a name="message-templates-versioning-overview-numbering"></a>

Lorsque vous créez un modèle, il n’existe qu’une seule version du modèle : la *Version 1*. Chaque fois que vous modifiez un modèle par la suite, vous précisez si vous souhaitez enregistrer vos modifications en tant que nouvelle version du modèle ou en tant que mise à jour à la version la plus récente du modèle. 

Si vous enregistrez vos modifications dans une nouvelle version, Amazon Pinpoint incrémente automatiquement le numéro de version de 1 et attribue ce numéro de version à la version : *version 1* pour la première version, *version 2* pour la deuxième version, *version 3* pour la troisième version et ainsi de suite. Les numéros de version ne sont jamais réutilisés. Vous pouvez enregistrer jusqu'à 5 000 versions d'un modèle.

Si vous enregistrez vos modifications en tant que mise à jour à la version la plus récente, Amazon Pinpoint écrase la version la plus récente pour ajouter vos modifications. Pour vous assurer de disposer d'une vue précise de l'historique d'un modèle, vous pouvez remplacer uniquement la version la plus récente d'un modèle à l'aide de la console Amazon Pinpoint. Vous ne pouvez pas remplacer les versions antérieures d'un modèle à l'aide de la console.

### Versions les plus récentes et actives
<a name="message-templates-versioning-overview-version-types"></a>

Pour prendre en charge le développement continu et à long terme de modèles, deux versions d'un modèle peuvent être actuelles en même temps. Il s'agit de la *dernière* version, qui est la version la plus récemment modifiée, et de la version *active*, qui est la version qui peut être utilisée dans les messages.

Selon le flux de travail de votre organisation, la version active est généralement la version qui a été récemment vérifiée et approuvée pour utilisation dans les messages. IL ne s'agit pas nécessairement de la dernière version en date d'un modèle. En outre, toute version autre que la version active est considérée comme une ébauche ou une version archivée d'un modèle. Cela signifie que vous ne pouvez utiliser que la version active d’un modèle dans les messages que vous créez à l’aide de la console Amazon Pinpoint.

Par exemple, vous pouvez créer plusieurs versions d'un modèle lors de sa conception et de son développement. Lorsque la dernière version du modèle est terminée et approuvée pour utilisation dans les messages, vous pouvez désigner cette version comme étant la version active du modèle. Vous pouvez ensuite utiliser cette version active du modèle dans les messages. Si vous décidez ultérieurement de modifier le modèle, vous pouvez créer des versions supplémentaires pour ces modifications, sans affecter la version active du modèle ou les messages existants qui utilisent le modèle. 

Parmi les différentes versions d'un modèle, une doit être désignée comme la version active du modèle. Un modèle évoluant au fil du temps, vous pouvez désigner une version différente comme version active, et vous pouvez changer cette désignation plusieurs fois. 

### Paramètres de version des messages
<a name="message-templates-versioning-overview-versions-messages"></a>

Pour utiliser une version spécifique d’un modèle dans un message, celle-ci doit être la version active du modèle lorsque vous créez le message ou lors de l’envoi du message par Amazon Pinpoint. Cela dépend de la façon dont vous configurez un message pour qu'il utilise un modèle. Lorsque vous créez un message et que vous choisissez un modèle pour celui-ci, deux options s'offrent à vous :
+ **Utiliser la version active** : si vous choisissez cette option, Amazon Pinpoint envoie toujours le même contenu et les mêmes paramètres de message, comme spécifié dans la version du modèle qui est active lorsque vous créez le message. Cela signifie que le message reste le même, quelles que soient les modifications que vous apportez ultérieurement au modèle.
+ **Utiliser la version active au moment de l’envoi du message** : si vous choisissez cette option, Amazon Pinpoint met automatiquement à jour le contenu et les paramètres du message pour que celui-ci corresponde à la version active du modèle lors de l’envoi du message. Cela signifie que le message change si vous désignez une version différente comme version active après avoir créé le message.

Par exemple, si vous procédez comme suit :

1. Créez la *version 1* d'un modèle. 

1. Désignez la *version 1* comme version active du modèle.

1. Créez un message qui utilise le modèle et planifiez l'envoi de ce message ultérieurement.

1. Modifiez le modèle plusieurs fois.

1. Désignez une nouvelle version (*version 5*) comme version active du modèle.

Amazon Pinpoint effectue les opérations suivantes pour chaque option lorsqu’il envoie le message :
+ **Utiliser la version active** : si vous avez choisi cette option pour le message, Amazon Pinpoint utilise le contenu et les paramètres spécifiés par la *version 1* du modèle. La raison en est que la *version 1* était la version active du modèle au moment de la création du message.
+ **Utiliser la version active au moment de l’envoi du message** : si vous avez choisi cette option pour le message, Amazon Pinpoint le met automatiquement à jour pour utiliser le contenu et les paramètres spécifiés par la *version 5* du modèle. La raison en est que la *version 5* est la version active du modèle au moment de l'envoi du message.

Si vous souhaitez vous assurer que les modifications apportées à un modèle n'affectent pas les messages existants que vous n'avez pas encore envoyés, nous vous recommandons de configurer vos messages de manière à utiliser la version du modèle active lorsque les messages sont créés, et non pas envoyés. Néanmoins, si vous souhaitez continuer à développer un modèle après avoir commencé à l'utiliser dans les messages, vous pouvez [créer une copie du modèle](message-templates-managing-copy.md), puis modifier et utiliser la copie du modèle dans les nouveaux messages.

## Affichage des versions d'un modèle de message
<a name="message-templates-versioning-view-versions"></a>

En utilisant la page **Modèles de message** vous pouvez rechercher et ouvrir rapidement un modèle de message spécifique. Vous pouvez ensuite afficher la liste des versions existantes du modèle. Dans cette liste, vous pouvez choisir une version spécifique pour en afficher le contenu et les paramètres.

**Pour afficher les versions d'un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Dans la page **Message templates (Modèles de message)** choisissez le modèle dont vous souhaitez afficher les versions. La page du modèle s'ouvre et affiche des informations le concernant. Sont également présentés le contenu et les paramètres de la version active du modèle.

1. Sous **Template details (Détails du modèle)**, ouvrez le sélecteur de version pour afficher la liste des versions du modèle.

1. Pour afficher le contenu et les paramètres d'une version spécifique, utilisez le sélecteur de version pour choisir cette dernière. Lorsque vous avez sélectionné une version, Amazon Pinpoint affiche le contenu et les paramètres de cette version du modèle.

## Affichage de la version active d'un modèle de message
<a name="message-templates-versioning-view-active"></a>

Vous pouvez afficher la version active d'un modèle de message de deux façons : lorsque vous créez un message qui utilise le modèle, et en utilisant la page **Message templates (modèles de message)**. Pour afficher la version active d’un modèle lors de la création d’un message, choisissez le modèle correspondant au message. Amazon Pinpoint affiche automatiquement un aperçu de la version active du modèle. 

Pour afficher la version active d'un modèle à l'aide de la page **Message templates (modèles de message)** suivez la procédure indiquée dans cette rubrique.

**Pour afficher la version active d'un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sur la page **Message templates (modèles de message)** choisissez le modèle dont vous souhaitez afficher la version active. La page du modèle s'ouvre et affiche des informations le concernant. Sont également présentés le contenu et les paramètres de la version active du modèle. Sous **Détails du modèle**, notez que **ACTIVE VERSION (VERSION ACTIVE)** s'affiche (en vert) en regard du nom de la version dans le sélecteur de version.

1. Pour afficher une version différente du modèle, utilisez le sélecteur de version sous **Template details (Détails du modèle)** pour choisir la version souhaitée. Pour afficher à nouveau la version active, utilisez le sélecteur de version pour choisir la version qui affiche **ACTIVE VERSION (VERSION ACTIVE)** (en vert) en regard du nom de la version.

## Désignation de la version active d'un modèle de message
<a name="message-templates-versioning-set-active"></a>

Lorsque vous créez un modèle de message, Amazon Pinpoint désigne automatiquement la première version du modèle comme étant la version active. Lorsque vous créez et développez des versions ultérieures d'un modèle, vous pouvez désigner une version différente comme version active, et vous pouvez changer cette désignation plusieurs fois.

Avant de désigner une version comme version active d'un modèle, il est conseillé de vérifier que l'ensemble du contenu et des paramètres de la version active proposée sont complets et prêts à être utilisés.

Il est également judicieux de vérifier que les différences entre les versions actives actuelles et proposées n'affecteront pas les messages existants de manière inattendue ou non souhaitée. Si vous définissez une version différente comme version active, Amazon Pinpoint peut appliquer votre modification aux messages existants qui utilisent le modèle et qui n’ont pas encore été envoyés. Cela dépend de la façon dont vous avez configuré les messages qui utilisent le modèle. Pour de plus amples informations, veuillez consulter [Paramètres de version des messages](#message-templates-versioning-overview-versions-messages).

Si le modèle est utilisé dans des messages qui n'ont pas encore été envoyés, comparez la version active en cours à la version que vous souhaitez activer. En outre, vérifiez les activités de parcours et les campagnes qui utilisent le modèle. Ensuite, modifiez le modèle, le cas échéant, pour résoudre les problèmes que vous trouvez, avant de désigner une autre version comme active.

Si vous êtes inquiet des conséquences de la désignation d'une version différente comme version active, vous pouvez [créer une copie du modèle](message-templates-managing-copy.md) à la place. Vous pouvez ensuite modifier et utiliser cette copie dans les nouveaux messages.

**Pour désigner la version active d'un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Dans la page **Message templates (Modèles de message)** choisissez le modèle pour lequel vous souhaitez désigner la version active. La page du modèle s'ouvre et affiche des informations le concernant. Sont également présentés le contenu et les paramètres de la version active en cours du modèle. 

1. Sous **Template details (Détails du modèle)**, utilisez le sélecteur de version pour choisir la version que vous souhaitez désigner comme version active. Lorsque vous avez sélectionné une version, Amazon Pinpoint affiche le contenu et les paramètres de cette version du modèle.

1. Choisissez **Make active version (Rendre cette version active)**.

La nouvelle version active du modèle peut désormais être utilisée dans les nouveaux messages. Elle est également utilisée dans tous les messages existants qui n'ont pas encore été envoyés et qui sont configurés de sorte à utiliser la version du modèle qui est active au moment de l'envoi du message.

## Modification de la version active d'un modèle de message
<a name="message-templates-versioning-edit-active"></a>

Avant de modifier la version active d’un modèle, il est important de ne pas oublier que seule la version active d’un modèle peut être utilisée dans les messages que vous créez à l’aide de la console Amazon Pinpoint. C'est pourquoi il est conseillé de vérifier d'abord que vos modifications sont complètes et prêtes à l'emploi.

Il est également conseillé de vérifier que vos modifications n’affecteront pas les messages existants de manière inattendue ou indésirable. Amazon Pinpoint peut appliquer vos modifications aux messages existants qui utilisent le modèle et qui n’ont pas encore été envoyés. Cela dépend de la façon dont vous avez configuré les messages qui utilisent le modèle. Pour de plus amples informations, veuillez consulter [Paramètres de version des messages](#message-templates-versioning-overview-versions-messages).

Pour déterminer l'incidence que vos modifications peuvent avoir sur les messages existants, vérifiez le contenu et les paramètres de la version active du modèle. En outre, vérifiez les activités de parcours et les campagnes qui utilisent le modèle. Examinez ensuite les modifications que vous prévoyez d'apporter et assurez-vous qu'elles correspondent aux objectifs que vous avez définis pour les messages existants qui utilisent le modèle. 

Enfin, si vous êtes inquiet des conséquences de la désignation d'une version différente comme version active, vous pouvez [créer une copie du modèle](message-templates-managing-copy.md) à la place. Vous pouvez ensuite modifier et utiliser cette copie dans les nouveaux messages que vous créez ensuite.

**Pour modifier la version active d'un modèle de message**

1. Ouvrez la console Amazon Pinpoint à l'adresse. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Dans le panneau de navigation, choisissez **Message templates (Modèles de message)**.

1. Sur la page **Message templates (Modèles de message)** choisissez le modèle dont vous souhaitez modifier la version active. La page du modèle s'ouvre et affiche des informations le concernant. Sont également présentés le contenu et les paramètres de la version désignée comme active du modèle. 

1. Choisissez **Modifier**.

1. Sous **Détails du modèle**, utilisez le sélecteur de version pour vous assurer que vous modifiez bien la version active du modèle. **ACTIVE VERSION (VERSION ACTIVE)** s'affiche (en vert) en regard du nom de la version active. 

1. Effectuez les modifications souhaitées, puis choisissez **Save as new version (Enregistrer en tant que nouvelle version)**.

1. Sous **Template details (Détails du modèle)**, utilisez le sélecteur de version pour choisir la version du modèle que vous avez créée à l'étape précédente.

1. Choisissez **Make active version (Rendre cette version active)**.

La nouvelle version active du modèle peut désormais être utilisée dans les nouveaux messages. Elle est également utilisée dans tous les messages existants qui n'ont pas encore été envoyés et qui sont configurés de sorte à utiliser la version du modèle qui est active au moment de l'envoi du message.