Интеграции и API Senler

Как работают триггеры

«Триггер — это функция, которая реагирует на различные события и запускает определенные действия». Настраиваются триггеры в разделе «Триггеры». События-сообщения бывают двух видов. Входящее происходит, когда пользователь пишет в диалог или нажимает кнопку. Исходящее происходит, когда администратор пишет от имени сообщества; администратора можно выбрать.

Триггер проверяет сообщение по одному или нескольким условиям:

• любое сообщение;
• равно (без учёта регистра) / не равно;
• содержит / не содержит;
• регулярное выражение;
• телефон российского формата из 11 цифр;
• e-mail;
• число, меньше или больше числа;
• стикер, фото, видео, аудио, документ, голосовое, товар, вложения;
• ссылка на диалог с параметром ref или ref_source.

Отдельный триггер срабатывает на загрузку фото в открытый альбом сообщества. Не срабатывают триггеры у пользователей с запрещёнными сообщениями, кроме триггеров на входящие сообщения. Проверку «Любое сообщение» не сочетайте с другими триггерами той же группы.

Зачем нужны переменные и метки

Переменные хранят данные о подписчике: ответ на вопрос бота, результат формулы. В Senler три вида переменных: %username% для стандартных, {%var%} для пользовательской, [%var%] для глобальной. В имени переменной используют цифры, латиницу в нижнем регистре и подчёркивание, значение вмещает до 4000 символов.

В боте ответ подписчика сохраняется в переменную шагом после «Ответ на сообщение». В блоке «Действие» → «Переменная» → «Формула» доступны sin, cos, sqrt, round, floor, ceil, abs, возведение в степень и другие операции. Переменные могут пропасть, если пользователь запретил сообщения сообществу.

Метки — это каналы привлечения подписчиков. Метка передаётся в ссылке через параметр u. От групп подписчиков метки отличаются тем, что фиксируют, откуда пришёл человек, а не куда его разложить. Ссылки с метками и ref-параметрами разобраны на странице о ссылках, работа меток с группами — на странице о группах подписчиков.

Что есть в каталоге интеграций

Каталог открыт в разделе «Интеграции»: у нужной интеграции нажимается кнопка «Установить», установленная удаляется на вкладке «Установленные». Если начинаете с одной интеграции, ставьте Google Sheets: шаг в боте записывает данные подписчика в таблицу на любом шаге, и для заявок этого достаточно без программиста.

Интеграция	Для чего
AI Assistant	Генерация текста и изображений в шаге бота; провайдеры OpenAI, ProxyAPI, OpenRouter, подключается свой API-ключ
Imanator	Шаг бота, который отправляет подписчику изображение по шаблону; нужен аккаунт на imanator.pro
amoCRM	Шаг бота: создать сделку при заполнении формы в боте, заметки менеджеру, ответственный, тег, статус, источник UTM из переменных; интеграция на стадии бета-тестирования
Google Sheets	Запись данных подписчика в таблицу на любом шаге бота
Google Analytics, Google Tag Manager, Facebook Pixel, Пиксель VK Рекламы, Яндекс Метрика	Счётчики и пиксели рекламы
Реферальная система для чат-ботов	Персональные ссылки подписчикам, учёт приглашённых, данные о приглашениях в боте; приглашённый закрепляется за первым пригласившим
Уведомления в Telegram	Отправка уведомлений из бота Senler в бота Telegram; бета-версия
Prodamus, Robokassa, Unitpay, VK Pay, ЮMoney	Приём оплаты платных подписок: группы подписчиков со стоимостью

API и WebHook API: что умеет разработчик

Открытое API Senler адресовано тем, кто пишет свой код. Запросы отправляются на адрес https://senler.ru/api/METHOD_NAME методом POST с обязательными параметрами group_id, access_token и v; актуальная версия API — 2. Методы охватывают подписчиков, группы подписчиков, рассылки, боты, метки и переменные.

WebHook API работает в обратную сторону: при событиях в сообществе Senler сам отправляет HTTP-запросы на ваш адрес. Адрес задаётся в разделе «Настройки» → «WebHook API». Сервер должен отвечать 200 OK, иначе запрос повторяется, и число попыток ограничено. Для сайта существует «Кнопка для сайта»: готовый код подписки, который встраивается в страницу.

Кто может ставить интеграции

Работать с интеграциями могут только владелец проекта и его администраторы.

Где это применяется

Чат-боты Senler используют триггеры, переменные и шаги интеграций в своих цепочках. Ссылки с метками и ref-параметрами собираются на странице о ссылках. Метки и группы подписчиков описаны в разделе о группах подписчиков. Лимиты и цены зависят от тарифа Senler.