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)

  1. En n8n, agrega un nodo Webhook. Cámbialo a POST, modo producción, y copia la URL de producción.
  2. Pega esa URL en Integraciones → Webhooks de Letlink.
  3. Cada clic registrado llega como el objeto JSON link_visited. Asigna link_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 /links con 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.
Listar enlaces desde un nodo HTTP Request
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

¿Todavía tienes preguntas?

Estamos aquí para ayudarte. Escríbenos y te responderemos lo antes posible.