Центр помощи

Документация СТУДИИ

Практическое руководство по работе с проектами, ботами, рассылками, сценариями, формами и аналитикой.

01Подключить ботаTelegram и MAX 02Запустить рассылкуОт черновика до статистики 03Собрать сценарийУзлы, связи и проверка 04Создать формуВ браузере и внутри чата
01

Быстрый старт

Минимальный путь от пустого проекта до работающего бота.

  1. Выберите проектАктивный проект указан в верхней части сайдбара. Все данные и интеграции изолированы внутри него.
  2. Подключите каналВ настройках добавьте токен Telegram или MAX и включите интеграцию.
  3. Проверьте стартовый сценарийВо вкладке «Флоу» найдите узел, отмеченный как стартовый, и настройте первое сообщение.
  4. Отправьте боту /startПользователь появится в базе подписчиков соответствующего канала.
  5. Сделайте тестовую рассылкуСоздайте черновик, сохраните его и отправьте тест на свой User ID.
Готово к работеЕсли бот отвечает на /start, а пользователь появился в «Подписчиках», базовая настройка завершена.
02

Проекты и доступ

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

Настройки проекта в СТУДИИ

Переключение проекта

Выберите проект в сайдбаре. После переключения платформа загрузит его подписчиков, формы, рассылки, флоу и интеграции.

Роли

Владелец и администратор управляют проектом. Супер-администратор создаёт проекты и приглашает пользователей.

Изоляция данных

Токены, база подписчиков, переменные и сценарии одного проекта не доступны другому проекту.

Часовой пояс

Определяет локальное время календарных автоматизаций и запланированных рассылок.

03

Telegram и MAX

Каждый проект подключает собственные каналы информирования.

Карточки интеграций Telegram и MAX

Telegram

  1. Создайте бота через BotFather.
  2. Скопируйте Bot token.
  3. Вставьте токен в карточку Telegram.
  4. Включите интеграцию и сохраните.

MAX

  1. Создайте бота в кабинете MAX.
  2. Скопируйте токен бота.
  3. Вставьте его в карточку MAX.
  4. Включите интеграцию и сохраните.
Изменение токенаЕсли поле токена оставить пустым, сохранённый секрет не изменится. После сохранения транспорт выбранного проекта перезапускается автоматически.
03.1

Как платформа получает сообщения

Режим выбирается автоматически в зависимости от окружения.

Локальная разработка

При обычном запуске используется polling. Бот сам запрашивает новые события у Telegram и MAX, поэтому публичный домен и HTTPS не нужны.

Production

Платформа регистрирует webhooks обоих каналов на публичном HTTPS-домене. Каждый проект и канал получает отдельный endpoint и проверяет подпись запроса.

Переключение автоматическоеПри переходе в polling старая подписка удаляется. При замене токена на сервере прежний webhook отключается, а новый регистрируется без ручной настройки в кабинете мессенджера.
04

Подписчики

Единая клиентская база с разделением по Telegram и MAX.

База подписчиков проекта

Новый пользователь добавляется автоматически после команды /start. Повторный запуск обновляет его профиль и возвращает активный статус.

05

Сегменты

Динамические выборки подписчиков по данным их профиля.

Сегмент состоит из одного или нескольких условий. Режим «Все условия» требует совпадения каждого правила, а «Любое условие» — хотя бы одного.

КаналСтатусТегИмяEmailДата добавленияПроизвольное поле
Динамический составКоличество участников сегмента меняется вместе с данными подписчиков. Для рассылки состав получателей фиксируется в момент сохранения кампании.
06

Рассылки

Редактор сообщений, черновики, история и отправка по двум каналам.

Редактор рассылки

Создание рассылки

  1. Введите названиеОно видно только команде проекта.
  2. Выберите каналTelegram, MAX или оба канала.
  3. Выберите сегментИли оставьте всю активную базу выбранных каналов.
  4. Добавьте карточкиТекст, изображение, файл, аудио, голосовое, видео, видеозаметка или галерея.
  5. Добавьте Inline-кнопкиURL открывает ссылку, «Действие из флоу» запускает выбранный узел.
  6. Сохраните черновикПосле сохранения доступны тест, планирование и запуск.

Форматирование текста

