Accédez à la section “Destinations” du projet où vous souhaitez publier les documents.

Cliquez sur “Nouvelle destination” (ou “Add destination”). Choisissez le type : Webhook (HTTP) ou E‑mail.

Pour un webhook : saisissez l’URL destinataire, la méthode HTTP (POST, GET, etc.), et l’option “Active” pour activer l’envoi.
Pour un e‑mail : indiquez les adresses destinataires séparées par des virgules, le sujet par défaut et l’expéditeur optionnel.

Choisissez le type d’authentification : Aucun, Basic, Bearer/OAuth2, ou API key.

• Basic : fournissez nom d’utilisateur et mot de passe (le système générera l’en‑tête Authorization).
• Bearer/OAuth2 : collez le token d’accès si requis.
• API key : choisissez emplacement (en‑tête ou querystring), nom et valeur.

Ajoutez des en‑têtes HTTP personnalisés si nécessaire (ex : X‑Company: myapp). Pour les webhooks, vous pouvez aussi ajouter des paramètres de requête supplémentaires.

Si le destinataire demande une signature, indiquez le secret et le nom de l’en‑tête de signature. Le système calculera un HMAC du payload avec l’algorithme sélectionné et l’ajoutera à la requête.

Définissez un template de payload : soit une structure JSON avec tokens (ex. {{ title }} ou {{ generated_content }}), soit une chaîne libre. Assurez‑vous que le template aboutit à un JSON valide si vous envoyez du JSON.

Configurez le timeout (secondes), le nombre de retries et la stratégie de backoff (attente entre tentatives). Ces réglages contrôlent la durabilité des tentatives d’envoi.

Enregistrez la destination. Utilisez le bouton “Tester” pour envoyer un document de test et vérifier la requête/réponse.

Si vous avez une configuration réutilisable, enregistrez‑la comme modèle et dupliquez‑la pour chaque projet en adaptant seulement les paramètres nécessaires.

Lancer le test depuis la fiche de la destination génère une requête de test et affiche le résultat.

Téléchargez ou affichez la requête de test (URL, headers, body). Vérifiez que l’URL, les en‑têtes d’authentification et le body sont conformes aux attentes du destinataire.

Contrôlez le code HTTP et le corps de la réponse. Un code 2xx indique généralement le succès. Notez le texte ou le JSON renvoyé pour diagnostics.

Corrigez les en‑têtes, le token, le payload_template ou la signature en fonction des erreurs observées et retestez.

Quand le test est concluant, assurez‑vous que la destination est active et prête à recevoir de vrais documents.

Depuis la liste des documents, ouvrez le document que vous souhaitez envoyer.

Dans le panneau d’actions, choisissez “Envoyer”, puis sélectionnez la destination souhaitée dans la liste déroulante.

Vérifiez les options (destinataires e‑mail supplémentaires, override du sujet, ou variante du template), puis confirmez.

Le système déclenche l’envoi. Un message de succès s’affiche si la livraison a été acceptée ou un message d’erreur en cas d’échec immédiat.

Accédez au suivi/diagnostic de l’envoi pour voir le code HTTP, la réponse et les tentatives. Si nécessaire, ré‑envoyez manuellement après correction.

Sélectionnez la destination de type e‑mail ou entrez les adresses manuellement si l’interface le permet.

Saisissez un sujet explicite. Si vous avez un alias d’expéditeur configuré (inbound alias), vous pouvez l’utiliser pour le from.

Vérifiez le rendu HTML si un modèle HTML est utilisé. Assurez‑vous que les images et liens sont valides et accessibles.

Validez l’envoi et inspectez la boîte de réception (ou les journaux SMTP) pour confirmer la réception. Si l’e‑mail n’arrive pas, contrôlez le relais SMTP et les en‑têtes.

En cas de rebond, consultez le log pour l’erreur SMTP : adresse invalide, quota atteint, ou blocage par le fournisseur. Corrigez et renvoyez.

Éditez le hook qui déclenche les documents (push, schedule, etc.).

Dans la section de routage de sortie, choisissez la destination précédemment configurée.

Enregistrez la configuration et assurez‑vous que le hook est actif pour que les générations futures déclenchent l’envoi.

Utilisez la fonction de prévisualisation pour générer un document de test et vérifier que l’envoi automatique fonctionne correctement.

Consultez régulièrement les logs d’exécution du hook pour détecter les erreurs répétées et ajuster les paramètres (timeouts, retries).

Le paramètre ‘retries’ définit combien de tentatives seront effectuées en cas d’échec. Exemple : retries = 3 → jusqu’à 4 tentatives au total (tentative initiale + 3 relances).

Le timeout définit la durée maximale d’attente pour une réponse avant d’abandonner la tentative et passer à la suivante.

Le backoff définit l’attente entre tentatives. Une approche courante est le backoff linéaire (ex. 10s, 20s, 30s) ou exponentiel. Ajustez selon la sensibilité du destinataire.

En général, les erreurs réseau, timeouts ou codes HTTP 5xx entraînent des retries. Les erreurs 4xx (mauvaise requête, auth rejetée) sont souvent considérées comme non récupérables et ne déclenchent pas de retry prolongé.

Si toutes les tentatives échouent, l’événement apparaît comme échec final dans les logs. Programmez des alertes pour surveiller ces échecs critiques.