Usar Elido en n8n auto-hospedado

n8n es una herramienta de automatización de workflows auto-hospedada. El community node de Elido le ofrece triggers y acciones nativas dentro del editor visual de n8n — sin necesidad de nodos HTTP Request.

Requisitos#

• n8n versión 0.220 o superior (los community nodes requieren este mínimo).
• n8n auto-hospedado con la instalación de community nodes habilitada. Los planes n8n en la nube pueden restringir esto — verifique su plan.
• Un token de API de workspace de Elido.

Paso 1 — Instalar el community node#

1. En n8n, vaya a Settings → Community Nodes.
2. Haga clic en Install a community node.
3. Pegue el nombre del paquete:

   @elidoapp/n8n-nodes-elido
   

4. Acepte el aviso de riesgo y haga clic en Install.
5. n8n se reinicia. Después del reinicio, busque "Elido" en el selector de nodos — debería ver los nodos de trigger y acción de Elido.

Paso 2 — Genere un token de API de Elido#

1. En Elido, vaya a Dashboard → API Keys → New key.
2. Elija los scopes según lo que necesite su workflow:
   • links:read — buscar y listar enlaces.
   • links:write — crear y actualizar enlaces.
   • analytics:read — leer recuentos de clics y análisis.
3. Copie el token. Comienza con ek_.

Paso 3 — Agregar credenciales de Elido en n8n#

1. En n8n, vaya a Credentials → New Credential → Elido API.
2. Pegue el token en el campo API Token.
3. El workspace se detecta automáticamente desde el token. Haga clic en Save.

Puede crear múltiples credenciales (una por workspace de Elido) y referenciarlas en nodos individuales.

Triggers disponibles#

Trigger	Cuándo se activa
Link Clicked	Cada clic en cualquier enlace del workspace (o filtrado por tag/slug)
Conversion Recorded	Cada vez que se registra una conversión
Threshold Exceeded	Cuando el recuento de clics de un enlace supera el número configurado

Los triggers utilizan el sistema de webhooks de Elido internamente. n8n registra la URL del webhook automáticamente cuando activa el workflow.

Acciones disponibles#

Acción	Qué hace
Create Link	Crea un nuevo enlace corto
Update Link	Actualiza URL de destino, slug, etiquetas o expiración
List Links	Devuelve una lista paginada de enlaces con filtros
Look Up Link	Encuentra un enlace por slug o ID
Get Analytics	Devuelve el recuento de clics y el desglose de un enlace

Workflow de ejemplo — registrar clics en Baserow#

Este workflow se activa en cada clic y escribe una fila en una tabla de Baserow (una alternativa self-hosted a Airtable, común en configuraciones de 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 configurarlo:

1. Arrastre el trigger de Elido al lienzo. Seleccione la credencial. Establezca el tipo de trigger como "Link Clicked".
2. Arrastre un nodo de Baserow. Conéctelo. Configure su base y tabla de Baserow.
3. Mapee los campos como se muestra arriba.
4. Haga clic en Activate workflow.

Workflow de ejemplo — crear un enlace desde un webhook#

Un patrón más simple: 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 Action: Create Link]
  - Destination URL: {{ $json.body.url }}
  - Tag: {{ $json.body.tag }}
      ↓
[Respond to Webhook]
  - Body: { "short_url": "{{ $json.short_url }}" }

Solución de problemas#

El community node no aparece después de la instalación — n8n necesita un reinicio completo después de instalar community nodes. Si está ejecutando n8n en Docker, reinicie el contenedor: docker restart n8n.

"Invalid credentials" al probar un nodo — El token de API es incorrecto o tiene scope incorrecto. Genere un nuevo token con los scopes que necesita su workflow y actualice la credencial de n8n.

El trigger no se activa — Compruebe que el workflow está activo (el interruptor en la esquina superior derecha del editor de workflow). Los workflows inactivos no registran webhooks, por lo que Elido nunca envía eventos.

URL de webhook rechazada por Elido — La URL de webhook de n8n debe ser accesible desde internet (o desde los servidores de Elido). Si está ejecutando n8n en una máquina local o una red privada, configure un túnel (p. ej., Cloudflare Tunnel, ngrok) y configure WEBHOOK_URL en las variables de entorno de n8n para que apunte a la dirección del túnel.