Как запустить чат-бота в MAX и в Telegram одним сценарием

Что настроим

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

Что нужно заранее

• Тариф с чат-ботами. На тарифе «Базовый» можно подключить одного бота, на «Оптимальном» трёх. MAX занимает место в этом лимите, когда вы добавляете его в первый сценарий магазина. Сколько мест занято, видно на странице «Чат-боты» в строке «Боты».

• Бот MAX. Зарегистрируйте его на business.max.ru и скопируйте токен.

• Для шаблона «Возврат товара»: системный Telegram-бот владельца для уведомлений. Заявки на возврат приходят на согласование в Telegram и в кабинет, в том числе заявки из MAX.

Шаг 1. Подключите MAX

1. Откройте business.max.ru и выберите бота.

2. Перейдите в «Настройки». В блоке «Чат-бот» скопируйте «Токен доступа» кнопкой справа от поля.

Токен скрыт точками, кнопка копирования справа от поля.

1. В Рефсейлс откройте «Настройки» → «Интеграции» → «MAX Мессенджер».

2. Вставьте токен в поле «Токен бота».

3. Нажмите «Подключить».

Шаг 2. Добавьте сценарий

1. Откройте раздел «Чат-боты».

2. В блоке «Готовые сценарии» нажмите на карточку «Возврат товара». Сценарий добавится, а карточка получит отметку «Добавлен» и будет открывать его. Свой сценарий с нуля создаётся кнопкой «Создать сценарий».

Новый сценарий привязывается к первому боту магазина. MAX и другие боты добавляются в редакторе на следующем шаге.

Шаг 3. Выберите ботов сценария

1. В верхней панели редактора откройте поле со списком ботов. Если боты ещё не выбраны, в нём написано «Выберите ботов».

2. Отметьте «MAX @имя_бота». Чтобы сценарий работал и в Telegram, оставьте отмеченным Telegram-бота.

3. Проверьте тексты сценария и включите его переключателем в правой части панели: подпись сменится на «Включён».

Каждая отметка сохраняется сразу. Если сервер откажет, например из-за лимита тарифа, отметка снимется и появится сообщение с причиной.

Шаг 4. Возьмите ссылку на бота

Нажмите на блок «Точка входа /start» в сценарии. В панели справа, в поле «Ссылки на ботов», будет ссылка на каждого бота сценария. Ссылка на MAX выглядит так:

https://max.ru/имя_бота?start=метка

Метку из ссылки бот получает при старте, по ней можно запускать разные точки входа. Ссылка без метки открывает бота с обычным /start.

Как проверить, что работает

1. Откройте ссылку на бота в MAX и отправьте /start. Бот пришлёт первое сообщение сценария.

Сценарий «Возврат товара» в MAX. Под сообщением без своих кнопок стоит «В начало».

1. Откройте раздел «Чат». Переписка с ботом появится в диалоге MAX, над полем ввода будет плашка «Ведёт бот» с названием сценария.

2. Для сценария «Возврат товара» пройдите возврат до конца. Заявка появится в «Заказы» → «Заявки на возврат», в блоке «Заявки из чат-бота». В уведомлении о заявке будет строка «Канал: MAX».

Чем MAX отличается от Telegram

• Блок «Оплата» в MAX не работает. Если среди ботов сценария есть MAX, редактор не сохранит сценарий с этим блоком и покажет ошибку «Оплата» не работает в MAX. Уберите MAX из ботов сценария или удалите блок.

• Блок «Доступ в группу» работает только в сценарии с одним Telegram-ботом. Группой управляет конкретный бот, поэтому такой сценарий не включить в MAX или во второй Telegram-бот.

• В MAX нет постоянной клавиатуры под полем ввода, как в Telegram. Под сообщением бота без своих кнопок стоит кнопка «В начало», она запускает сценарий заново. Ещё в меню бота есть команда /start «Начать сначала».

• Пока у магазина включён сценарий с MAX, ИИ-консультант на сообщения в MAX не отвечает: диалог ведёт бот.

Если не работает

• При выборе MAX появилось сообщение о лимите ботов. Все места тарифа уже заняты. Отключите лишнего бота или смените тариф.

• В списке ботов вместо имени «Бот отключён». Бот из сценария отключили в настройках. Подключите его снова или снимите отметку.

• Сценарий не включается, появляется «Выберите бота для сценария». У сценария нет ни одного подключённого бота. Отметьте бота в верхней панели редактора.

• Бот перестал отвечать клиенту после ответа менеджера. Ответ менеджера в диалоге ставит бота на паузу, над полем ввода видно «Бот на паузе». Нажмите «Вернуть боту» или попросите клиента нажать «В начало».

• Отключили Telegram-бота, а сценарий выключился. Сценарий выключается, только если у него не осталось других подключённых ботов. Если в сценарии отмечен MAX, сценарий продолжит работать в MAX.

Частые вопросы

Можно ли включить один сценарий в двух Telegram-ботах и в MAX?

Да. В редакторе сценария, в поле со списком ботов в верхней панели, отметьте всех нужных ботов. Сценарий будет отвечать в каждом из них. Исключение: сценарий с блоком «Доступ в группу» работает только в одном Telegram-боте, а сценарий с блоком «Оплата» не работает в MAX.

Сколько места в лимите ботов занимает MAX?

Одно место, когда MAX отмечен хотя бы в одном сценарии магазина. Если MAX уже есть в одном сценарии, добавление его в другие сценарии лимит не меняет. Пока MAX подключён только для чата и ни в одном сценарии не отмечен, место он не занимает.

Видно ли, из какого мессенджера пришла заявка на возврат?

Да. В разделе «Заказы» → «Заявки на возврат» у каждой заявки из чат-бота указан канал: Telegram или MAX. В уведомлении о новой заявке есть строка «Канал».

Как клиенту начать сценарий заново в MAX?

Нажать кнопку «В начало» под сообщением бота или отправить команду /start, она есть в меню бота. Сценарий начнётся с первого сообщения.