База знаний Bot Builder

О сервисе

Один бот — это один сценарий и одно подключение к выбранному каналу. Настройки каждого бота изолированы: кнопка настройки на карточке открывает только его данные, а токены после сохранения не показываются в браузере.

Первый сценарий за несколько минут

1. В кабинете нажмите «Создать бота», задайте название и выберите канал.
2. Откройте карточку созданного бота. На схеме уже есть защищённый блок «Старт» — это единственная точка начала сценария.
3. Добавьте «Сообщение», соедините его со «Стартом» стрелкой, дважды нажмите на блок и напишите первый ответ.
4. Сохраните сценарий. После подключения канала включите бота и отправьте ему тестовое сообщение.

Блоки и схема

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

Что делает каждый блок

• Старт — начало диалога. Его нельзя удалить или заменить.
• Сообщение — текст ответа и кнопки, которые ведут на следующие ветки либо открывают ссылку.
• Условие — направляет пользователя в нужную ветку по правилу.
• Задержка — ждёт заданное время перед продолжением; используйте её для последовательной выдачи материалов, до 7 дней.
• Действие — записывает тег или поле, передаёт диалог оператору либо отправляет данные во внешний сервис.
• Случайный выбор — распределяет переходы между несколькими вариантами.
• Переход — продолжает сценарий с другого блока без дублирования схемы.
• Расписание — запускает ветку один раз, ежедневно или по дням недели.

Подключение каналов: общие правила

• Подключайте только аккаунт, сообщество или чат-бот, которыми вы вправе управлять.
• Открывайте настройки именно нужной карточки бота. Не используйте ссылку callback, токен или secret другого бота — даже в рамках одного кабинета.
• Токен равен паролю к управлению ботом. Не присылайте его в чат, не добавляйте в документы и не показывайте на скриншотах.
• После замены или отзыва токена на стороне сети сразу повторите подключение в Bot Builder.

Подключение VK

Для работы нужны права администратора сообщества VK. Подключение состоит из двух частей: доступ к API и сервер Callback API.

1. Подготовьте сообщество

1. Откройте нужное сообщество VK и перейдите в Управление → Сообщения. Разрешите сообщения сообществу.
2. Перейдите в Управление → Работа с API. На вкладке ключей доступа создайте ключ сообщества с разрешением на сообщения. Сразу сохраните токен в надёжном месте.
3. На странице Callback API подготовьте или создайте сервер и задайте secret key. Скопируйте код подтверждения, который показывает VK.

2. Свяжите сообщество с Bot Builder

1. В Bot Builder откройте нужного VK-бота → Настроить канал.
2. Вставьте токен сообщества, ID сообщества, secret key и код подтверждения из VK. Сохраните настройки.
3. Скопируйте показанный сервисом Callback URL — он уникален для этого бота.
4. Вернитесь в VK: Управление → Работа с API → Callback API → Серверы. Вставьте именно этот Callback URL, выберите актуальную версию API и активируйте сервер.
5. В списке событий включите Входящее сообщение (message_new). Secret key в VK должен совпадать с тем, который введён в Bot Builder.

3. Проверьте

1. Убедитесь, что бот в кабинете включён и сценарий сохранён.
2. Напишите сообществу с обычного тестового аккаунта VK, а не из настроек администратора.
3. Проверьте, что пришло первое сообщение сценария. Затем нажмите каждую кнопку и пройдите ветви.

Справка VK по Callback API.

Подключение Instagram

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

Перед подключением

• Переведите профиль в профессиональный тип: Автор или Бизнес. Личные закрытые аккаунты для такого подключения не подходят.
• Войдите в тот Instagram-аккаунт, который будет подключаться. При необходимости проверьте доступ к сообщениям и настройкам профиля.
• Рекомендуется привязать управляемую Facebook Page: это расширяет набор профессиональных инструментов и упрощает управление доступами.

Подключение

1. Создайте Instagram-бота и откройте его карточку.
2. Нажмите «Подключить Instagram». Откроется официальный экран Instagram.
3. Войдите в нужный аккаунт, внимательно выберите его и подтвердите запрошенные разрешения.
4. После возврата в Bot Builder дождитесь статуса «Подключено». Приём и отправка сообщений будут настроены автоматически.
5. Включите бота, сохраните сценарий и отправьте тестовое личное сообщение профилю.

Meta подтверждает, что профессиональные аккаунты бывают типов Creator и Business; подробнее — в справке Instagram.

Подключение Telegram

Для подключения нужен токен чат-бота, созданного через официальный @BotFather.

1. Подготовьте бота

1. Откройте @BotFather в Telegram и создайте бота командой /newbot.
2. Сохраните выданный токен в надёжном месте. Он даёт полный доступ к управлению ботом.
3. Пользователь должен первым открыть чат и написать боту: Telegram не позволяет боту начинать личный диалог самостоятельно.

2. Подключите в конструкторе

1. Создайте Telegram-бота в Bot Builder и откройте его карточку.
2. Нажмите «Настроить Telegram», вставьте токен и подтвердите подключение.
3. Bot Builder проверит токен и сам зарегистрирует защищённый webhook.
4. Сохраните сценарий, включите бота и отправьте ему тестовое сообщение.

Особенности сценария

