Erreur sur un connecteur

Un connector en échec arrête souvent le run entier. Cette page t’aide à lire l’erreur, corriger la configuration et éviter les effets de bord en double.

1. Lire le run et le node en erreur

Ouvre Runs (historique d’exécution) pour le workflow concerné.
Sélectionne le run en Échec.
Identifie le node rouge : le message d’erreur et la sortie masquée (secrets non affichés) s’y trouvent.

Les détails techniques sensibles sont filtrés ; tu vois le type d’erreur (HTTP 401, permission Dolibarr, timeout, etc.).

2. Causes fréquentes par famille

Dolibarr

Permission manquante sur l’objet (lecture, création, suppression).
fk_soc ou identifiant invalide pour l’entité courante.
Objet verrouillé ou brouillon non validé.

HTTP / Webhook

URL incorrecte, certificat TLS, ou pare-feu sortant.
En-têtes ou corps de requête mal formés (JSON invalide).
Réponse 4xx / 5xx : consulte le code et le corps renvoyé dans le run.

Email

SMTP non configuré sur l’instance (souvent désactivé sur la démo partagée).
Identifiants SMTP expirés ou port bloqué.

AI

Credential manquant, expiré ou clé API révoquée.
Quota provider dépassé ou modèle indisponible.

Logic

Branche If sans chemin par défaut.
Boucle ou délai mal paramétré.

3. Retry et idempotence

Knot peut retry certaines erreurs transitoires (réseau, 503).
Pour les actions qui créent des données (facture, tiers), active l’idempotence quand le connecteur le supporte, afin qu’un retry ne duplique pas l’effet.

4. Escalade

Situation	Action
Erreur reproductible en Simulate	Corrige la config du node avant d’activer en prod.
Erreur intermittente	Vérifie timeout, charge serveur, limites API tierces.
Erreur après mise à jour Knot	Consulte le CHANGELOG et reteste un workflow minimal.

Voir aussi

Performances et limites — si l’erreur ressemble à un timeout ou une saturation.
Le workflow ne s’exécute pas — si aucun run n’apparaît.