Коннекторы

Коннекторы — это входящие каналы для получения событий из внешних систем: Telegram-боты, Webhook-приёмники и другие источники данных. Каждый коннектор может быть триггером пайплайна.

Telegram Bot

Подключите вашего Telegram-бота к M-TEH, чтобы пайплайн обрабатывал сообщения пользователей из Telegram.

Создайте бота у @BotFather

Напишите /newbot, задайте имя и username. Скопируйте токен вида 123456:ABC-DEF...

Добавьте интеграцию Telegram Bot

В Интеграции → Добавить выберите группу «Коннекторы» и тип «Telegram Bot». Вставьте токен бота.

M-TEH автоматически настроит webhook

При сохранении M-TEH вызывает Telegram Bot API и регистрирует webhook на свой URL. Никакого ручного деплоя не нужно.

Используйте в пайплайне

Добавьте узел Trigger Telegram в конструкторе или выберите бота первым шагом пайплайна.

Параметры Telegram-интеграции

Поле	Описание
`Bot Token`	Токен от @BotFather
`Allowed usernames`	Whitelist username (опционально — для ограничения доступа)
`Parse mode`	`HTML` или `Markdown` для форматирования ответов

Переменные контекста

При запуске пайплайна через Telegram в контексте доступны:

Переменная	Значение
`{{message}}`	Текст сообщения пользователя
`{{telegram_user_id}}`	Telegram User ID
`{{telegram_username}}`	Username (если публичный)
`{{telegram_chat_id}}`	ID чата
`{{telegram_first_name}}`	Имя пользователя

Webhook Receiver

Получайте события от любых внешних систем через HTTP POST. Подходит для интеграции с CRM, платёжными системами, системами мониторинга и другими сервисами.

Настройка

После создания интеграции типа «Webhook» вы получаете уникальный URL:

Webhook URLPOST https://your-domain.com/api/webhook/nxs_abc123...

Отправьте тестовый запрос:

cURLcurl -X POST https://your-domain.com/api/webhook/nxs_abc123 \
  -H "Content-Type: application/json" \
  -d '{"event":"order_paid","order_id":42,"amount":1990}'

Маппинг полей

Все поля тела запроса доступны в контексте пайплайна напрямую:

JSON поле	Переменная контекста
`event`	`{{event}}`
`order_id`	`{{order_id}}`
`amount`	`{{amount}}`
`customer.email`	`{{customer_email}}`

Пример: уведомление о новом заказе

Граф[Trigger Webhook]
      ↓ output
[Transform]
  └─ notification = "Новый заказ #{{order_id}} на {{amount}}₽"
      ↓ output
[Telegram Send: менеджерский канал]
      ↓ output
[Webhook Call: CRM update]
      ↓ output
[End]

Webhook-запросы не требуют аутентификации со стороны вызывающей системы — только знания уникального URL. Для дополнительной безопасности используйте HMAC-подпись и проверяйте её в узле Condition.