Подключение MAX
MAX — это быстрое и лёгкое приложение для обмена сообщениями, которое работает на любых устройствах — смартфонах и компьютерах. В него также встроена платформа мини-приложений, конструкторы чат-ботов и платёжная система.
В MAX можно бесплатно отправлять любые виды сообщений, видео, фотографий и файлы объёмом до 4 ГБ. Приложение поддерживает высокое качество голосовых и видеозвонков — они работают даже на слабых устройствах и при низкой скорости интернета.
Содержание
Как создать нового бота
1. Пройдите регистрацию в мессенджере MAX, если вы открыли его впервые.
2. Найдите в поиске мессенджера @MasterBot и откройте диалог с ним.
3. Нажмите «Начать» и отправьте боту команду /create
Важно! На данный момент создание ботов в MAX работает не у всех пользователей. Если у вас не получается создать бота, зарегистрируйтесь на платформе MAX для партнёров по этой инструкции: https://dev.max.ru/docs/maxbusiness/connection
4. Отправьте ник бота. Ник будет отображаться в публичной ссылке как в этом примере — max.ru/nicknamebot
Ник невозможно изменить или отредактировать, поэтому внимательно проверьте его перед отправкой
5. Введите имя бота и отправьте его. Имя будет отображаться в контактах и чатах.
Имя бота должно начинаться с латинской буквы. Прибавьте к нику обязательное окончание «bot» — слитно или через одно нижнее подчёркивание. Готовый ник должен выглядеть примерно так: nicknamebot или nickname_bot. В нике должно быть не менее 11 символов с учетом окончания bot.
6. После этого @MasterBot пришлёт токен бота вместе с кнопками для быстрого редактирования бота. Скопируйте токен и пришлите нам на почту support@usedesk.ru. Далее мы в поддержке сами создадим вам новый канал для интеграции с ботом.
Токен — это прямой доступ к боту. Не рекомендуем хранить его в открытых источниках или передавать кому-либо ещё — посторонние могут завладеть ботом и управлять им от вашего имени. Если вы опасаетесь, что токен скомпрометирован, отзовите его, сгенерируйте новый и сообщите нам об этом на почту support@usedesk.ru.
Для работы с токеном вы можете использовать следующие команды:
- /get_token — показать действующий токен
- /refresh_token — обновить токен
- /revoke — отозвать текущий токен
Как добавить описание бота
Описание бота — это короткий текст, который пользователи увидят до того, как напишут боту. В описании вы можете указать, что умеет бот и чем он может быть полезен.
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) → вызывается редактированием названия чата где бот имеет права администратора.