Редактор поддерживает жирный, курсив, подчёркивание, зачёркивание, код и ссылки. Через меню переменных можно вставлять системные значения, например {%first_name%}, и переменные проекта.

Отправить сейчас

После подтверждения кампания попадает в очередь и начинает отправку.

Запланировать

Дата интерпретируется в часовом поясе проекта. Запланированную задачу можно отменить без удаления рассылки.

Календарь

Кнопка «Календарь» показывает запланированные и уже проведённые рассылки по дням. Время отображается в часовом поясе проекта; нажатие на событие открывает его карточку и статистику.

07

Доставка и статистика

Отправка выполняется независимо по каждому каналу и сохраняет прогресс.

Прогресс и статистика рассылки
Недоступно — не ошибкаБлокировка бота или удалённый аккаунт учитываются как отдельный результат доставки и не искажают статистику технических ошибок.
08

Редактор Флоу

Полноэкранный холст для построения логики диалога.

Полноэкранный редактор Флоу
Старт сценарияТолько один узел должен быть назначен стартовым для команды /start. Другие узлы запускаются кнопками, автоматизациями и UTM-ссылками.
09

Типы узлов

Четыре базовых блока покрывают сообщение, ветвление, ожидание и изменение данных.

Сообщение

Содержит до 20 карточек: текст, изображение или форму. Поддерживает Inline-кнопки и автопереход.

Условие

Проверяет канал, статус, тег или поле пользователя и направляет в ветку «Да» либо «Нет».

Задержка

Приостанавливает сценарий на минуты, часы или дни. Ожидание сохраняется после перезапуска платформы.

Действия

Добавляет и удаляет теги, изменяет поля, запускает другой сценарий или выполняет HTTPS-запрос.

HTTP-запрос

Укажите метод, HTTPS URL, JSON-тело и необязательное поле для сохранения ответа. В URL и теле можно использовать переменные пользователя и проекта.

10

Формы

Анкеты, которые открываются по ссылке или проходят прямо в чате бота.

Конструктор формы

Конструктор

Добавляйте вопросы, меняйте порядок, обязательность, подсказки и варианты ответа.

Ответы

Просматривайте отправки внутри платформы вместе с датой, каналом и пользователем.

Статистика

Показывает количество ответов и распределение по вариантам выбора.

Публикация

Черновик недоступен клиентам. После публикации появляется публичная ссылка.

Типы вопросов

Короткий текстРазвёрнутый текстТелефонEmailЧислоДатаОдин вариантНесколько вариантовСогласие

При размещении формы во флоу бот задаёт вопросы последовательно в Telegram или MAX, сохраняет каждый ответ и продолжает сценарий после завершения.

11

Автоматизации

Запускают выбранный узел сценария при наступлении события.

Правила автоматизации
СобытиеКогда срабатываетПользователь подписался

После первого или повторного /start.

Прошёл форму

После сохранения последнего ответа.

Получил тег

Когда профиль впервые получает указанный тег.

Написал команду

При сообщении вида /command.

Наступила дата

Один раз в локальное время проекта.

Нет активности

После заданного количества часов без ответа.

Перешёл по UTM

При входе через выбранную отслеживаемую ссылку.

Попал в сегмент

При первом соответствии условиям сегмента.

Webhook

По внешнему HTTPS-запросу с platform и userId.

Правило можно временно выключить: оно сохранится, но перестанет запускать сценарий.

12

Переменные

Повторно используемые значения для рассылок, флоу и интеграций.

Системные

Данные подписчика: {%first_name%}, {%last_name%}, {%username%}, {%user_id%}, {%platform%}.

Проектные

Задаются в настройках и имеют название, ключ, тип и значение. Например, {%event_date%}.

Кнопка копирования помещает токен переменной в буфер обмена. В редакторах текста переменные доступны через специальное меню и отличаются цветом бейджа.

Не меняйте ключ без необходимостиПосле изменения ключа старые вставки в сценариях и рассылках перестанут получать значение.
13

Метрика и UTM

Отслеживание источников входа в ботов и отправки форм.

Метрика UTM-ссылок
  1. Создайте ссылкуВыберите бот или форму и задайте понятное внутреннее название.
  2. Заполните UTMSource, medium и campaign описывают источник, формат и кампанию; content и term необязательны.
  3. Для бота выберите каналTelegram или MAX. При необходимости укажите узел, который запустится после входа.
  4. Скопируйте короткую ссылкуПлатформа отдельно считает клики, реальные старты бота и отправки формы.

