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ôme | Cause | Que faire |
|---|---|---|
set DB_PASSWORD in .env au démarrage | mots de passe de la base de données manquants | compléter .env |
mailbox … has no access yet | la 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 compte | l’organisation n’a pas de client dans la carte Connexion des comptes et des boîtes mail | un propriétaire de l’organisation en ajoute un – voir Microsoft 365 ou Google Workspace, client de l’organisation |
Graph … 401 … invalid_client | client secret erroné ou expiré | un nouveau secret au niveau de l’inscription, puis le test de connexion |
Graph … 403 … AppOnly AccessPolicy | la stratégie d’accès de l’application n’a pas encore pris effet, ou la boîte mail n’est pas dans le groupe | attendre (parfois des heures), refaire le test ; ajouter la boîte mail au groupe |
Graph … 403 … ErrorAccessDenied | consentement de l’administrateur manquant | dans Entra, Grant admin consent au niveau de l’inscription |
Category not added … MailboxSettings | l’autorisation MailboxSettings.ReadWrite manque ; l’étiquetage fonctionne, mais sans couleur | ajouter l’autorisation et donner le consentement |
No active assistant in the database | l’assistant est désactivé, ou les données initiales n’ont pas été créées | activer l’assistant ; consulter le journal de démarrage |
| l’assistant est ignoré (« no prompts yet ») | l’assistant n’a pas de consignes rédigées | terminer la mise en route, ou rédiger les consignes à la main |
| l’échantillon de la mise en route indique trop peu de données | le 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 siennes | ajouter 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 domains | le brouillon a échoué à un contrôle | examiner le message – il peut s’agir d’une tentative d’usurpation |
Limit reached | la limite journalière ou par expéditeur | ne l’augmenter que si l’afflux d’e-mails est légitime |
Model refused to answer | le filtre de sécurité du modèle | traiter le message à la main |
Model exhausted max_iterations | le modèle a tourné en boucle dans ses outils | deux nouvelles tentatives sont faites ; si l’erreur revient, ajuster la consigne Tâche |
ECONNREFUSED … 3306 | la base de données est arrêtée ou pas encore démarrée | docker 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 rien | la 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émarrage | une 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 web | Docker 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 erreur | la nouvelle version n’est pas devenue saine ; la précédente continue de servir | l’erreur dans Demandes ou dans la sortie de ./draften update ; ./draften status |
| le service web renvoie 502 après un redémarrage du serveur | les 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 pas | dans 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ées | le dump de la base de données a échoué (le message figure dans la carte) ; une nouvelle tentative a lieu une heure plus tard | lancer ./draften backup et lire l’erreur ; vérifier l’espace disque libre (df -h) et ./draften status |
Quand le journal ne suffit pas
- L’interface : Paramètres de l’assistant → Activité (relèves du courrier, demandes, événements) et la page Exploitation (workers, file d’attente, erreurs des dernières 24 heures).
- Après trois tentatives infructueuses, un message reçoit le statut en échec ; la dernière erreur figure dans son détail.
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.