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)
- Dans n8n, ajoutez un nœud Webhook. Passez-le en POST, en mode production, et copiez l'URL de production.
- Collez cette URL dans Letlink sous Intégrations → Webhooks.
- Chaque clic enregistré arrive sous forme d'objet JSON
link_visited. Associezlink_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 /linksavec 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.
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 |