Подключение и настройка MAX
- Как создать нового бота →
- Как добавить описание бота →
- Как добавить фото профиля бота →
- События для MAX →
Как создать нового бота
Создание и настройка ботов в MAX происходит с помощью официального бота @MasterBot.
1. Пройдите регистрацию в мессенджере MAX, если вы открыли его впервые.
2. Найдите в поиске мессенджера @MasterBot
3. Отправьте боту команду /create
4. Отправьте ник бота. Ник будет отображаться в публичной ссылке как в этом примере — max.ru/nicknamebot.
Ник невозможно изменить или отредактировать, поэтому внимательно проверьте его перед отправкой.
5. Введите имя бота и отправьте его. Имя будет отображаться в контактах и чатах.
Имя бота должно начинаться с латинской буквы. Прибавьте к нику обязательное окончание «bot» — слитно или через одно нижнее подчёркивание. Готовый ник должен выглядеть примерно так: nicknamebot или nickname_bot. В нике должно быть не менее 11 символов с учетом окончания bot.
6. После этого @MasterBot пришлет токен бота вместе с кнопками для быстрого редактирования бота. Скопируйте токен, вернитесь в настройки Ботмамы, активируйте платформу с помощью переключателя и вставьте полученный токен в поле для токена платформы MAX.
Токен — это прямой доступ к боту. Не рекомендуем хранить его в открытых источниках или передавать посторонним — они смогут завладеть ботом и управлять им от вашего имени. Если вы опасаетесь, что токен скомпрометирован, отзовите его и сгенерируйте новый
Для работы с токеном вы можете использовать следующие команды:
/get_token — показать действующий токен
/refresh_token — обновить токен
/revoke — отозвать текущий токен
7. Нажмите кнопку Сохранить в правом нижнем углу.
8. После этого появится кнопка для перехода в бота — Открыть бота в MAX. По этой кнопке вы сможете перейти в диалог с ботом.
Во время работы бота через Botmother, полученный токен может использоваться только в нашем сервисе. Если подключить токен работающего на нашей платформе бота в еще какой-либо сервис, то бот может перестать работать или работать нестабильно, а пользователи могут заблокироваться для отправки рассылок.
Как добавить описание бота
Описание бота — это короткий текст, который пользователи увидят еще не написав боту.
В описании вы можете указать что умеет бот и чем он может быть полезен.
1. Откройте бот @MasterBot и отправьте ему команду /set_description
2. Выберите бота, описание которого вы хотите изменить.
3. Введите новое описание вашего бота и отправьте его.
В описании должно быть не более 512 символов
Как добавить фото профиля бота
Рекомендуем добавить фото, так как с ним ваш бот будет заметнее в списке чатов.
1. Откройте бота @MasterBot и отправьте ему команду /set_picture
2. Выберите бота для которого вы хотите поменять фото профиля.
3. Отправьте боту фото как картинку. Если отправите как файл, @MasterBot пришлет ошибку.
События для MAX
Для MAX есть специальные события, которые поддерживаются только на этой платформе и на платформе ТамТам:
- Сообщение удалено (TamTam и MAX) → вызывается удалением сообщения от пользователя,
- Сообщение изменено (TamTam и MAX) → вызывается редактированием сообщения от пользователя,
- Бот добавлен в чат или канал (TamTam и MAX) → вызывается добавлением бота в чат или канал,
- Пользователь добавлен в чат или канал (TamTam и MAX) → вызывается добавлением пользователя в чат или канал,
- Пользователь удален из чата или канала (TamTam и MAX) → вызывается удалением пользователя из чата или канала,
- Название чата изменено (TamTam и MAX) → вызывается редактированием названия чата где бот имеет права администратора.