Використовуйте Elido у self-hosted n8n

n8n - це інструмент автоматизації робочих процесів, який можна розгорнути на власному сервері (self-hosted). Community-вузол Elido надає нативні дії безпосередньо у візуальному редакторі n8n, тож вам не доведеться вручну будувати вузли HTTP Request проти API Elido.

Вимоги

• Self-hosted n8n з увімкненими community-вузлами. Хмарні плани n8n можуть обмежувати community-вузли - перевірте свій тарифний план.
• API-ключ робочого простору Elido.

Крок 1 - Встановлення community-вузла

1. В n8n перейдіть у Settings → Community Nodes.
2. Натисніть Install a community node.
3. Вставте назву пакета:

   n8n-nodes-elido
   

4. Погодьтеся з попередженням про ризики та натисніть Install.
5. Знайдіть «Elido» у вікні вибору вузлів. З'явиться вузол Elido з ресурсом Link.

Крок 2 - Створення API-ключа Elido

1. В Elido перейдіть у Settings → API keys → New key.
2. Оберіть роль для ключа. Editor може створювати посилання та читати аналітику; Viewer може лише читати посилання й аналітику. Ключ належить робочому простору, в якому його створено, і не може діяти в жодному іншому робочому просторі.
3. Скопіюйте ключ. Він починається з elido_ і показується один раз.

Токени з окремими scope (links:write, analytics:read тощо) заплановані; сьогодні саме роль визначає, що може робити ключ.

Крок 3 - Додавання облікових даних Elido в n8n

1. В n8n перейдіть у Credentials → New Credential → Elido API.
2. Base URL: залиште https://api.elido.app для Elido Cloud або введіть корінь API вашого self-hosted розгортання.
3. API Token: вставте ключ elido_.
4. Workspace ID: числовий ID робочого простору, якому належить ключ (Settings → Workspace). Вузол використовує його для аналітики.
5. Натисніть Save. n8n перевіряє облікові дані, читаючи цей робочий простір, тож неправильний ключ, неправильний Base URL або ключ з іншого робочого простору дадуть збій тут, а не в робочому процесі, що вже виконується.

Створюйте окремі облікові дані для кожного робочого простору Elido і обирайте потрібні в кожному вузлі.

Доступні дії

Дія	Що вона робить
Create	Скорочує цільову URL-адресу. Опціонально: slug, заголовок, теги, термін дії, статус редиректу і Domain ID
Get	Повертає одне посилання за його ID
List	Повертає до 100 посилань, найновіші спочатку, з фільтрацією за текстом пошуку, тегами чи статусом (active/disabled)
Get Analytics	Повертає кліки в часі або кліки за країною, реферером, пристроєм чи браузером для одного посилання

Create без Domain ID розміщує посилання на дефолтному домені Elido вашого робочого простору. Щоб використати власний домен, передайте його ID зі Settings → Domains.

List і Get Analytics повертають один елемент n8n на кожен рядок, тож наступний вузол виконується один раз на посилання або один раз на день, країну, реферер тощо. Get Analytics за замовчуванням охоплює останні 30 днів; встановіть From і To (YYYY-MM-DD), щоб змінити період.

Update Link і Look Up Link за slug - заплановані дії. Поки їх немає, викликайте PATCH /v1/links/{id} або GET /v1/links?q=<slug> з вузла HTTP Request, використовуючи ті самі облікові дані.

Тригери

Спеціальний вузол Elido Trigger запланований. Поки його немає, використовуйте вбудований тригер n8n Webhook з ендпоінтом вебхука Elido:

1. Додайте вузол Webhook (метод POST) і скопіюйте його production URL.
2. В Elido перейдіть у Settings → Webhooks → New endpoint, вставте URL і оберіть події: link.created, link.updated, link.deleted, link.expired, link.cap_reached або link.broken.
3. Скопіюйте секрет підпису. Кожна доставка несе заголовок X-Elido-Signature: v1=<hex> - HMAC-SHA256 від {timestamp}.{raw body} з цим секретом, де timestamp - значення в секундах Unix із X-Webhook-Timestamp; перевіряйте його у вузлі Code, перш ніж довіряти payload. У гайді з вебхуків є сніпет для перевірки.

Тригер	Статус
Link created, updated, deleted, expired, broken, click cap reached	Доступно через вузол Webhook вже сьогодні
Link Clicked	Заплановано. Потребує webhook-події click.created, яка ще не надсилається
Conversion Recorded	Заплановано, після API конверсій
Threshold Exceeded	Заплановано

Приклад робочого процесу - щоденний звіт про кліки в таблицю

[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 }}

Приклад робочого процесу - створення посилання через вебхук

Зовнішня система надсилає POST-запит з URL-адресою в n8n, n8n скорочує її за допомогою Elido і повертає коротку URL-адресу.

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

Усунення несправностей

Community-вузол не з'являється після встановлення - перезавантажте редактор. Якщо він все ще відсутній, перезапустіть n8n; у Docker:

docker restart n8n

Перевірка облікових даних не проходить з 404 чи 403 - Workspace ID не збігається з робочим простором, у якому створено ключ, або ключ відкликано. Перевірте обидва в Settings → API keys Elido.

Create завершується помилкою «domain_id» - Domain ID не є доменом цього робочого простору. Залиште поле порожнім, щоб використати дефолтний домен.

Get Analytics не повертає нічого - у посилання немає кліків за обраний період, або Link ID належить іншому робочому простору. Спершу розширте From і To.

URL вебхука відхилено Elido - URL-адреса вебхука n8n має бути доступною з інтернету. Якщо ви запускаєте n8n на локальному комп'ютері або в приватній мережі, налаштуйте тунель (наприклад, Cloudflare Tunnel чи ngrok) і вкажіть адресу тунелю у змінній середовища WEBHOOK_URL для n8n.