Pour les administrateurs
← Tous les sujets

Résolution des problèmes

Symptôme, cause et que faire – de l’accès manquant à une boîte mail jusqu’au secret expiré.

D’abord, la vue d’ensemble depuis le répertoire d’installation :

./draften status      # version, état des deux couleurs du web et des workers, HTTPS, dumps de la base

Puis plus en détail :

docker compose ps                        # les services tournent-ils, la base de données est-elle saine ?
docker compose logs --tail 50 worker     # les dernières entrées du worker
docker compose run --rm worker node diag.mjs mailbox@company.com

La dernière commande fait la même chose que Tester la connexion dans l’interface : elle prend l’accès enregistré pour la boîte mail, obtient un jeton, affiche ses autorisations (jamais le jeton lui-même) et lit la boîte de réception.

Erreurs courantes

SymptômeCauseQue faire
set DB_PASSWORD in .env au démarragemots de passe de la base de données manquantscompléter .env
mailbox … has no access yetla boîte mail n’a ni inscription ni compte connectépage de la boîte mail → Accès aux e-mails
« L’organisation n’a pas de client Microsoft 365 ou Google configuré » lors de la connexion d’une boîte mail avec le comptel’organisation n’a pas de client dans la carte Connexion des comptes et des boîtes mailun propriétaire de l’organisation en ajoute un – voir Microsoft 365 ou Google Workspace, client de l’organisation
Graph … 401 … invalid_clientclient secret erroné ou expiréun nouveau secret au niveau de l’inscription, puis le test de connexion
Graph … 403 … AppOnly AccessPolicyla stratégie d’accès de l’application n’a pas encore pris effet, ou la boîte mail n’est pas dans le groupeattendre (parfois des heures), refaire le test ; ajouter la boîte mail au groupe
Graph … 403 … ErrorAccessDeniedconsentement de l’administrateur manquantdans Entra, Grant admin consent au niveau de l’inscription
Category not added … MailboxSettingsl’autorisation MailboxSettings.ReadWrite manque ; l’étiquetage fonctionne, mais sans couleurajouter l’autorisation et donner le consentement
No active assistant in the databasel’assistant est désactivé, ou les données initiales n’ont pas été crééesactiver l’assistant ; consulter le journal de démarrage
l’assistant est ignoré (« no prompts yet »)l’assistant n’a pas de consignes rédigéesterminer la mise en route, ou rédiger les consignes à la main
l’échantillon de la mise en route indique trop peu de donnéesle propriétaire répondait auparavant depuis une autre adresse (par exemple avant un changement de domaine), et la mise en route ne compte pas ces réponses comme les siennesajouter l’adresse dans le champ Autres adresses de la boîte mail (à côté de l’échantillon, à l’étape Période, ou sur la page de la boîte mail) et sélectionner de nouveau l’échantillon ; l’adresse complète, pas seulement le domaine
Draft without signature / links outside the allowed domainsle brouillon a échoué à un contrôleexaminer le message – il peut s’agir d’une tentative d’usurpation
Limit reachedla limite journalière ou par expéditeurne l’augmenter que si l’afflux d’e-mails est légitime
Model refused to answerle filtre de sécurité du modèletraiter le message à la main
Model exhausted max_iterationsle modèle a tourné en boucle dans ses outilsdeux nouvelles tentatives sont faites ; si l’erreur revient, ajuster la consigne Tâche
ECONNREFUSED … 3306la base de données est arrêtée ou pas encore démarréedocker compose ps, docker compose logs db
le bandeau « La licence a expiré » ou « L’installation n’a pas de licence », les assistants ne rédigent rienla licence manque ou a expiréimporter une licence valable – voir La licence
le service web est indisponible un court instant et les requêtes en cours sont perdues ; le journal du service web (docker compose logs web-blue web-green) montre un redémarrageune requête a dépassé la limite stricte de mémoire de PHP (depuis PHP 8.5.12, le double de memory_limit) et PHP a arrêté tout le processus webDocker relance le service web de lui-même, en général en quelques dizaines de secondes ; si cela se répète, repérer dans le journal la requête qui a dépassé la limite
une mise à jour s’est terminée par une erreurla nouvelle version n’est pas devenue saine ; la précédente continue de servirl’erreur dans Demandes ou dans la sortie de ./draften update ; ./draften status
le service web renvoie 502 après un redémarrage du serveurles versions antérieures au 30 octobre 2026 basculaient le service web d’une manière qui faisait considérer le proxy par Docker comme arrêté à la main ; après un redémarrage de la machine, Docker ne le relançait donc pasdans le répertoire d’installation, docker compose up -d --no-deps proxy ; une mise à jour vers la version du 30 octobre 2026 ou plus récente règle le problème durablement
« La dernière sauvegarde quotidienne a échoué » dans la carte Sauvegardes de la base de donnéesle dump de la base de données a échoué (le message figure dans la carte) ; une nouvelle tentative a lieu une heure plus tardlancer ./draften backup et lire l’erreur ; vérifier l’espace disque libre (df -h) et ./draften status

Quand le journal ne suffit pas

Un passage ponctuel à la main

docker compose run --rm worker node worker.mjs --dry-run

Cette commande passe une fois sur chaque assistant actif en forçant le mode d’essai – rien n’est écrit dans la boîte mail. Utile pour vérifier que tout fonctionne.

Quand vous avez besoin de notre aide

./draften diagnose

crée un fichier diagnose-<heure>.tar.gz contenant l’état de l’installation, les versions, la configuration sans les secrets et la fin des journaux. Envoyez-le-nous.

Avant d’envoyer le fichier, regardez son contenu : les journaux peuvent contenir des adresses et des objets des e-mails traités. Rien ne quitte le serveur de soi-même.

Version texte