n8n-nodes-snaplogs

Community node n8n pour SnapLogs — feedback visuel, bugs, events et logs agents.

Package npm : n8n-nodes-snaplogs
Docs : snaplogs.pro/docs/integrations/n8n

Installation (community node)

C’est le chemin officiel. Pas de npm install à la main.

1. Ouvre n8n (Cloud ou self-hosted avec community nodes activés).
2. Va dans Settings → Community nodes (Paramètres → Community nodes).
3. Clique Install.
4. Dans le champ npm, saisis exactement : n8n-nodes-snaplogs
5. Valide, puis Install.
6. Attends la fin de l’install. Les nodes SnapLogs et SnapLogs Trigger apparaissent dans le panel.

Mise à jour

1. Settings → Community nodes
2. Sur n8n-nodes-snaplogs, clique Update
3. Relance un workflow de test (credential + Health check)

Si n8n affiche The specified package does not contain any nodes, le package npm est trop vieux (avant 0.1.1). Clique Update.

Credential

Après install : Credentials → Add credential → SnapLogs API

| Champ | Valeur | |---|---| | API Key | Clé projet dans app.snaplogs.pro → Settings → API Keys (sk_…) | | Endpoint | https://app.snaplogs.pro (sans slash final) |

Header envoyé : x-snaplogs-key. Le test appelle GET /api/v1/project — une fausse clé échoue (contrairement à /health, public).

Nodes

SnapLogs (action)

| Resource | Operation | Endpoint | |---|---|---| | Feedback | Create | POST /api/v1/feedbacks | | Feedback | Get | GET /api/v1/feedbacks/:id | | Feedback | List | GET /api/v1/feedbacks | | Feedback | Update | PATCH /api/v1/feedbacks/:id | | Event | Ingest | POST /api/v1/events | | Log | Ingest | POST /api/v1/logs | | Log | Import | POST /api/v1/logs/import (max 500) | | Project | Get | GET /api/v1/project | | Health | Check | GET /api/v1/health |

Log · Import : pour un gros volume (export n8n, fichier JSON/NDJSON, items du workflow).
Coche Use Incoming Items pour mapper chaque item (message / msg / text / error).
Décoche pour coller un tableau JSON ou un dump texte.

SnapLogs Trigger

• Webhook — SnapLogs POST feedback.created, feedback.status_changed, agent.error, n8n.execution_failed
• Poll — GET /feedbacks périodique, dédoublonnage interne. À utiliser si SnapLogs ne peut pas joindre n8n.

Scenarios utiles

1. Health → vérifie la credential
2. Log · Import + items d’un Read File / Code → historise un export
3. Trigger webhook feedback.created → Slack / Linear / Notion
4. Log · Ingest en fin de workflow n8n (une ligne à la fois)

Côté SnapLogs : Capturer → n8n pour brancher l’instance, sync les exécutions en erreur, et importer un fichier de logs.

Self-hosted (hors community panel)

Uniquement si le panel community nodes est désactivé :

cd ~/.n8n/custom
npm install n8n-nodes-snaplogs

Puis redémarrer n8n. Préférer le panel Install dès qu’il est dispo.

License

MIT © BOVO Digital