В разрезах можно сравнивать показатели по любому UTM-ключу. Источник также отображается в карточке подписчика.

14

Google Таблицы

Каждая форма может записывать ответы в отдельную таблицу пользователя.

  1. Откройте формуПерейдите на вкладку «Конструктор» и включите синхронизацию с Google Таблицами.
  2. Укажите ссылкуВставьте полную ссылку на таблицу пользователя и название листа.
  3. Выдайте доступДобавьте sheets@studiya-508122.iam.gserviceaccount.com в редакторы таблицы.
  4. Сохраните формуПлатформа проверит доступ и возможность записать заголовки.
Настройка привязана к формеОтветы записываются именно в таблицу, указанную в этой форме. Глобальная таблица из окружения не используется.
15

amoCRM

Автоматическое создание сделки и контакта после заполнения формы.

Подключение amoCRM в настройках проекта

Подключение аккаунта

  1. Создайте приватную интеграциюВ amoCRM откройте «Настройки → Интеграции», создайте интеграцию и укажите Redirect URI вашей СТУДИИ.
  2. Скопируйте ключиВам понадобятся ID интеграции, секретный ключ и временный код авторизации.
  3. Откройте настройки проектаВ блоке amoCRM нажмите «Подключить» и укажите домен аккаунта вместе с полученными данными.
  4. При необходимости задайте воронкуID воронки и этапа необязательны. Без них amoCRM использует первый этап главной воронки.
  5. Проверьте соединениеПлатформа обменяет код на OAuth-токены и покажет название подключённого аккаунта.

Передача формы

Откройте форму и включите «Передавать ответы» в карточке amoCRM. После каждого успешного заполнения платформа создаст сделку, добавит контакт и прикрепит примечание со всеми ответами. Поля типов «Телефон» и «Email» попадут в стандартные поля контакта. Результат передачи отображается в колонке «Интеграции» на вкладке ответов.

Безопасное хранениеOAuth-токены и секрет интеграции шифруются ключом платформы и изолированы внутри проекта. Access token обновляется автоматически через Refresh token.
Ограничения APIЗапросы выполняются через очередь с учётом лимита amoCRM. Ошибка передачи фиксируется в журнале и не мешает сохранить ответ формы внутри СТУДИИ.

Техническая справка: OAuth-интеграции и API сделок amoCRM.

16

Статусы

Как читать состояния объектов и задач.

ЧерновикМожно свободно редактировать.
ЗапланированоЖдёт указанного времени.
ВыполняетсяИдёт отправка по одному или двум каналам.
ЗавершеноВсе получатели обработаны.
Завершено с ошибкамиЕсть технические сбои, доступно продолжение.
ОтмененоЗапуск остановлен пользователем.
17

Безопасные действия

Операции с потерей данных требуют отдельного подтверждения.

Подтверждение появляется при удалении рассылки, формы, подписчика, сегмента, переменной, узла, Inline-кнопки и при восстановлении версии сценария.

Проверьте проектПеред удалением убедитесь, что в селекторе сайдбара выбран нужный проект. Удаление выполняется только в его контексте.
18

Диагностика

Что проверить перед обращением к администратору платформы.

Бот не отвечает на /start

Проверьте, включён ли канал, сохранён ли токен и назначен ли стартовый узел. После замены токена снова сохраните интеграции.

Рассылка остановилась

Откройте её историю и посмотрите прогресс отдельно по каналам. Для технических ошибок используйте продолжение — обработанные получатели повторно не отправятся.

Пользователь не получил сообщение

Статус «Недоступно» обычно означает блокировку бота или удалённый аккаунт. Такие профили можно очистить по итогам рассылки.

Форма не пишет в Google Таблицу

Проверьте ссылку, название листа и доступ редактора для сервисного аккаунта. Повторно сохраните форму, чтобы запустить проверку.

Форма не создаёт сделку в amoCRM

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

Сценарий не доходит до узла

Запустите «Проверку» в хедере Флоу. Исправьте битые переходы и убедитесь, что узел достижим от стартового сценария.