Envois : automatique et manuel
Envois : automatique et manuel
Sous-page — Notifications & Emails
Guide complet sur le processus d’envoi des résultats d’agents (automatique) et les options d’envoi manuel depuis l’interface (DialogDocument).
Ce que couvre cette page
Envoi automatique
Envoi d’emails déclenché automatiquement à l’exécution d’un agent vers les adresses configurées.
Envoi manuel depuis DialogDocument
Envoyer un output d’agent depuis le dialogue de document : choisir destinataires, format et prévisualiser avant envoi.
Formats d'email
Support HTML stylisé (template généré) et fallback texte/HTML simple pour compatibilité maximale.
Expéditeur personnalisé
Si votre projet a une adresse inbound configurée, l’email peut être envoyé depuis l’alias projet (ex : Projet key@votredomaine).
Contrôle des destinataires
Sélection ciblée : adresses configurées, membres du projet ou adresses manuelles en saisie libre.
Quotas & limites
Les envois utilisent votre infrastructure SMTP et peuvent être soumis à des quotas (SMTP ou crédits projet).
Avant de commencer
Ce guide explique : 1) ce qui se passe quand un agent s’exécute et envoie automatiquement son output par email ; 2) comment envoyer manuellement un document depuis l’interface (DialogDocument) ; 3) choix de format, sélection des destinataires et points de contrôle.
Flux 1 — Pré-requis : vérifier la configuration d’envoi (SMTP et alias de projet)
Vérifier la configuration SMTP (prérequis) — workflow étape par étape
Étape 1 : Accéder aux paramètres d'envoi
Ouvrez la page Paramètres > Intégrations ou la section Administration où sont gérées les options d’email. Recherchez les paramètres SMTP ou “Serveur d’envoi”.
Étape 2 : Vérifier l'adresse d'expéditeur du projet (optionnel)
Si votre projet utilise un alias (adresse inbound ou clé projet), confirmez que la valeur est renseignée (ex. clé inbound). Cet alias sera utilisé comme expéditeur affiché si présent.
Étape 3 : Valider un envoi test
Utilisez la fonctionnalité de test d’email (si disponible) pour envoyer un message à une adresse de test. Vérifiez réception, rendu HTML et en-têtes (From / Reply‑To).
Étape 4 : Vérifier quota et crédits
Contrôlez les quotas SMTP et l’état des crédits de votre projet (si applicable). Les envois automatiques ou massifs peuvent consommer des crédits ou être bloqués par le fournisseur SMTP.
Étape 5 : Documenter les adresses de rebond
Notez l’adresse d’expéditeur (reply-to) et la politique de rebond (bounces) de votre fournisseur SMTP afin d’éviter des pertes d’emails.
Tip — Envoyez d'abord à une adresse interne
Pour éviter d’éventuels problèmes de rendu ou de filtrage anti-spam, testez toujours un envoi vers une adresse interne (mail pro) avant d’ouvrir l’envoi aux destinataires finaux.
Flux 2 — Envoi automatique lors de l’exécution d’un agent
Exécution d'un agent → envoi automatique d'email
Étape 1 : Configurer le déclencheur de l'agent (hook ou exécution manuelle)
Dans l’interface où vous créez/éditez l’agent, activez le mode d’envoi automatique ou ajoutez un hook/schedule qui déclenchera l’agent. Choisissez la fréquence ou le trigger (push, horaire, manuel).
Étape 2 : Choisir les destinataires configurés
Dans les paramètres du hook / agent, sélectionnez les destinataires : liste d’emails configurée pour le projet, membres du projet ou une liste d’adresses personnalisée. Assurez-vous que la liste n’est pas vide.
Étape 3 : Définir le format d'email par défaut
Choisissez si l’email doit être envoyé en HTML stylisé (template généré) ou en texte simple/fallback. Le format HTML fournit un rendu riche ; le texte se montre plus compatible.
Étape 4 : Lancer l'exécution
Déclenchez l’agent (manuellement ou attendez le trigger). À la fin du run, si l’option d’envoi est activée, le système prépare l’email.
Étape 5 : Génération du contenu et template
Le contenu généré est inséré dans un template : entête (projet, agent, date), contenu stylisé (Markdown → HTML), et pied de page (lien / signature). Si le template riche échoue, un template simple/no-frills est utilisé en fallback.
Étape 6 : Envoi via la configuration SMTP
L’envoi est réalisé via le serveur d’envoi configuré. L’expéditeur affiché peut être l’alias projet si renseigné ; sinon l’adresse par défaut de l’intégration.
Étape 7 : Vérifier les logs et les retours
Après envoi, consultez les journaux d’exécution et les notifications pour confirmer que l’email a bien été transmis ou pour obtenir les erreurs renvoyées (ex : rejet SMTP, quotas).
Étape 8 : Actions après échec
Si l’envoi échoue (quota dépassé, adresse invalide, erreur SMTP), le système doit signaler l’erreur. Corrigez la configuration SMTP, la liste de destinataires, ou attendez le reset du quota avant de relancer.
Tip — Priorisez les destinataires critiques
Pour les envois automatisés fréquents (ex : rapports journaliers), n’envoyez qu’aux destinataires réellement concernés afin de limiter la consommation de crédits et le risque d’alerte spam.
Limite importante
Les envois automatiques sont soumis aux quotas du fournisseur SMTP et peuvent aussi consommer des crédits du projet. Si vous prévoyez des envois volumineux ou fréquents, planifiez l’augmentation de quota ou une stratégie d’envoi progressive.
Flux 3 — Envoi manuel depuis DialogDocument (relecture / partage ponctuel)
Envoyer manuellement un document depuis DialogDocument
Étape 1 : Ouvrir le document (DialogDocument)
Depuis l’interface des outputs ou du log d’exécution, ouvrez le document que vous souhaitez partager en cliquant sur le bouton d’aperçu / modifier (ouvre le DialogDocument).
Étape 2 : Choisir l'option d'envoi
Dans le dialog, cliquez sur l’action “Partager” ou “Envoyer par email” (libellé selon l’UI). Le panneau d’envoi s’ouvre et propose plusieurs cibles.
Étape 3 : Sélectionner les destinataires
- Sélectionnez une destination prédéfinie (liste d’adresses configurée pour le projet).
- OU sélectionnez des membres du projet.
- OU saisissez des adresses manuelles séparées par des virgules.
Validez la liste et corrigez les erreurs d’orthographe d’adresses avant d’envoyer.
Étape 4 : Définir le sujet et le format
Modifiez le sujet si nécessaire. Choisissez le format d’envoi : HTML stylisé (prévisualisation disponible) ou texte simple. Pour compatibilité maximale, choisissez texte si vos destinataires utilisent des clients très stricts.
Étape 5 : Prévisualiser
Avant d’envoyer, utilisez la prévisualisation HTML pour vérifier le rendu (titres, styles, tableaux, badges). Si le rendu est incorrect, basculez sur le template simple.
Étape 6 : Envoyer
Cliquez sur “Envoyer”. L’interface affichera une confirmation de succès ou un message d’erreur. Conservez la trace de l’envoi dans les logs ou l’historique du document si disponible.
Étape 7 : Vérifier réception
Demandez à un destinataire de confirmer la réception et le rendu. En cas d’erreur, corrigez l’adresse, changez de format ou vérifiez la configuration SMTP.
Étape 8 : Relancer en cas d'échec
S’il y a un rejet (bounce) ou une erreur, éditez la liste de destinataires, corrigez le contenu ou attendez la résolution du quota avant de retenter.
Tip — Utilisez la prévisualisation pour les tableaux et badges
Les contenus riches (tableaux, badges, couleurs) peuvent être tronqués par certains clients. Prévisualisez en HTML et testez avec une adresse représentative des destinataires finaux.
HTML stylisé
- Rendu riche : titres, couleurs, tableaux, badges.
- Meilleure expérience pour destinataires webmail.
- Peut être filtré ou altéré par certains systèmes anti-spam.
::column
Texte simple (fallback)
- Très compatible (tous clients).
- Taille réduite, pas de styles.
- Priorisez pour notifications à large diffusion. ::: :::
Pour rapports périodiques ou notifications opérationnelles : limitez la fréquence, vérifiez quotas, utilisez listes restreintes. Programmez des backoffs en cas d’erreurs SMTP répétées.
Gotcha — contenus très volumineux
Les contenus extrêmement longs peuvent dépasser les limites d’un provider SMTP ou être tronqués. Si le document est très volumineux, préférez : 1) envoyer un extrait + lien vers l’interface ; 2) envoyer en plusieurs messages ou 3) fournir un fichier téléchargeable via le site.
Scénarios d’erreur courants et actions recommandées
- SMTP non configuré / informations invalides : vérifiez la page d’intégration et réalisez un test d’envoi.
- Destinataire invalide ou rejet (bounce) : corrigez l’adresse et relancez.
- Quota SMTP dépassé : contactez votre fournisseur SMTP ou planifiez des envois répartis.
- Template HTML mal rendu : basculez sur le template simple et corrigez la structure Markdown.
Tip — Journalisez et archivez les envois importants
Conservez une copie de l’output envoyé (historique du document ou export JSON/Markdown) pour traçabilité et pour ré-envoyer si besoin sans relancer la génération.
Frequently Asked Questions
Checklist rapide avant production
- SMTP testé et validé.
- Alias/expéditeur projet configuré si nécessaire.
- Destinataires vérifiés (liste courte pour tests).
- Prévisualisation HTML effectuée.
- Quotas et crédits vérifiés.
- Plan de secours (template simple ou lien vers le document) prêt.
Besoin d'aide pour configurer vos envois ?
Si vous avez besoin d’assistance, commencez par la page d’intégrations pour tester votre SMTP et gérer les alias projet.