Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Communication

Modèles d'e-mail

Créez des modèles d'e-mail réutilisables et associez-les à des types de documents spécifiques pour ne proposer que les modèles pertinents lors de l'envoi d'un message.

Un Modèle d'e-mail prépare un message type : confirmation de commande, relance de facture, accusé de réception. Vous le choisissez dans la fenêtre d'envoi d'un document. Dokos remplit alors le sujet et le message avec les données du document.

Prérequis

  • Le rôle Utilisateur bureau pour créer et utiliser des modèles.

Créer un modèle d'e-mail

Consultez les modèles d'e-mail dans la démo
  1. Ouvrez la recherche (Ctrl+K), saisissez Modèle d'e-mail, puis cliquez sur Créer un·e Modèle d'e-mail.
  2. Donnez un nom explicite au modèle, par exemple Confirmation de commande client.
  3. Rédigez le Sujet et la Réponse (le corps du message). Utilisez des variables Jinja pour les données du document (voir ci-dessous).
  4. Cochez Utiliser le HTML pour écrire le corps en HTML au lieu de l'éditeur de texte.
  5. Renseignez le DocType de référence si le modèle ne sert qu'à un type de document.
  6. Enregistrez.

Limiter un modèle à un type de document

Le champ DocType de référence est optionnel.

Valeur du champOù le modèle apparaît
(vide)Dans la fenêtre d'e-mail de tous les documents
Commande clientUniquement dans la fenêtre d'e-mail des commandes client
Facture de venteUniquement dans la fenêtre d'e-mail des factures de vente

Exemple

Exemple fictif : Maison Verte SARL utilise trois modèles.

  • Bienvenue générale : sans DocType de référence. Il apparaît sur tous les documents.
  • Confirmation de commande : DocType de référence Commande client.
  • Relance facture impayée : DocType de référence Facture de vente.

Alice ouvre la fenêtre d'e-mail sur une commande client. Elle voit Bienvenue générale et Confirmation de commande. Relance facture impayée n'apparaît pas.

Utiliser un modèle lors d'un envoi d'e-mail

  1. Ouvrez le document depuis lequel vous souhaitez envoyer un e-mail.
  2. Ouvrez la fenêtre d'envoi d'e-mail, par exemple depuis l'activité du document.
  3. Cliquez sur Utiliser un modèle (libellé non traduit) dans la ligne Sujet. Seuls les modèles compatibles avec ce type de document s'affichent.
  4. Sélectionnez le modèle. Le sujet et le message sont remplis.

Voir aussi Compositeur d'email. 5. Ajustez si nécessaire, puis cliquez sur Envoyer.

Utiliser les variables Jinja dans un modèle

Le modèle est compilé avec Jinja. Les champs du document s'écrivent directement par leur nom, sans le préfixe doc. : {{ name }}, {{ grand_total }}. Pour trouver le nom d'un champ, ouvrez Personnaliser un formulaire sur le type de document.

Exemple pour une commande client :

Sujet : Confirmation de votre commande {{ name }}

Bonjour {{ contact_display }},

Nous avons bien enregistré votre commande {{ name }}
du {{ transaction_date }} pour un montant de {{ grand_total }} €.

Cordialement,
L'équipe Maison Verte SARL

Avec Utiliser le HTML, les variables {{ email_signature }} et {{ email_footer }} insèrent la signature et le pied de page du compte e-mail d'envoi.

Si le modèle utilise des champs propres à un type de document, par exemple delivery_date sur une commande, renseignez le DocType de référence. Sinon, le modèle apparaît sur des documents qui n'ont pas ces champs, et la variable s'affiche telle quelle dans le message ({{ delivery_date }}).

Flux de sélection d'un modèle

En savoir plus