- Выберите проектАктивный проект указан в верхней части сайдбара. Все данные и интеграции изолированы внутри него.
- Подключите каналВ настройках добавьте токен Telegram или MAX и включите интеграцию.
- Проверьте стартовый сценарийВо вкладке «Флоу» найдите узел, отмеченный как стартовый, и настройте первое сообщение.
- Отправьте боту /startПользователь появится в базе подписчиков соответствующего канала.
- Сделайте тестовую рассылкуСоздайте черновик, сохраните его и отправьте тест на свой User ID.
Готово к работеЕсли бот отвечает на /start, а пользователь появился в «Подписчиках», базовая настройка завершена.
Переключение проекта
Выберите проект в сайдбаре. После переключения платформа загрузит его подписчиков, формы, рассылки, флоу и интеграции.
Роли
Владелец и администратор управляют проектом. Супер-администратор создаёт проекты и приглашает пользователей.
Изоляция данных
Токены, база подписчиков, переменные и сценарии одного проекта не доступны другому проекту.
Часовой пояс
Определяет локальное время календарных автоматизаций и запланированных рассылок.
Telegram
- Создайте бота через BotFather.
- Скопируйте Bot token.
- Вставьте токен в карточку Telegram.
- Включите интеграцию и сохраните.
MAX
- Создайте бота в кабинете MAX.
- Скопируйте токен бота.
- Вставьте его в карточку MAX.
- Включите интеграцию и сохраните.
Изменение токенаЕсли поле токена оставить пустым, сохранённый секрет не изменится. После сохранения транспорт выбранного проекта перезапускается автоматически.
Локальная разработка
При обычном запуске используется polling. Бот сам запрашивает новые события у Telegram и MAX, поэтому публичный домен и HTTPS не нужны.
Production
Платформа регистрирует webhooks обоих каналов на публичном HTTPS-домене. Каждый проект и канал получает отдельный endpoint и проверяет подпись запроса.
Переключение автоматическоеПри переходе в polling старая подписка удаляется. При замене токена на сервере прежний webhook отключается, а новый регистрируется без ручной настройки в кабинете мессенджера.
- Фильтр каналовПоказывает всю базу либо только Telegram или MAX.
- ПоискИщет по имени, username, телефону и User ID.
- Карточка клиентаПозволяет изменить имя, фамилию, email, теги и произвольные поля.
- АватарЗагружается из мессенджера, когда платформа и API канала позволяют его получить.
- ИсточникСохраняет UTM-атрибуцию первого входа пользователя.
- УдалениеУдаляет подписчика только из выбранного канала текущего проекта.
Новый пользователь добавляется автоматически после команды /start. Повторный запуск обновляет его профиль и возвращает активный статус.
Сегмент состоит из одного или нескольких условий. Режим «Все условия» требует совпадения каждого правила, а «Любое условие» — хотя бы одного.
КаналСтатусТегИмяEmailДата добавленияПроизвольное поле
Динамический составКоличество участников сегмента меняется вместе с данными подписчиков. Для рассылки состав получателей фиксируется в момент сохранения кампании.
Создание рассылки
- Введите названиеОно видно только команде проекта.
- Выберите каналTelegram, MAX или оба канала.
- Выберите сегментИли оставьте всю активную базу выбранных каналов.
- Добавьте карточкиТекст, изображение, файл, аудио, голосовое, видео, видеозаметка или галерея.
- Добавьте Inline-кнопкиURL открывает ссылку, «Действие из флоу» запускает выбранный узел.
- Сохраните черновикПосле сохранения доступны тест, планирование и запуск.
Форматирование текста
Редактор поддерживает жирный, курсив, подчёркивание, зачёркивание, код и ссылки. Через меню переменных можно вставлять системные значения, например {%first_name%}, и переменные проекта.
Отправить сейчас
После подтверждения кампания попадает в очередь и начинает отправку.
Запланировать
Дата интерпретируется в часовом поясе проекта. Запланированную задачу можно отменить без удаления рассылки.
Календарь
Кнопка «Календарь» показывает запланированные и уже проведённые рассылки по дням. Время отображается в часовом поясе проекта; нажатие на событие открывает его карточку и статистику.
- Прогресс по каналамОтдельно показывает Telegram и MAX: всего, доставлено, недоступно и ошибки.
- CheckpointПосле технической ошибки продолжение начинается с последнего необработанного получателя.
- Независимые каналыОшибка MAX не останавливает доставку в Telegram и наоборот.
- ОстановкаАктивную задачу можно остановить, не удаляя кампанию.
- Удаление сообщенийПлатформа попытается удалить уже отправленные сообщения там, где API мессенджера это поддерживает.
- Чистка базыНедоступных из-за блокировки бота получателей можно удалить отдельным действием по итогам кампании.
Недоступно — не ошибкаБлокировка бота или удалённый аккаунт учитываются как отдельный результат доставки и не искажают статистику технических ошибок.
- Перемещение холстаЗажмите свободное место и потяните.
- МасштабИспользуйте колесо мыши с фокусом на холсте.
- РедактированиеНажмите на узел — его настройки откроются в модальном окне.
- Создание по ПКМНажмите правой кнопкой по свободному месту и выберите тип узла.
- Создание из связиПотяните выход узла в пустое место: появится плейсхолдер нового узла.
- История измененийПеред сохранением создаётся версия, которую можно восстановить.
- ПроверкаНаходит битые переходы и недостижимые узлы до запуска сценария.
Старт сценарияТолько один узел должен быть назначен стартовым для команды /start. Другие узлы запускаются кнопками, автоматизациями и UTM-ссылками.
✉Сообщение
Содержит до 20 карточек: текст, изображение или форму. Поддерживает Inline-кнопки и автопереход.
⑂Условие
Проверяет канал, статус, тег или поле пользователя и направляет в ветку «Да» либо «Нет».
◷Задержка
Приостанавливает сценарий на минуты, часы или дни. Ожидание сохраняется после перезапуска платформы.
⚙Действия
Добавляет и удаляет теги, изменяет поля, запускает другой сценарий или выполняет HTTPS-запрос.
HTTP-запрос
Укажите метод, HTTPS URL, JSON-тело и необязательное поле для сохранения ответа. В URL и теле можно использовать переменные пользователя и проекта.
Конструктор
Добавляйте вопросы, меняйте порядок, обязательность, подсказки и варианты ответа.
Ответы
Просматривайте отправки внутри платформы вместе с датой, каналом и пользователем.
Статистика
Показывает количество ответов и распределение по вариантам выбора.
Публикация
Черновик недоступен клиентам. После публикации появляется публичная ссылка.
Типы вопросов
Короткий текстРазвёрнутый текстТелефонEmailЧислоДатаОдин вариантНесколько вариантовСогласие
При размещении формы во флоу бот задаёт вопросы последовательно в Telegram или MAX, сохраняет каждый ответ и продолжает сценарий после завершения.
СобытиеКогда срабатываетПользователь подписалсяПосле первого или повторного /start.
Прошёл формуПосле сохранения последнего ответа.
Получил тегКогда профиль впервые получает указанный тег.
Написал командуПри сообщении вида /command.
Наступила датаОдин раз в локальное время проекта.
Нет активностиПосле заданного количества часов без ответа.
Перешёл по UTMПри входе через выбранную отслеживаемую ссылку.
Попал в сегментПри первом соответствии условиям сегмента.
WebhookПо внешнему HTTPS-запросу с platform и userId.
Правило можно временно выключить: оно сохранится, но перестанет запускать сценарий.
Системные
Данные подписчика: {%first_name%}, {%last_name%}, {%username%}, {%user_id%}, {%platform%}.
Проектные
Задаются в настройках и имеют название, ключ, тип и значение. Например, {%event_date%}.
Кнопка копирования помещает токен переменной в буфер обмена. В редакторах текста переменные доступны через специальное меню и отличаются цветом бейджа.
Не меняйте ключ без необходимостиПосле изменения ключа старые вставки в сценариях и рассылках перестанут получать значение.
- Создайте ссылкуВыберите бот или форму и задайте понятное внутреннее название.
- Заполните UTMSource, medium и campaign описывают источник, формат и кампанию; content и term необязательны.
- Для бота выберите каналTelegram или MAX. При необходимости укажите узел, который запустится после входа.
- Скопируйте короткую ссылкуПлатформа отдельно считает клики, реальные старты бота и отправки формы.
В разрезах можно сравнивать показатели по любому UTM-ключу. Источник также отображается в карточке подписчика.
- Откройте формуПерейдите на вкладку «Конструктор» и включите синхронизацию с Google Таблицами.
- Укажите ссылкуВставьте полную ссылку на таблицу пользователя и название листа.
- Выдайте доступДобавьте
sheets@studiya-508122.iam.gserviceaccount.com в редакторы таблицы. - Сохраните формуПлатформа проверит доступ и возможность записать заголовки.
Настройка привязана к формеОтветы записываются именно в таблицу, указанную в этой форме. Глобальная таблица из окружения не используется.
Подключение аккаунта
- Создайте приватную интеграциюВ amoCRM откройте «Настройки → Интеграции», создайте интеграцию и укажите Redirect URI вашей СТУДИИ.
- Скопируйте ключиВам понадобятся ID интеграции, секретный ключ и временный код авторизации.
- Откройте настройки проектаВ блоке amoCRM нажмите «Подключить» и укажите домен аккаунта вместе с полученными данными.
- При необходимости задайте воронкуID воронки и этапа необязательны. Без них amoCRM использует первый этап главной воронки.
- Проверьте соединениеПлатформа обменяет код на OAuth-токены и покажет название подключённого аккаунта.
Передача формы
Откройте форму и включите «Передавать ответы» в карточке amoCRM. После каждого успешного заполнения платформа создаст сделку, добавит контакт и прикрепит примечание со всеми ответами. Поля типов «Телефон» и «Email» попадут в стандартные поля контакта. Результат передачи отображается в колонке «Интеграции» на вкладке ответов.
Безопасное хранениеOAuth-токены и секрет интеграции шифруются ключом платформы и изолированы внутри проекта. Access token обновляется автоматически через Refresh token.
Ограничения APIЗапросы выполняются через очередь с учётом лимита amoCRM. Ошибка передачи фиксируется в журнале и не мешает сохранить ответ формы внутри СТУДИИ.
Техническая справка: OAuth-интеграции и API сделок amoCRM.
ЧерновикМожно свободно редактировать.
ЗапланированоЖдёт указанного времени.
ВыполняетсяИдёт отправка по одному или двум каналам.
ЗавершеноВсе получатели обработаны.
Завершено с ошибкамиЕсть технические сбои, доступно продолжение.
ОтмененоЗапуск остановлен пользователем.
Подтверждение появляется при удалении рассылки, формы, подписчика, сегмента, переменной, узла, Inline-кнопки и при восстановлении версии сценария.
Проверьте проектПеред удалением убедитесь, что в селекторе сайдбара выбран нужный проект. Удаление выполняется только в его контексте.
Бот не отвечает на /start
Проверьте, включён ли канал, сохранён ли токен и назначен ли стартовый узел. После замены токена снова сохраните интеграции.
Рассылка остановилась
Откройте её историю и посмотрите прогресс отдельно по каналам. Для технических ошибок используйте продолжение — обработанные получатели повторно не отправятся.
Пользователь не получил сообщение
Статус «Недоступно» обычно означает блокировку бота или удалённый аккаунт. Такие профили можно очистить по итогам рассылки.
Форма не пишет в Google Таблицу
Проверьте ссылку, название листа и доступ редактора для сервисного аккаунта. Повторно сохраните форму, чтобы запустить проверку.
Форма не создаёт сделку в amoCRM
Нажмите «Проверить» в блоке amoCRM настроек проекта. Убедитесь, что передача включена в нужной форме и у пользователя интеграции есть право создавать сделки и контакты.
Сценарий не доходит до узла
Запустите «Проверку» в хедере Флоу. Исправьте битые переходы и убедитесь, что узел достижим от стартового сценария.