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

1

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

2

É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.

3

É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).

4

É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.

5

É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

1

É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).

2

É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.

3

É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.

4

É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.

5

É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.

6

É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.

7

É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).

8

É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

1

É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).

2

É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.

3

É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.
4

É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.

5

É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.

6

É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.

7

É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.

8

É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.

Pour partage ponctuel d’un output : usez de la prévisualisation, ajustez le sujet et envoyez à une liste restreinte ou à des reviewers.

Pour alertes critiques, envoyez en HTML si le design aide la lecture, mais doublez souvent par un canal alternatif (Slack, SMS) si possible.

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.