Accédez au document que vous souhaitez exporter depuis la liste ou l’éditeur et ouvrez la vue détaillée.

Cliquez sur “Export Markdown” ou “Export JSON” selon le format désiré. Vérifiez que le contenu affiché correspond bien à ce que vous attendez (titres, sections, métadonnées).

Avant de lancer l’export, contrôlez : la langue, le rendu des images, la présence de champs obligatoires et la taille estimée. Si le document contient images ou pièces jointes volumineuses, notez leur taille.

Cliquez sur le bouton d’export. Le fichier est généré côté navigateur et le navigateur déclenche le téléchargement. Attendez la notification de succès ou l’apparition d’une erreur.

Ouvrez le fichier téléchargé pour vérifier l’encodage, la complétude et l’absence de caractères tronqués. Si JSON, validez la structure ; si Markdown, vérifiez les liens et images.

Si le téléchargement ne démarre pas : essayez d’actualiser la page, testez avec un autre navigateur, ou réduisez la taille du document (supprimez images temporaires) et recommencez. Consultez les logs de l’interface pour tout message d’erreur.

Dans la boîte de dialogue d’envoi, sélectionnez la destination souhaitée dans la liste (webhook, service tiers, e‑mail). Vérifiez que la destination active possède les bonnes informations d’authentification et d’en-têtes.

Contrôlez le mode d’authentification configuré (clé, Basic, Bearer, signature). Assurez-vous que la clé/token est valide, non expiré, et a les droits nécessaires chez le destinataire.

Vérifiez le modèle de payload (payload_template) : champs requis, format JSON/URL-encoded, et champs de signature. Préparez un exemple concret pour la destination.

Cliquez sur “Send”. L’interface affichera le statut de l’envoi (succès / erreur). Notez le code de réponse et le message d’erreur éventuel.

Si l’envoi échoue mais que la destination est configurée avec des retries, attendez et suivez le journal des tentatives. Les retries respectent la politique définie (nombre, intervalle).

Vérifiez côté destinataire que le payload a bien été reçu et traité. Comparez le payload réel avec le template attendu et corrigez les différences.

Collectez le log d’envoi (code HTTP, body de réponse, timestamp, durée). Testez manuellement le payload avec l’outil de destination (console de webhook, simulateur) et ajustez l’auth ou les headers.

Ouvrez la fenêtre de prévisualisation, définissez les filtres (dates, agents, branches, tags) pour restreindre l’ensemble à un échantillon représentatif.

Cliquez sur “Preview documents”. L’outil retournera un exemple de documents correspondant aux filtres : inspectez plusieurs éléments pour vérifier la consistance.

Pour chaque document aperçu, examinez le payload tel qu’il serait envoyé : structure, champs manquants, encodage, contenu HTML/Markdown.

Si des champs manquent ou sont mal formatés, modifiez le template de payload puis relancez la prévisualisation jusqu’à obtention d’un résultat conforme.

Avant mise en production, effectuez un envoi de test vers une destination de staging pour vérifier l’intégration complète (auth, headers, parsing côté destinataire).

Séparez les erreurs transitoires (timeout, 5xx, rate limit) des erreurs permanentes (401, 403, 400, validation). Appliquez retries seulement aux erreurs transitoires.

Privilégiez un backoff exponentiel avec jitter pour la plupart des destinations publiques. Définissez un nombre maximal d’essais et un délai total maximal.

Lorsqu’une action peut être reprise, utilisez une clé idempotente unique pour éviter les duplications côté destinataire.

Configurez des alertes pour les échecs répétés et un tableau de bord des taux d’erreur par destination.

Simulez des latences et interruptions côté destinataire pour valider que la stratégie de retry ne provoque pas de sursaut de trafic.

Horodatage, identifiant du document, destinataire choisi, taille du payload, template utilisé.

Code HTTP, en-têtes de réponse, body de réponse (message d’erreur), latence mesurée.

Si l’export est côté client, récupérer la console du navigateur et l’instantané du téléchargement (erreurs JS, out-of-memory).

Combien de tentatives ont été effectuées et à quels horaires — cela montre si les retries ont aidé ou aggravé.

Reproduisez l’envoi avec le même payload vers un destinataire de test pour observer le comportement sans impacter la prod.

Vérifiez si l’erreur indiquait un timeout côté client ou une réponse longue du destinataire. Notez la durée avant l’échec.

Effectuez un envoi vers la destination depuis un réseau proche (ou outil de test) pour mesurer RTT et variation.

Si possible, testez avec une version allégée du payload (sans pièces jointes/media) pour voir si le problème vient du transfert.

Augmentez légèrement le timeout et utilisez backoff exponentiel si l’origine est temporaire.

Si la latence persiste, demandez au destinataire s’il y a des limites de débit, maintenance ou problèmes internes.

Assurez-vous que la clé/token n’a pas expiré ni été révoqué et qu’il correspond au type d’auth attendu (Bearer, Basic, signature).

Contrôlez l’en-tête Authorization et autres headers requis ; certains services exigent un préfixe exact ou un header personnalisé.

Utilisez l’interface de test du destinataire (ou un outil de requête) pour vérifier que les mêmes informations d’auth fonctionnent.

Si la réponse contient un message précis (ex. “token invalid”, “signature mismatch”), ajustez la méthode d’auth ou la signature.

Si nécessaire, régénérez les clés dans un environnement sécurisé et mettez à jour la destination en suivant la procédure d’activation recommandée.

Avant export/envoi, vérifiez la taille totale des médias et du document. Beaucoup de navigateurs ont des limites et certains destinataires aussi.

Fractionnez en plusieurs exports ou hébergez les fichiers volumineux (stockage objet) et envoyez des liens dans le payload au lieu d’inclure les binaires.

Compressez images et médias (optimisation d’images, minification) pour réduire la charge réseau.

Simulez l’envoi des fichiers volumineux vers l’environnement de staging pour vérifier le comportement et la reprise après échec.

Évitez les retries agressifs sur gros transferts : définissez des règles pour ne pas répéter les uploads complet sans reprise (ou support de reprise côté destinataire).