Инструкция показывает, как внешняя CRM или другая система может отправлять заявку в n8n, а n8n - создавать объект в Rightech IoT Core, проверять результат и отправлять уведомление в Telegram.
Инструкция рассчитана на пользователя или интегратора, у которого уже развернут n8n и есть доступ к проекту Rightech IoT Core.
Что получится
После настройки внешняя CRM или другая система сможет отправлять заявку в n8n. Workflow создаст объект в Rightech IoT Core, перечитает его для проверки и отправит сообщение ответственному в Telegram.
Что нужно подготовить
- Доступ в Rightech IoT Core к проекту, где можно создавать модели, объекты и API-токены.
- Развернутый n8n с правом устанавливать community nodes.
- Установленный n8n-узел
@rightech/n8n-nodes-ric.
- API-токен RIC с правами на создание и чтение объектов.
- Telegram-бот и получатель уведомления.
- CRM или другая внешняя система, которая умеет отправлять HTTP POST в webhook n8n.
Подготовьте RIC
- Откройте Rightech IoT Core.
- Подготовьте модель, по которой будут создаваться объекты из CRM, или выберите существующую рабочую модель проекта.
- Убедитесь, что в модели есть идентификатор устройства, по которому будет создан объект из CRM.
- Сохраните модель и скопируйте ее ID: он понадобится при настройке ноды
RIC Object Create.
- Создайте API-токен для подключения n8n к RIC.
Подготовьте n8n
- Откройте
Settings -> Community Nodes.
- Установите пакет
@rightech/n8n-nodes-ric.
- Создайте credential
Rightech IoT Core API.
- Укажите адрес вашей инсталляции RIC, например
https://dev.rightech.io или адрес on-premise-поставки.
- Вставьте API-токен RIC.
- Создайте credential
Telegram API для отправки сообщений.
Соберите workflow создания объекта
Пример собранного workflow в n8n:
1. Добавьте Webhook
Webhook - это входная точка workflow. Сюда CRM отправляет данные о новом объекте.
| Поле | Значение |
|---|
| HTTP Method | POST |
| Path | Например: ric-crm-onboarding-demo |
| URL для CRM | Production URL, который показывает n8n |
2. Подготовьте данные объекта
Добавьте шаг подготовки данных. В нем нужно привести поля CRM к понятным полям RIC. Это можно сделать через Set/Edit Fields node или через Code node, если у клиента сложные правила преобразования.
| Что приходит из CRM | Что передаем дальше в RIC |
|---|
| Название устройства или сделки | Имя объекта |
| Уникальный идентификатор устройства | ClientID / Device ID |
| Клиент, сделка, ответственный | Описание объекта |
| Источник заявки | Дополнительная информация для уведомления |
3. Добавьте RIC Object Create
Эта нода создает объект в Rightech IoT Core.
| Настройка | Что выбрать |
|---|
| Node | Rightech IoT Core |
| Resource | Object |
| Operation | Create |
| Credential | Созданный ранее Rightech IoT Core API |
| Model | Модель, подготовленная в RIC |
| Name | Имя объекта из шага подготовки данных |
| Device ID | ClientID / Device ID из шага подготовки данных |
4. Добавьте RIC Object Get
Этот шаг перечитывает созданный объект из RIC. Так workflow подтверждает, что объект действительно создан.
| Настройка | Что выбрать |
|---|
| Node | Rightech IoT Core |
| Resource | Object |
| Operation | Get |
| Object ID | ID объекта, который вернула предыдущая нода |
5. Добавьте Telegram
Финальный шаг отправляет ответственному сообщение о том, что объект создан.
| Что указать | Пример содержания |
|---|
| Получатель | Пользователь или группа, куда нужно отправить уведомление |
| Text | Объект создан в RIC: имя объекта, Device ID, RIC ID, ответственный |
Проверьте workflow
- Включите workflow в n8n.
- Отправьте контрольную заявку из CRM или используйте HTTP-запрос в webhook с данными реального формата.
- Убедитесь, что все ноды завершились успешно.
- Проверьте, что объект появился в RIC.
- Проверьте, что Telegram получил уведомление.
Пример успешного выполнения workflow:
Пример результата в RIC:
Дополнительный сценарий: устройство вышло online
После создания объекта можно показать второй сценарий: устройство подключается к RIC, а n8n отправляет уведомление, что объект появился online.
- Устройство подключается к RIC с тем же ClientID / Device ID, который был создан из CRM.
- Workflow в n8n запускается по расписанию или по отдельному webhook.
- Нода
RIC Object Get получает актуальное состояние объекта.
- Если объект online, Telegram отправляет уведомление ответственному.
Пример workflow проверки online-статуса:
Пример успешной проверки online-статуса:
⚠️
Если устройство отправило один пакет и отключилось, объект может иметь последние данные, но не считаться online. Для online-статуса устройство должно держать соединение с RIC.
Рекомендации по доступам
- Создайте отдельный API-токен RIC для n8n.
- Выдайте токену только те права, которые нужны для сценария.
- Используйте отдельный Telegram-бот для сервисных уведомлений.
- Перед подключением потока рабочих данных проверьте workflow на отдельном объекте или ограниченной группе объектов.
- Для внешнего webhook используйте production URL из n8n.
Что можно менять под клиента
- Источник данных: CRM, ERP, 1C, форма на сайте или корпоративная система.
- Состав полей, которые передаются в объект RIC.
- Текст Telegram-сообщения.
- Канал уведомлений: Telegram, email, Slack, Microsoft Teams или другая система из n8n.
- Условие уведомления: объект создан, объект online, изменился статус, достигнут порог значения.
Важно о сценарии
Это только один пример использования Rightech IoT Core в n8n. По такой же логике можно собирать другие сценарии: уведомления по событиям, передачу данных в ERP или BI, автоматическую подготовку отчетов, запуск сценариев и обмен данными с внутренними системами.
