+7 (999) 881-15-11

«Арете — сервер мессенджеров, Max edition»

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

Демобот — встроенная обработка АСМ_ДемонстрационныйБот. Это учебный сценарий: меню, файлы, шаблонизатор, типы кнопок, ответы на геоточку и контакт. Его подключают к уже созданной карточке бота, а не вместо установки расширения.

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

Нужны установленное расширение, лицензия и инициализация подсистемы — см. руководство по установке. Нужна карточка бота с токеном и приёмом событий (для начала — polling) — см. создание первого бота, шаги до обработчика. Команда «Кто я» в карточке уже должна возвращать JSON.

Зачем он нужен

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

Как подключить

  1. Раздел АСМ → Первые шаги → Демонстрационный бот.
  2. Команда Подключить обработчик откроет запись регистра АСМ — Обработчики с уже подставленными полями: расположение «Внутренняя обработка», имя АСМ_ДемонстрационныйБот, модуль объекта.
  3. Укажите своего бота из справочника, включите «Используется», запишите.
  4. При подключении вызовется ИнициализацияОбработчика: в базу попадут шаблоны и состояния демо.

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

Что создаётся при инициализации

Шаблоны в справочнике АСМ — Шаблоны с кодами вроде Демонстрационный, ШаблонУсловия, ШаблонЦикл, ШаблонОбласти, ШаблонСборка. Состояния, которые демо использует в диалоге (счётчик обращений, идентификатор последнего сообщения). Повторное подключение добавит версию шаблона «По умолчанию» сверху и сделает её актуальной — правки в предприятии останутся в истории. Это же поведение описано в руководстве по шаблонизатору.

Что попробовать в Max

  1. Откройте диалог с ботом или отправьте /start — приветствие и клавиатура.
  2. /menu или кнопка «Меню» — набор демонстраций API.
  3. /help — текст справки из шаблона.
  4. /template — примеры шаблонизатора: условия, цикл, области, сборка.
  5. Отправьте фото, геоточку или контакт — бот должен ответить по соответствующему роуту.

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

Где смотреть код

Модуль объекта обработки АСМ_ДемонстрационныйБот в конфигураторе — полный сценарий: СведенияОбОбработчике, СобратьРоутер, ОбработатьСобытие и процедуры маршрутов.

Тот же текст выложен файлом: ДемонстрационныйОбработчик.bsl. Разбор строк условий — в руководстве по роутингу, макетов — в руководстве по шаблонизатору.

Частые ошибки