Использовать Elido в self-hosted n8n

n8n - это self-hosted инструмент автоматизации workflow. Community node Elido даёт вам нативные actions внутри визуального редактора n8n, так что не нужно вручную собирать узлы HTTP Request для API Elido.

Требования

• Self-hosted n8n с включёнными community nodes. Облачные планы n8n могут ограничивать community nodes - проверьте свой план.
• API-ключ рабочего пространства Elido.

Шаг 1 - Установите community node

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 или ключ из другого рабочего пространства завершится ошибкой здесь, а не в работающем workflow.

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

Доступные actions

Action	Что делает
Create	Сокращает целевой URL. Опционально: слаг, заголовок, теги, срок действия, код редиректа и Domain ID
Get	Возвращает одну ссылку по её ID
List	Возвращает до 100 ссылок, сначала новые, с фильтром по тексту поиска, тегам или статусу (active/disabled)
Get Analytics	Возвращает клики по времени или клики по стране, referrer, устройству или браузеру для одной ссылки

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

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

Update Link и Look Up Link по слагу - запланированные actions. Пока они не выпущены, вызывайте PATCH /v1/links/{id} или GET /v1/links?q=<slug> из узла HTTP Request с теми же учётными данными.

Триггеры

Отдельный узел Elido Trigger запланирован. Пока он не выпущен, используйте встроенный триггер n8n Webhook с endpoint вебхука 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. Скопируйте signing secret. Каждая доставка несёт заголовок X-Elido-Signature: v1=<hex> - HMAC-SHA256 от {timestamp}.{raw body} с этим секретом, где timestamp - значение в секундах Unix в X-Webhook-Timestamp; проверяйте его в узле Code, прежде чем доверять payload. В руководстве по вебхукам есть сниппет для проверки.

Триггер	Статус
Ссылка создана, обновлена, удалена, истекла, сломана, достигнут лимит кликов	Доступно сегодня через узел Webhook
Link Clicked	Запланировано. Требует событие вебхука click.created, которое пока не отправляется
Conversion Recorded	Запланировано, после появления API конверсий
Threshold Exceeded	Запланировано

Пример workflow - ежедневный отчёт по кликам в таблицу

[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 - создание ссылки по вебхуку

Внешняя система отправляет 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 node не появляется после установки - перезагрузите редактор. Если он всё ещё отсутствует, перезапустите n8n; в Docker:

docker restart n8n

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

Create завершается ошибкой «domain_id» - Domain ID не является доменом этого рабочего пространства. Оставьте поле пустым, чтобы использовать домен по умолчанию.

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

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