n8n

O n8n pode ficar na frente do Letlink de três formas diferentes. Webhooks e API REST funcionam no Growth e no Ultimate. O nó MCP Client exige o Ultimate. A página no app é Integrações → n8n; ela mostra seu token e a URL do MCP, mesmo que você já conheça a documentação da API.

1. Gatilho de webhook (Growth e Ultimate)

1. No n8n, adicione um nó Webhook. Mude para POST, modo de produção, e copie a URL de produção.
2. Cole essa URL em Integrações → Webhooks no Letlink.
3. Cada clique registrado chega como o objeto JSON link_visited. Mapeie link_shortcode, visitor_variation, utm_campaign e assim por diante nos nós seguintes.

Este é o padrão certo para “quando alguém clicar, faça X” — adicionar uma linha no Airtable, avisar outro espaço de trabalho do Slack, enriquecer o IP, abrir um chamado.

2. HTTP Request (Growth e Ultimate)

Use o nó HTTP Request do n8n em https://letl.ink/api/v1. Defina o cabeçalho X-API-KEY com o token de Integrações → n8n. Chamadas típicas:

• GET /auth/me — teste de conexão.
• GET /links?domain=letl.ink — inventário e totais de cliques.
• POST /links com JSON — crie um link curto a partir de um formulário, um CRM ou uma linha de planilha.
• GET /visits — busque os 50 cliques mais recentes periodicamente se não quiser um webhook de envio.

GET https://letl.ink/api/v1/links?domain=letl.ink
Header: X-API-KEY = YOUR_TOKEN

3. MCP Client (Ultimate)

Aponte o nó MCP Client do n8n para o Streamable HTTP https://letl.ink/mcp com Authorization: Bearer YOUR_TOKEN. As ferramentas são as mesmas que Claude e ChatGPT veem: workspace_summary, list_links, get_link, get_recent_visits, create_link. Use quando um workflow deve *fazer perguntas* ao espaço de trabalho em vez de interpretar o JSON da API REST por conta própria.

Qual escolher