For the complete documentation index, see llms.txt. This page is also available as Markdown.

МАХ-bot

Подключение канала Max позволяет вести переписку через Max с помощью Савви и настраивать чёрные и белые списки учётных записей.

Подключение МАХ-bot

1

В разделе Каналы выбираем Бот Мax

2

Видим поле для введения токена

3

В Мах переходим в @MasterBot

Кликаем по кнопке Начать:

4

Станьте партнёром Мах

Пользоваться платформой MAX для партнёров, включая чат-ботов, мини-приложения и каналы, могут только российские юрлица и ИП — то есть резиденты РФ.

Если же Вы пока не являетесь партнёром, то создать подключение в Max, к сожалению, не получится — если мы нажмём по кнопке Начать, то получим такие сообщения:

5

Создание агента в Max

Создание подключения в Max делится на 2 этапа: Создание с настройками и Модерация

Создание включает следующие этапы (Подробнее: https://dev.max.ru/docs/chatbots/bots-create):

  1. Перейдите в профиль вашей организации на платформе

  2. В разделе Чат-боты нажмите Создать

  3. Заполните данные в настройках подключения и нажмите Создать

После выполнения этих шагов подключение будет проходить модерацию.

Модерация

Сразу после создания подключение получает статус «на модерации». Проверка занимает до 48 рабочих часов. Подробнее по статусам — в подразделе «Статусы модерации»

6

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

По итогам модерации вам открывается доступ к токену подключения. Используя его, вы сможете донастраивать сценарии, активировать другие возможности и интегрировать партнёрские сервисы. Токен размещён на платформе по пути: «Чат-боты» → «Интеграция» → «Получить токен» — в поле с аналогичным названием.

Подробнее о получении токена можно ознакомиться по ссылке: https://dev.max.ru/docs/chatbots/bots-create

7

Подключение к Савви:

Вставляем полученный токен в строку Токен:

Нажимаем Подключить

8

Настройки

После подключения у нас автоматически прописываются параметры:

ID агента — ID, получаемое на стороне Max

Имя агента — имя, указанное в настройках Max

Ник — ник агента, генерируемый автоматически в Max

Токен — полученный токен из Max

Изменить токен — позволяет провести переподключение через новый токен, полученный в Max

Сообщение при запуске агента — на стороне Савви уже прописываем приветствие при запуске агента

9

Настройка Чёрного списка

Если мы хотим ограничить некоторым пользователям общение с агентом, то нужно воспользоваться настройкой Чёрный список. Чтобы прописать username потенциального клиента, нужно нажать на кнопку Добавить:

UserID можно указать через @userinfobot

10

Проверка подписки

Позволяет проверять подписку на группы в Мах или каналы, для этого нужно в соответствующем окне прописать ID этих групп/ каналов через запятую

Также можно прописать сообщение об ошибке подписки

11

Очистка истории

Можно очищать прошлую историю при запуске агента. Для этого нужно перетянуть флаг:

12

Ответы в группе

Также можно настроить ответы агента в группе МАХ

Ответы в группу — настройка позволяет агенту отвечать в группу

Отвечать только на те сообщения, где его вызовут — агент будет отвечать только на реплики, где его упомянули. Можно добавить ключевые слова, по которым агент будет понимать, что нужно отвечать на сообщение

Проверять подписку на группу — позволяет проверить подписку на группу и в случае неудовлетворительного результата можно прописать сообщение об ошибке

Сохранять ли все сообщения — позволяет сохранить все сообщения, которые были в переписке

Добавлять ли префикс с информацией об отправителе — позволяет добавить краткую информацию об отправителе

13

Не забываем сохранить

После внесения всех настроек в агента нажимаем по кнопке Сохранить справа внизу:

Последнее обновление

Это было полезно?