Use o Elido no n8n auto-hospedado

O n8n é uma ferramenta de automação de workflows auto-hospedada. O community node do Elido oferece ações nativas dentro do editor visual do n8n, então você não precisa construir manualmente nós HTTP Request contra a API do Elido.

Requisitos

• n8n auto-hospedado com community nodes habilitados. Planos de nuvem do n8n podem restringir community nodes; verifique seu plano.
• Uma API key de workspace do Elido.

Etapa 1 - Instale o community node

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

   n8n-nodes-elido
   

4. Concorde com o aviso de risco e clique em Install.
5. Pesquise "Elido" no seletor de nós. O nó Elido aparece com o resource Link.

Etapa 2 - Crie uma API key do Elido

1. No Elido, vá para Settings → API keys → New key.
2. Escolha uma role para a key. Editor pode criar links e ler analytics; Viewer só pode ler links e analytics. Uma key pertence ao workspace em que foi criada e não pode agir em nenhum outro workspace.
3. Copie a key. Ela começa com elido_ e é exibida uma única vez.

Tokens por escopo (links:write, analytics:read e assim por diante) estão planejados; hoje é a role que define o que uma key pode fazer.

Etapa 3 - Adicione as credenciais do Elido no n8n

1. No n8n, vá para Credentials → New Credential → Elido API.
2. Base URL: deixe https://api.elido.app para o Elido Cloud, ou informe a raiz da sua API auto-hospedada.
3. API Token: cole a key elido_.
4. Workspace ID: o ID numérico do workspace ao qual a key pertence (Settings → Workspace). O nó o usa para analytics.
5. Clique em Save. O n8n testa a credencial lendo esse workspace, então uma key errada, uma base URL errada ou uma key de outro workspace falha aqui em vez de em um workflow em execução.

Crie uma credencial por workspace do Elido e escolha a correta em cada nó.

Ações disponíveis

Ação	O que faz
Create	Encurta uma URL de destino. Slug, título, tags, expiração, status de redirecionamento e domain ID opcionais
Get	Retorna um link pelo ID
List	Retorna até 100 links, mais recentes primeiro, filtrados por texto de busca, tags ou status (active/disabled)
Get Analytics	Retorna cliques ao longo do tempo, ou cliques por país, referrer, dispositivo ou navegador, para um link

Create sem um Domain ID coloca o link no domínio padrão do Elido do seu workspace. Para usar um domínio personalizado, informe o ID dele em Settings → Domains.

List e Get Analytics retornam um item do n8n por linha, então o próximo nó roda uma vez por link ou uma vez por dia, país, referrer e assim por diante. Get Analytics usa por padrão os últimos 30 dias; defina From e To (YYYY-MM-DD) para mudar a janela.

Update Link e Look Up Link by slug são ações planejadas. Até serem lançadas, chame PATCH /v1/links/{id} ou GET /v1/links?q=<slug> a partir de um nó HTTP Request com a mesma credencial.

Triggers

Um nó dedicado Elido Trigger está planejado. Até ser lançado, use o trigger Webhook nativo do n8n com um endpoint de webhook do Elido:

1. Adicione um nó Webhook (método POST) e copie a URL de produção dele.
2. No Elido, vá para Settings → Webhooks → New endpoint, cole a URL e escolha os eventos: link.created, link.updated, link.deleted, link.expired, link.cap_reached ou link.broken.
3. Copie o signing secret. Cada entrega carrega um header X-Elido-Signature: v1=<hex>, um HMAC-SHA256 de {timestamp}.{raw body} com esse secret, onde o timestamp é o valor em segundos Unix em X-Webhook-Timestamp; verifique-o em um nó Code antes de confiar no payload. O guia de webhooks tem o snippet de verificação.

Trigger	Status
Link criado, atualizado, excluído, expirado, quebrado, limite de clique atingido	Disponível hoje através do nó Webhook
Link Clicked	Planejado. Precisa do evento de webhook click.created, que ainda não é emitido
Conversion Recorded	Planejado, após a API de conversões
Threshold Exceeded	Planejado

Workflow de exemplo - relatório diário de cliques para uma planilha

[Schedule Trigger: every day 08:00]
      ↓
[Elido: Get Analytics]
  - Link ID: 4711
  - Report: Clicks by Country
      ↓
[Google Sheets: Append Row]
  - Country: {{ $json.key }}
  - Clicks: {{ $json.count }}

Workflow de exemplo - criar um link a partir de um webhook

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: Create]
  - Destination URL: {{ $json.body.url }}
  - Tags: {{ $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 - recarregue o editor. Se ainda estiver faltando, reinicie o n8n; no Docker:

docker restart n8n

O teste da credencial falha com 404 ou 403 - o Workspace ID não corresponde ao workspace em que a key foi criada, ou a key foi revogada. Verifique os dois em Settings → API keys do Elido.

Create falha com "domain_id" - o Domain ID não é um domínio deste workspace. Deixe-o vazio para usar o domínio padrão.

Get Analytics não retorna nada - o link não tem cliques na janela, ou o Link ID pertence a outro workspace. Amplie From e To primeiro.

URL do webhook rejeitada pelo Elido - a URL do webhook do n8n precisa ser acessível pela internet. Se você roda o n8n em uma máquina local ou em uma rede privada, configure um túnel (por exemplo, Cloudflare Tunnel ou ngrok) e aponte a variável de ambiente WEBHOOK_URL do n8n para o endereço do túnel.