Подключение 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 есть специальные события, которые поддерживаются только на этой платформе и на платформе ТамТам: