Що ви налаштуєте
- Community-вузол
@elidoapp/n8n-nodes-elido, встановлений у вашому self-hosted екземплярі n8n. - Облікові дані Elido API з точними областями доступу, потрібними вашому робочому процесу — read, write або analytics.
- Вузли тригерів і дій для подій кліків, конверсій, створення посилань та аналітичних запитів.
n8n — це інструмент для автоматизації робочих процесів, який можна розгорнути на власному сервері (self-hosted). Community-вузол Elido надає нативні тригери та дії безпосередньо у візуальному редакторі n8n — без необхідності використання вузлів HTTP Request.
Вимоги#
- Версія n8n 0.220 або новіша (це мінімальна вимога для community-вузлів).
- Self-hosted n8n з увімкненою можливістю встановлення community-вузлів. Хмарні плани n8n Cloud можуть мати обмеження — перевірте свій тарифний план.
- API-токен робочої області Elido.
Крок 1 — Встановлення community-вузла#
- В n8n перейдіть у Settings → Community Nodes.
- Натисніть Install a community node.
- Вставте назву пакета:
@elidoapp/n8n-nodes-elido - Погодьтеся з попередженням про ризики та натисніть Install.
- n8n перезапуститься. Після перезапуску введіть «Elido» у вікні вибору вузлів — ви побачите вузли тригерів та дій Elido.
Крок 2 — Створення API-токена Elido#
- В Elido перейдіть у Dashboard → API Keys → New key.
- Виберіть області доступу (scopes) залежно від потреб вашого робочого процесу:
links:read— пошук посилань, перегляд списку посилань.links:write— створення та оновлення посилань.analytics:read— перегляд кількості кліків та аналітики.
- Скопіюйте токен. Він починається з
ek_.
Крок 3 — Додавання облікових даних Elido в n8n#
- В n8n перейдіть у Credentials → New Credential → Elido API.
- Вставте токен у поле API Token.
- Робоча область буде визначена автоматично на основі токена. Натисніть Save.
Ви можете створити кілька облікових даних (по одному для кожної робочої області Elido) і використовувати їх у відповідних вузлах.
Доступні тригери#
| Тригер | Коли спрацьовує |
|---|---|
| Link Clicked | Кожен клік по будь-якому посиланню в робочій області (або відфільтрований за тегом чи slug) |
| Conversion Recorded | Щоразу, коли реєструється конверсія |
| Threshold Exceeded | Коли кількість кліків по посиланню перевищує встановлене значення |
Тригери використовують систему Elido's webhook під капотом. n8n автоматично реєструє webhook URL, коли ви активуєте робочий процес.
Доступні дії#
| Дія | Що вона робить |
|---|---|
| Create Link | Створює нове коротке посилання |
| Update Link | Оновлює цільову URL-адресу, slug, теги або термін дії |
| List Links | Повертає список посилань із пагінацією та фільтрами |
| Look Up Link | Знаходить посилання за slug або ID |
| Get Analytics | Повертає кількість кліків та детальну аналітику для посилання |
Приклад робочого процесу — логування кліків у Baserow#
Цей процес спрацьовує на кожен клік і записує рядок у таблицю Baserow (self-hosted альтернатива Airtable, яка часто використовується в 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 }}
Щоб налаштувати це:
- Перетягніть тригер Elido на робочу область. Виберіть облікові дані. Встановіть тип тригера "Link Clicked".
- Перетягніть вузол Baserow. З'єднайте його. Налаштуйте вашу базу та таблицю Baserow.
- Налаштуйте відповідність полів, як показано вище.
- Натисніть Activate workflow.
Приклад робочого процесу — створення посилання через webhook#
Простіша схема: зовнішня система надсилає POST-запит з URL-адресою до n8n, n8n скорочує її за допомогою Elido і повертає коротку адресу.
[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 }}" }
Усунення несправностей#
Community-вузол не з'являється після встановлення — n8n потребує повного перезапуску після встановлення community-вузлів. Якщо ви використовуєте n8n у Docker, перезапустіть контейнер: docker restart n8n.
«Invalid credentials» при тестуванні вузла — API-токен неправильний або має недостатні права (scopes). Створіть новий токен з необхідними для вашого процесу областями доступу та оновіть облікові дані в n8n.
Тригер не спрацьовує — Переконайтеся, що робочий процес активний (перемикач у верхньому правому куті редактора). Неактивні процеси не реєструють webhooks, тому Elido ніколи не надсилає події.
Webhook URL відхилено Elido — URL-адреса webhook в n8n має бути доступною з інтернету (або для серверів Elido). Якщо ви запускаєте n8n на локальному комп'ютері або в приватній мережі, налаштуйте тунель (наприклад, Cloudflare Tunnel, ngrok) і вкажіть адресу тунелю у змінній середовища WEBHOOK_URL для n8n.