Templates d'email d'agents
Templates d'email d'agents
Comment sont générés, quels éléments ils contiennent et comment gérer le fallback vers un mode simple
Explication complète des templates HTML/texte envoyés par les Agents — configuration, réception automatique, envoi manuel et bonnes pratiques.
Fonctionnalités couvertes
Envoyer des emails d'outputs
Envoyer automatiquement le contenu généré par un agent (HTML + texte) aux adresses configurées pour un AgentHook.
Templates générés automatiquement
Un template HTML stylisé est généré pour chaque envoi ; un template simple est utilisé en fallback si nécessaire.
Envoi manuel depuis l'interface
Possibilité d’envoyer manuellement un document par email depuis la vue de document/dialogue pour tester ou diffuser un résultat.
Introduction Ce guide explique, pas à pas, comment les emails produits par les Agents sont générés, quel est leur format (HTML riche vs texte simple), comment configurer les destinataires et l’expéditeur, et comment le système gère un fallback vers un template simple lorsque le rendu HTML n’est pas compatible ou si nécessaire. Il détaille également les étapes pour envoyer manuellement et pour vérifier/tester les envois.
Configurer les emails de sortie (AgentHook)
Ouvrir le dialogue de création/modification d'un AgentHook
Accédez au projet concerné, ouvrez la section Hooks / Schedulers et lancez la création ou la modification d’un AgentHook.
Activer l'option d'envoi par email
Dans le formulaire du hook, repérez l’option “Envoyer les outputs par email” (is_output_emailed) et activez-la.
Renseigner les adresses de destination
Saisissez une ou plusieurs adresses dans le champ prévu (output_emails). Utilisez des virgules pour séparer plusieurs adresses. Vérifiez l’orthographe et privilégiez listes restreintes (équipe produit, destinataires autorisés).
Configurer la fréquence et sauvegarder
Ajustez la fréquence/exécution du hook (cron, planification) si nécessaire puis enregistrez le hook. Un hook actif déclenchera l’envoi automatique lors de chaque exécution produisant un output.
Tester la configuration
Après sauvegarde, utilisez la fonctionnalité de prévisualisation/test (si disponible) ou lancez une exécution manuelle de l’agent pour vérifier que les emails arrivent bien.
Conseil de configuration
Quand vous entrez plusieurs destinataires, privilégiez des alias de groupe (ex: devs@…) pour faciliter la gestion des destinataires et éviter d’exposer des adresses individuelles.
Réception automatique lors de l'exécution d'un agent
Exécution de l'Agent déclenche l'envoi
Quand l’Agent s’exécute via le hook configuré et produit un output, le système tente d’envoyer un email aux adresses configurées immédiatement après la persistance du résultat.
Sélection du template
Le système génère d’abord un template HTML optimisé pour email (template complet). Si le contenu ou le contexte empêche l’envoi HTML, un fallback vers un template simple (mode texte/HTML basique) est utilisé.
Contenu et sujet de l'email
Sujet : format standard incluant le nom du projet et le titre de l’output (ex. “MonProjet • Titre du résultat”). Corps : HTML riche (si possible) + texte brut en fallback. Le contenu envoyé correspond exactement au texte généré par l’agent.
Expéditeur utilisé
Par défaut l’expéditeur est le compte SMTP configuré. Si le projet dispose d’une clé d’email entrante configurée, l’adresse d’expédition peut être construite depuis le nom du projet (pour un alias lisible).
Suivi et erreurs
Si l’envoi échoue (problème SMTP, adresses invalides), une alerte/erreur est logguée pour vous permettre d’enquêter et relancer l’envoi si nécessaire.
Attention — données sensibles
Les emails transitent par des serveurs SMTP et peuvent être lus par les destinataires. Évitez d’envoyer des secrets, clés API ou données personnelles sensibles sans chiffrement supplémentaire.
Envoyer manuellement depuis DialogDocument (prévisualisation & envoi)
Ouvrir le document ou la sortie à envoyer
Dans la vue du document généré (ou DialogDocument), ouvrez le menu d’actions pour le document que vous souhaitez partager.
Choisir 'Envoyer par email'
Sélectionnez l’option d’envoi par email. L’interface propose généralement de choisir entre les destinataires sauvegardés (output_emails) ou d’entrer une liste personnalisée.
Prévisualiser l'email
Avant d’envoyer, utilisez la prévisualisation pour vérifier le rendu HTML (titre, mise en forme, code, tableaux). Si le rendu ne vous satisfait pas, optez pour l’envoi en mode simple (texte ou template simple) si l’option est fournie.
Envoyer et vérifier
Validez l’envoi. Vérifiez la boîte du/des destinataire(s) pour confirmer le rendu, puis corrigez le document si nécessaire et renvoyez.
Relancer en cas d'échec
Si l’email ne passe pas, vérifiez les adresses, quotas SMTP, et la longueur du message (très longs contenus peuvent poser problème). Relancez après correction.
Bonnes pratiques d'envoi manuel
Envoyez d’abord à une adresse de test avant diffusion à toute l’équipe. Vérifiez l’affichage dans plusieurs clients (Gmail, Outlook, mobile) si le rendu visuel est important.
Structure du template HTML généré (à connaître)
En-tête visuel
Le template complet comprend un en-tête avec le logo, une “badge date” et un bloc titre. Le premier mot du titre est mis en évidence pour attirer l’œil.
Badge Agent et meta
Si applicable, une petite pastille indique le nom de l’Agent qui a généré le contenu (ex: “🤖 Agent: SEO-Writer”) et le nom du projet figure en footer.
Corps converti depuis Markdown
Le contenu textuel est converti depuis le texte/Markdown produit par l’agent en HTML, puis des styles inline sont appliqués pour assurer compatibilité avec la majorité des clients email (titres, listes, code bloc, blockquote, tableaux, badges thématiques).
Pied de page
Footer simple indiquant “Généré automatiquement par DeployIt” et, si renseigné, le nom du projet. L’adresse d’expédition suit la configuration du projet/SFTP.
Accessibilité et compatibilité
Les styles sont appliqués inline et des ajustements spécifiques (tables pour les séparateurs, blocs sombre pour le code, etc.) sont intégrés pour maximiser la compatibilité (Gmail, Outlook, Apple Mail).
Le template HTML riche contient :
- En-tête avec logo et date.
- Titre avec premier mot mis en valeur.
- Badge Agent (si présent).
- Corps HTML issu du Markdown: titres, listes, tableaux, blocs code stylés.
- Footer projet & lien DeployIt.
Utilisé par défaut lorsque le client accepte HTML. Avantage : rendu élégant et lisible, structuration du contenu.
Avant (Template complet)
- Rendu riche, clair pour équipes non techniques.
- Supporte tableaux, badges, code formaté.
- Idéal pour rapports, changelogs, résumés.
Après (Fallback simple)
- Rendu minimaliste, universellement compatible.
- Moins d’impact visuel mais plus sûr pour clients stricts.
- Recommandé pour notifications SMS-to-email ou destinataires limités.
Limites et erreurs fréquentes
- Taille excessive : très longs documents peuvent être tronqués ou rejetés par certains serveurs.
- Destinataires invalides provoquent l’échec d’envoi : vérifiez les adresses avant d’enregistrer.
- Clients email peuvent supprimer styles : accepter une légère différence d’apparence entre clients (Outlook vs Gmail).
Sur l'expéditeur (From) et deliverability
Si vous voulez un expéditeur lié au projet (ex: projet@votredomaine), configurez l’alias d’envoi projet/inbound_email; vérifiez SPF/DKIM/DMARC pour éviter que les messages n’atterrissent en spam.
Que faire si un email ne s'affiche pas correctement (diagnostic rapide)
Vérifier le destinataire et la boîte de réception
Confirmez que l’adresse est correcte et regardez les dossiers “spam” / “promotions”.
Prévisualiser le HTML dans l'interface
Ouvrez la prévisualisation du document avant envoi pour repérer contenu malformé (balises non fermées, images externes bloquées).
Forcer le mode simple (si disponible)
Si l’interface propose l’option, renvoyez en mode simple / texte brut ; sinon corrigez le contenu (supprimer HTML non standard, réduire longueur).
Tester avec une adresse différente
Envoyez à une adresse de test (ex: Gmail et Outlook) pour comparer le rendu et identifier si le problème est côté client ou côté envoi.
Consulter les logs d'envoi
Si l’envoi a échoué, consultez les logs et messages d’erreur pour comprendre l’origine (quota SMTP, rejet pour SPAM, auth).
Frequently Asked Questions
Prêt à tester vos templates d'email ?
Utilisez la prévisualisation et un envoi test pour valider rendu et expéditeur avant diffusion à toute l’équipe.