Что вы настроите
- Community node
@elidoapp/n8n-nodes-elido, установленный в вашем self-hosted экземпляре n8n. - Учётные данные Elido API с точными scopes, необходимыми вашему воркфлоу — read, write или analytics.
- Trigger- и action-узлы для событий кликов, конверсий, создания ссылок и аналитических запросов.
n8n — это self-hosted инструмент автоматизации. Community node Elido даёт тебе нативные триггеры и actions в визуальном редакторе n8n — без узлов HTTP Request.
Требования#
- n8n версии 0.220 или выше (community nodes требуют этого минимума).
- Self-hosted n8n с включённой установкой community nodes. Облачные планы n8n могут ограничивать это — проверь свой план.
- API-токен воркспейса Elido.
Шаг 1 — Установи community node#
- В n8n перейди в Settings → Community Nodes.
- Нажми Install a community node.
- Вставь название пакета:
@elidoapp/n8n-nodes-elido - Согласись с уведомлением о рисках и нажми Install.
- n8n перезапустится. После перезапуска найди «Elido» в пикере узлов — должны появиться trigger-узел и action-узлы Elido.
Шаг 2 — Создай API-токен Elido#
- В Elido перейди в Dashboard → API Keys → New key.
- Выбери scopes в зависимости от нужд workflow:
links:read— поиск и список ссылок.links:write— создание и обновление ссылок.analytics:read— чтение количества кликов и аналитики.
- Скопируй токен. Он начинается с
ek_.
Шаг 3 — Добавь учётные данные Elido в n8n#
- В n8n перейди в Credentials → New Credential → Elido API.
- Вставь токен в поле API Token.
- Воркспейс определяется автоматически по токену. Нажми Save.
Можно создать несколько учётных данных (по одному на воркспейс Elido) и ссылаться на них в отдельных узлах.
Доступные триггеры#
| Триггер | Когда срабатывает |
|---|---|
| Link Clicked | Каждый клик по любой ссылке в воркспейсе (или фильтрация по тегу/слагу) |
| Conversion Recorded | Каждый раз при записи конверсии |
| Threshold Exceeded | Когда счётчик кликов ссылки пересекает заданное значение |
Триггеры используют систему вебхуков Elido. n8n автоматически регистрирует URL вебхука при активации workflow.
Доступные actions#
| Action | Что делает |
|---|---|
| Create Link | Создаёт новую короткую ссылку |
| Update Link | Обновляет URL назначения, слаг, теги или срок действия |
| List Links | Возвращает постраничный список ссылок с фильтрами |
| Look Up Link | Находит ссылку по слагу или ID |
| Get Analytics | Возвращает количество кликов и детализацию для ссылки |
Пример workflow — логирование кликов в Baserow#
Этот workflow срабатывает при каждом клике и записывает строку в таблицу 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.
Пример workflow — создание ссылки по вебхуку#
Более простой паттерн: внешняя система отправляет POST с URL в n8n, n8n сокращает его с помощью Elido и возвращает короткий URL.
[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 node не появляется после установки — n8n требует полного перезапуска после установки community nodes. При использовании n8n в Docker перезапусти контейнер: docker restart n8n.
«Invalid credentials» при тестировании узла — API-токен неверный или имеет неправильные scopes. Создай новый токен с нужными scopes и обнови учётные данные n8n.
Триггер не срабатывает — Убедись, что workflow активен (переключатель в правом верхнем углу редактора workflow). Неактивные workflow не регистрируют вебхуки, поэтому Elido никогда не отправляет события.
URL вебхука отклонён Elido — URL вебхука n8n должен быть доступен из интернета (или с серверов Elido). При локальном запуске n8n или в частной сети настрой туннель (например Cloudflare Tunnel, ngrok) и задай WEBHOOK_URL в переменных окружения n8n, указав адрес туннеля.