Intégrations

n8n

Trois points d'entrée : déclencheur webhook, HTTP Request vers l'API REST, ou le nœud MCP Client.

n8n peut se placer devant Letlink de trois façons différentes. Les webhooks et l'API REST fonctionnent sur Growth et Ultimate. Le nœud MCP Client nécessite Ultimate. La page dans l'application est Intégrations → n8n ; elle affiche votre jeton et l'URL MCP même si vous connaissez déjà la documentation de l'API.

1. Déclencheur Webhook (Growth et Ultimate)

  1. Dans n8n, ajoutez un nœud Webhook. Passez-le en POST, en mode production, et copiez l'URL de production.
  2. Collez cette URL dans Letlink sous Intégrations → Webhooks.
  3. Chaque clic enregistré arrive sous forme d'objet JSON link_visited. Associez link_shortcode, visitor_variation, utm_campaign, etc. aux nœuds suivants.

C'est le bon choix par défaut pour « quand quelqu'un clique, faire X » — ajouter une ligne dans Airtable, notifier un autre espace de travail Slack, enrichir l'IP, ouvrir un ticket.

2. Requête HTTP (Growth et Ultimate)

Utilisez le nœud HTTP Request de n8n vers https://letl.ink/api/v1. Définissez l'en-tête X-API-KEY avec le jeton issu de Intégrations → n8n. Appels typiques :

  • GET /auth/me — test de connexion.
  • GET /links?domain=letl.ink — inventaire et totaux de clics.
  • POST /links avec du JSON — créez un lien court depuis un formulaire, un CRM ou une ligne de tableur.
  • GET /visits — récupérez régulièrement les 50 derniers clics si vous ne voulez pas de webhook push.
Lister les liens depuis un nœud HTTP Request
GET https://letl.ink/api/v1/links?domain=letl.ink
Header: X-API-KEY = YOUR_TOKEN

3. Client MCP (Ultimate)

Configurez le nœud MCP Client de n8n en Streamable HTTP sur https://letl.ink/mcp avec Authorization: Bearer YOUR_TOKEN. Les outils sont les mêmes que ceux que voient Claude et ChatGPT : workspace_summary, list_links, get_link, get_recent_visits, create_link. Utilisez cette méthode lorsqu'un workflow doit *interroger* l'espace de travail plutôt qu'analyser lui-même le JSON REST.

Lequel choisir

Poste Utiliser
Réagir à un clic en temps réel Nœud Webhook
Rapport nocturne ou synchronisation d'inventaire HTTP Request sur /links ou /visits
Créer des liens depuis un autre système HTTP Request POST /links
Laisser un agent examiner l'utilisation et créer un lien MCP Client sur Ultimate

Vous avez encore des questions ?

Nous sommes là pour vous aider. Contactez-nous et nous vous répondrons dès que possible.