• Один ответ Telegram может содержать до 4096 символов.
• Варианты из блока «Сообщение» приходят пользователю как нумерованный список. Для обработки выбора добавьте в схему условие с ожидаемым текстом ответа.
• Блок «Действие → Передать менеджеру» приостанавливает автоответы. В разделе «Диалоги» менеджер сможет ответить вручную; затем автоответы можно вернуть кнопкой «Вернуть автоответы».

Если нужно заменить токен

1. В @BotFather отзовите прежний токен и получите новый.
2. Откройте того же Telegram-бота в Bot Builder → «Настроить Telegram».
3. Вставьте новый токен и подтвердите подключение. Сервис обновит его и зарегистрирует новый защищённый webhook автоматически.

Подключение MAX

MAX выдаёт токен после создания и модерации чат-бота. В Bot Builder достаточно ввести этот токен: сервис сам настроит обмен сообщениями.

1. Получите токен MAX

1. Зарегистрируйтесь на партнёрской платформе MAX и создайте профиль, если его ещё нет.
2. Откройте раздел «Чат-боты», создайте чат-бота и заполните данные для модерации.
3. Дождитесь успешной модерации. Затем откройте Чат-боты → Перейти → Расширенные настройки → Настроить.
4. Скопируйте токен бота. Не передавайте его третьим лицам.

2. Подключите в конструкторе

1. Откройте карточку нужного MAX-бота в Bot Builder → Настроить канал.
2. Вставьте токен и подтвердите подключение. Сервис проверит токен и автоматически подготовит бота к приёму сообщений.
3. Сохраните и включите сценарий.
4. Откройте диалог с ботом в MAX, запустите его и отправьте тестовое сообщение.

Официальная инструкция MAX о создании ботов и получении токена.

Проверка перед запуском

1. Создайте отдельный тестовый сценарий либо используйте тестовый аккаунт пользователя.
2. Пройдите путь от «Старт» по всем кнопкам, условиям и веткам; проверьте ссылки и тексты.
3. Проверьте задержки: пользователь должен получать части прайс-листа или инструкции в нужном порядке.
4. Откройте «Диалоги» и убедитесь, что входящее сообщение появилось, а ответ зафиксирован.
5. Только после этого включайте продвижение, публикации и рекламу.

Диалоги, аналитика и управление

В карточке бота доступны его диалоги и показатели. Используйте диалоги для проверки обращений и передачи человека оператору, а аналитику — для оценки запусков и переходов.

• Включён — принимает события и выполняет сценарий.
• Пауза — временно не отвечает; сценарий и настройки остаются сохранёнными.
• Черновик — подключение или запуск ещё не завершены.

Чтобы изменить текст или связи, остановка не требуется, но после важных изменений обязательно сохраните сценарий и проведите повторный тест.

Тариф и доступ

В разделе аккаунта доступны текущий тариф, лимиты и оформление запроса на оплату. Старт — 790 ₽ за 30 дней и 1 бот; Бизнес — 1 490 ₽ за 30 дней и до 3 ботов; Студия — 2 990 ₽ за 30 дней и до 10 ботов.

Во все тарифы входят доступные каналы, визуальный конструктор и база знаний. Один бот — это один сценарий и одно подключение к выбранному каналу: например, Telegram-бот или виджет сайта. Ограничения проверяются до запуска функций, поэтому при окончании доступа данные и схема бота не удаляются. После продления можно продолжить работу с прежними настройками.

Реквизиты и порядок оплаты опубликованы на странице «Реквизиты и оплата».

Безопасность и допустимое использование

• Не используйте ботов для спама, фишинга, сбора паролей, PIN/CVV, вредоносных ссылок и запрещённых товаров.
• Не публикуйте токены и не отправляйте их поддержке открытым текстом. Если нужен разбор ошибки, достаточно названия бота, канала, времени ошибки и скриншота без секретов.
• Работая на чужом компьютере, завершайте сессию кнопкой «Выйти».
• При увольнении сотрудника или смене подрядчика отзовите его доступ и при необходимости обновите токен канала.

Решение проблем

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

1. Проверьте, что бот включён, канал отмечен подключённым, а сценарий сохранён.
2. Проверьте связь от «Старт» до первого «Сообщения» и далее по нужной ветке.
3. Проверьте входящим сообщением с отдельного тестового аккаунта.
4. Откройте диалоги и журнал конкретного бота: это помогает определить, дошло ли событие от сети.

Telegram-бот не отвечает

1. Убедитесь, что пользователь первым написал боту и бот отмечен как подключённый и включённый.
2. Проверьте, что в сценарии есть путь от «Старт» к заполненному блоку «Сообщение».
3. Если в диалоге включён ручной режим, ответьте из раздела «Диалоги» либо нажмите «Вернуть автоответы».
4. После замены токена повторите подключение Telegram-бота в Bot Builder.

Ошибка подключения

Проверьте права и актуальность токена на стороне сети. Для Telegram создайте новый токен через @BotFather, если прежний отозван или мог стать известен постороннему. Для VK отдельно сопоставьте четыре значения: токен, ID сообщества, secret key и код подтверждения. Для MAX создайте новый токен при сомнениях в его безопасности. Для Instagram не вводите секреты вручную — повторите официальный вход либо обратитесь в поддержку, если Login не настроен.

Сайт открывается некорректно

Обновите страницу с очисткой кэша и проверьте, разрешён ли JavaScript. Если это не помогло, обратитесь в поддержку и приложите скриншот проблемы.