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

  1. Settings → Community Nodes dans n8n
  2. Cliquez sur Install a community node
  3. Saisissez n8n-nodes-qyvo
  4. 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 serveurhttps://www.qyvo.io/mcp
  • En-tête d'authentificationAuthorization: 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 Received
  • New Campaign Sent
  • New Flow Triggered
  • New 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.