Integraciones
n8n
Tres formas de conectarse: disparador de webhook, HTTP Request contra la API REST o el nodo MCP Client.
n8n puede conectarse con Letlink de tres formas distintas. Los webhooks y la API REST funcionan en Growth y Ultimate. El nodo MCP Client requiere Ultimate. La página de la app es Integraciones → n8n; muestra tu token y la URL de MCP aunque ya conozcas la documentación de la API.
1. Disparador de webhook (Growth y Ultimate)
- En n8n, agrega un nodo Webhook. Cámbialo a POST, modo producción, y copia la URL de producción.
- Pega esa URL en Integraciones → Webhooks de Letlink.
- Cada clic registrado llega como el objeto JSON
link_visited. Asignalink_shortcode,visitor_variation,utm_campaign, etc. a los nodos siguientes.
Es la opción predeterminada adecuada para “cuando alguien haga clic, haz X”: agregar una fila en Airtable, avisar en otro espacio de trabajo de Slack, enriquecer la IP, abrir un ticket.
2. HTTP Request (Growth y Ultimate)
Usa el nodo HTTP Request de n8n contra https://letl.ink/api/v1. Define el encabezado X-API-KEY con el token de Integraciones → n8n. Llamadas habituales:
GET /auth/me: prueba de conexión.GET /links?domain=letl.ink: inventario y totales de clics.POST /linkscon JSON: crea un enlace corto desde un formulario, un CRM o una fila de una hoja de cálculo.GET /visits: obtén los últimos 50 clics de forma programada si no quieres un webhook de envío.
GET https://letl.ink/api/v1/links?domain=letl.ink
Header: X-API-KEY = YOUR_TOKEN
3. MCP Client (Ultimate)
Apunta el nodo MCP Client de n8n a Streamable HTTP https://letl.ink/mcp con Authorization: Bearer YOUR_TOKEN. Las herramientas son las mismas que ven Claude y ChatGPT: workspace_summary, list_links, get_link, get_recent_visits, create_link. Úsalo cuando un workflow deba *hacerle preguntas* al espacio de trabajo en lugar de analizar el JSON de la REST por sí mismo.
Cuál elegir
| Cargo | Usar |
|---|---|
| Reacciona a un clic en tiempo real | Nodo Webhook |
| Informe nocturno o sincronización de inventario | HTTP Request en /links o /visits |
| Crear enlaces desde otro sistema | HTTP Request POST /links |
| Permite que un agente revise el uso y cree un enlace | MCP Client en Ultimate |