Usar Elido en n8n auto-hospedado

n8n es una herramienta de automatización de workflows auto-hospedada. El community node de Elido te da acciones nativas dentro del editor visual de n8n, así que no tienes que construir a mano nodos HTTP Request contra la API de Elido.

Requisitos

• n8n auto-hospedado con los community nodes habilitados. Los planes de n8n en la nube pueden restringir los community nodes; comprueba tu plan.
• Una API key de workspace de Elido.

Paso 1: Instalar el community node

1. En n8n, ve a Settings → Community Nodes.
2. Haz clic en Install a community node.
3. Pega el nombre del paquete:

   n8n-nodes-elido
   

4. Acepta el aviso de riesgo y haz clic en Install.
5. Busca "Elido" en el selector de nodos. El nodo Elido aparece con el recurso Link.

Paso 2: Crear una API key de Elido

1. En Elido, ve a Settings → API keys → New key.
2. Elige un rol para la key. Editor puede crear enlaces y leer analítica; Viewer solo puede leer enlaces y analítica. Una key pertenece al workspace en el que la creas y no puede actuar sobre ningún otro workspace.
3. Copia la key. Empieza por elido_ y se muestra una sola vez.

Los tokens por scope (links:write, analytics:read, etc.) están planeados; hoy el rol determina lo que puede hacer una key.

Paso 3: Añadir las credenciales de Elido en n8n

1. En n8n, ve a Credentials → New Credential → Elido API.
2. Base URL: deja https://api.elido.app para Elido Cloud, o introduce la raíz de tu API auto-hospedada.
3. API Token: pega la key elido_.
4. Workspace ID: el ID numérico del workspace al que pertenece la key (Settings → Workspace). El nodo lo usa para la analítica.
5. Haz clic en Save. n8n comprueba la credencial leyendo ese workspace, así que una key incorrecta, una Base URL incorrecta o una key de otro workspace fallan aquí en vez de en un workflow en ejecución.

Crea una credencial por cada workspace de Elido y elige la correcta en cada nodo.

Acciones disponibles

Acción	Qué hace
Create	Acorta una URL de destino. Slug, título, etiquetas, expiración, código de redirección y dominio opcionales
Get	Devuelve un enlace por su ID
List	Devuelve hasta 100 enlaces, del más reciente al más antiguo, filtrados por texto de búsqueda, etiquetas o estado (activo/deshabilitado)
Get Analytics	Devuelve los clics a lo largo del tiempo, o los clics por país, referrer, dispositivo o navegador, para un enlace

Create sin un Domain ID coloca el enlace en el dominio de Elido predeterminado de tu workspace. Para usar un dominio personalizado, pasa su ID desde Settings → Domains.

List y Get Analytics devuelven un elemento de n8n por fila, así que el siguiente nodo se ejecuta una vez por enlace o una vez por día, país, referrer, etc. Get Analytics usa por defecto los últimos 30 días; establece From y To (AAAA-MM-DD) para cambiar la ventana.

Update Link y Look Up Link por slug son acciones planeadas. Hasta que se publiquen, llama a PATCH /v1/links/{id} o GET /v1/links?q=<slug> desde un nodo HTTP Request con la misma credencial.

Triggers

Un nodo Elido Trigger dedicado está planeado. Hasta que se publique, usa el trigger integrado Webhook de n8n con un endpoint de webhook de Elido:

1. Añade un nodo Webhook (método POST) y copia su URL de producción.
2. En Elido, ve a Settings → Webhooks → New endpoint, pega la URL y elige los eventos: link.created, link.updated, link.deleted, link.expired, link.cap_reached o link.broken.
3. Copia el secreto de firma. Cada entrega lleva una cabecera X-Elido-Signature: v1=<hex>, un HMAC-SHA256 de {timestamp}.{raw body} con ese secreto, donde el timestamp es el valor en segundos Unix de X-Webhook-Timestamp; verifícalo en un nodo Code antes de confiar en el payload. La guía de webhooks tiene el fragmento de verificación.

Trigger	Estado
Enlace creado, actualizado, eliminado, expirado, roto, límite de clics alcanzado	Disponible hoy a través del nodo Webhook
Link Clicked	Planeado. Necesita el evento de webhook click.created, que todavía no se emite
Conversion Recorded	Planeado, tras la API de conversiones
Threshold Exceeded	Planeado

Workflow de ejemplo: informe diario de clics a una hoja de cálculo

[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 ejemplo: crear un enlace desde un webhook

Un sistema externo hace POST de una URL a n8n, n8n la acorta con Elido y devuelve la URL corta.

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

Solución de problemas

El community node no aparece después de instalarlo: recarga el editor. Si sigue sin aparecer, reinicia n8n; en Docker:

docker restart n8n

La prueba de credencial falla con 404 o 403: el Workspace ID no coincide con el workspace en el que se creó la key, o la key fue revocada. Comprueba ambos en Settings → API keys de Elido.

Create falla con "domain_id": el Domain ID no es un dominio de este workspace. Déjalo vacío para usar el dominio predeterminado.

Get Analytics no devuelve nada: el enlace no tiene clics en la ventana, o el Link ID pertenece a otro workspace. Amplía primero From y To.

URL de webhook rechazada por Elido: la URL de webhook de n8n debe ser accesible desde internet. Si ejecutas n8n en una máquina local o en una red privada, configura un túnel (por ejemplo Cloudflare Tunnel o ngrok) y apunta la variable de entorno WEBHOOK_URL de n8n a la dirección del túnel.