Usar Elido no n8n auto-hospedado

O n8n é uma ferramenta de automação de workflows auto-hospedada. O community node do Elido oferece triggers e ações nativas dentro do editor visual do n8n — sem necessidade de nós HTTP Request.

Requisitos#

• n8n versão 0.220 ou superior (community nodes requerem esse mínimo).
• n8n auto-hospedado com instalação de community nodes habilitada. Planos de nuvem do n8n podem restringir isso — verifique seu plano.
• Um token de API de workspace do Elido.

Etapa 1 — Instalar o community node#

1. No n8n, vá para Settings → Community Nodes.
2. Clique em Install a community node.
3. Cole o nome do pacote:

   @elidoapp/n8n-nodes-elido
   

4. Concorde com o aviso de risco e clique em Install.
5. O n8n reinicia. Após o reinício, pesquise "Elido" no seletor de nós — você deve ver os nós de trigger e ação do Elido.

Etapa 2 — Gere um token de API do Elido#

1. No Elido, vá para Dashboard → API Keys → New key.
2. Escolha os escopos com base no que seu workflow precisa:
   • links:read — pesquisar e listar links.
   • links:write — criar e atualizar links.
   • analytics:read — ler contagens de cliques e analytics.
3. Copie o token. Começa com ek_.

Etapa 3 — Adicionar credenciais do Elido no n8n#

1. No n8n, vá para Credentials → New Credential → Elido API.
2. Cole o token no campo API Token.
3. O workspace é detectado automaticamente a partir do token. Clique em Save.

Você pode criar múltiplas credenciais (uma por workspace do Elido) e referenciá-las em nós individuais.

Triggers disponíveis#

Trigger	Quando é acionado
Link Clicked	Cada clique em qualquer link no workspace (ou filtrado por tag/slug)
Conversion Recorded	Toda vez que uma conversão é registrada
Threshold Exceeded	Quando a contagem de cliques de um link ultrapassa o número configurado

Os triggers usam o sistema de webhooks do Elido internamente. O n8n registra a URL do webhook automaticamente quando você ativa o workflow.

Ações disponíveis#

Ação	O que faz
Create Link	Cria um novo link curto
Update Link	Atualiza URL de destino, slug, tags ou expiração
List Links	Retorna uma lista paginada de links com filtros
Look Up Link	Encontra um link por slug ou ID
Get Analytics	Retorna contagem de cliques e detalhamento para um link

Workflow de exemplo — registrar cliques no Baserow#

Este workflow é acionado a cada clique e escreve uma linha em uma tabela do Baserow (uma alternativa auto-hospedada ao Airtable, comum em configurações n8n).

[Elido Trigger: Link Clicked]
      ↓
[Baserow: Create Row]
  - Table: "Click Log"
  - Slug: {{ $json.slug }}
  - Country: {{ $json.country }}
  - Device: {{ $json.device }}
  - Clicked At: {{ $json.clicked_at }}

Para configurar:

1. Arraste o trigger Elido para o canvas. Selecione a credencial. Defina o tipo de trigger como "Link Clicked".
2. Arraste um nó Baserow. Conecte-o. Configure sua base e tabela do Baserow.
3. Mapeie os campos como mostrado acima.
4. Clique em Activate workflow.

Workflow de exemplo — criar um link a partir de um webhook#

Um padrão mais simples: um sistema externo faz POST de uma URL para o n8n, o n8n a encurta com o Elido e retorna a URL curta.

[Webhook node: POST /shorten]
      ↓
[Elido Action: Create Link]
  - Destination URL: {{ $json.body.url }}
  - Tag: {{ $json.body.tag }}
      ↓
[Respond to Webhook]
  - Body: { "short_url": "{{ $json.short_url }}" }

Solução de problemas#

Community node não aparece após a instalação — O n8n precisa de um reinício completo após instalar community nodes. Se você estiver executando n8n no Docker, reinicie o container:

docker restart n8n

"Invalid credentials" ao testar um nó — O token de API está incorreto ou com escopo incorreto. Regenere um token com os escopos que seu workflow precisa e atualize a credencial do n8n.

Trigger não está sendo acionado — Verifique se o workflow está ativo (o toggle no canto superior direito do editor de workflow). Workflows inativos não registram webhooks, então o Elido nunca envia eventos.

URL do webhook rejeitada pelo Elido — A URL do webhook do n8n deve ser acessível da internet (ou dos servidores do Elido). Se você estiver executando o n8n em uma máquina local ou rede privada, configure um túnel (ex: Cloudflare Tunnel, ngrok) e configure WEBHOOK_URL nas variáveis de ambiente do n8n para apontar para o endereço do túnel.