Connecter n8n
Utilisez le n8n-nodes-qyvo community node, ou câblez le nœud MCP Client directement. Les deux sont pris en charge.
n8n offre deux façons d'utiliser Qyvo : le community node (recommandé), ou le nœud générique MCP Client pointé sur qyvo.io/mcp.
Option A — Community node (recommandé)
n8n-nodes-qyvo est le community node officiel Qyvo, approuvé sur n8n le 2026-05-06. Il expose les triggers et les actions en tant que nœuds n8n natifs, avec des listes déroulantes au niveau des champs (sélecteur de template, sélecteur de tag, sélecteur de contact) — bien plus convivial que MCP brut pour les workflows visuels.
Le nœud d'action est usableAsTool: true, vous pouvez donc le chaîner directement sous le nœud AI Agent de n8n. L'agent traite chaque action comme un outil, sans câblage MCP nécessaire.
Installation
- Settings → Community Nodes dans n8n
- Cliquez sur Install a community node
- Saisissez
n8n-nodes-qyvo - Confirmez — n8n télécharge depuis npm, redémarre le worker, et les nœuds Qyvo apparaissent dans l'éditeur
Si votre n8n est verrouillé (plan cloud sans community nodes, ou self-hosted avec N8N_COMMUNITY_PACKAGES_ENABLED=false), utilisez l'Option B.
Configurer les credentials
La première fois que vous déposez un nœud Qyvo sur un canvas, n8n demande des credentials :
- Name — n'importe quoi (p. ex.
Qyvo prod) - API token — collez votre jeton d'accès personnel Qyvo
Le community node utilise les mêmes endpoints REST /api/v1/* documentés dans API REST — même authentification, même portée.
Utiliser sous l'AI Agent
Déposez un nœud AI Agent, puis ajoutez un nœud Qyvo Action en tant qu'outil. L'agent lit la description de l'action et l'invoque de manière autonome en fonction de la conversation. N'importe quel fournisseur LLM pris en charge par n8n (OpenAI, Anthropic, Mistral, local) fonctionne.
Option B — Nœud MCP Client générique
n8n livre un nœud MCP Client qui parle MCP brut sur HTTP. Pointez-le sur Qyvo :
- URL du serveur —
https://www.qyvo.io/mcp - En-tête d'authentification —
Authorization: Bearer YOUR_TOKEN_HERE
Cela vous donne le catalogue complet de 35 outils (plus riche que le community node, qui expose les 15 actions les plus courantes). Utilisez-le quand vous voulez chaque outil MCP — create_segment, import_contacts, etc.
Quand utiliser l'un ou l'autre
| Scénario | Choix |
|---|---|
| Workflow visuel, listes déroulantes de champs souhaitées | Community node |
| AI Agent qui doit piloter Qyvo de manière conversationnelle | Community node (chaque action est usableAsTool) |
| Besoin de chaque outil MCP (incluant segments, imports, analytiques) | Nœud MCP Client |
| Self-hosted sans paquets community autorisés | Nœud MCP Client |
Triggers de polling
Le community node expose également les quatre nœuds trigger construits sur /api/v1/triggers/* :
New Message ReceivedNew Campaign SentNew Flow TriggeredNew Sequence Triggered
Ils font du polling sur une planification (1 min par défaut) et dédupliquent par id. Utilisez plutôt un webhook (voir Webhooks) si vous avez besoin de livraison en temps réel.
