Боты

Бот в Чат-бот агенте — это набор файлов на диске: настройки и сценарий диалога. Файлы и есть бот целиком. Их видно, их можно скопировать, их можно править как в интерфейсе, так и прямо на сервере. Ничего дополнительно экспортировать не нужно: перенос бота на другой сервер — это копирование его папки.

Создание бота

Самый простой путь — нажать «Создать бота», ввести имя и вставить токен от @BotFather. Токен — это секретный ключ доступа бота, его выдаёт Telegram; через него приложение подключается к мессенджеру. Если настоящего бота пока нет, заведите тестового: он работает на эмуляторе, встроенном в приложение, и ни Telegram, ни интернет не нужны.

При создании можно выбрать шаблон — заготовку сценария под типовую задачу — или попросить ИИ написать первый черновик: опишите назначение бота обычными словами, и приложение предложит готовый сценарий. Черновик показывается целиком, и применяется только после вашего подтверждения.

Тестовый бот при первом запуске

На свежей установке уже есть выключенный демонстрационный бот на эмуляторе — его можно включить и потрогать, чтобы понять, как всё устроено. Если файлов ботов нет вообще, экран сам предложит создать первого бота или сгенерировать его с помощью ИИ.

Запуск и остановка

Кнопки «Запустить» и «Стоп» задают желаемое состояние бота: запущенный бот принимает и обрабатывает сообщения, остановленный — нет, новые сообщения не обрабатываются. После перезапуска приложение возвращает ботов в то состояние, которое вы задали. Если файл настроек разрешает запуск, но вы остановили бота в интерфейсе, победит ваше решение — оно и есть желаемое состояние.

Правка файлов снаружи

Файлы ботов отслеживаются. Сохранили сценарий на диске — приложение подхватит новую версию за несколько секунд, без перезапуска сервера. Идущие разговоры при этом не обрываются: человек, который сейчас общается с ботом, продолжит с того же места. Так можно править бота и в интерфейсе, и в своём редакторе — результат один.

Если в файле ошибка

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

Версии

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

Чек-лист публикации

Перед публикацией бота полезно пройти чек-лист — набор из 11 машинных проверок по текущему сценарию и состоянию. Каждая проверка получает одно из трёх значений: пройдено, предупреждение или ошибка. Итоговый вердикт «готов» выносится, только если ошибок нет; предупреждения его не отменяют, но показывают, что стоит поправить.

  • сценарий корректен, без обрывов и лишних связей;
  • токен жив — бот действительно может подключиться;
  • заданы служебные потоки (что делать при непонятном вводе, при молчании клиента, при завершении);
  • приветствие понятное и по делу;
  • сообщения не захламлены лишними знаками и повторами;
  • из каждого шага видно, как вернуться в меню;
  • до передачи оператору действительно можно дойти;
  • нет тупиков, где разговор обрывается;
  • нет непроверенных путей, которые не тестировали;
  • ввод клиента покрыт проверками (телефон, почта, число);
  • у ссылок заполнены метки источника, чтобы потом видеть, откуда пришли люди.

Список ботов

Раздел «Боты» показывает все ваши боты: имя, состояние (работает или остановлен), вердикт готовности и значок проблем. Отсюда одним нажатием переходят в студию, на страницу бота с настройками или в эмулятор. Если у бота есть проблемы, у пункта «Боты» в боковом меню появляется счётчик.

Экспорт и перенос

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

Дальше: как собрать диалог мышкой — в разделе Студия сценариев, как проверить бота без Telegram — в разделе Эмулятор, публичная страница чата и виджет — в разделах Чат-комната на сайте и Виджет для сайта.

← Оглавление документации