MAX

Создание бота

Чат-боты умеют решать типовые задачи прямо в MAX. Создайте бота, который будет делать что-то за вас — например, присылать расписание на день или подсказывать упражнения в зале

Даже без навыков программирования сделать своего бота в приложении просто — придумайте сценарий и следуйте пошаговой инструкции.

Регистрация бота в MAX

1. Найдите в поиске MAX @MasterBot и начните с ним чат

2. Нажмите команду /create, чтобы создать бота

1. Отправьте ник бота. Ник будет отображаться в публичной ссылке как в этом примере — max.ru/nicknamebot. Ник невозможно изменить или отредактировать, поэтому внимательно проверьте его перед отправкой

• Начните ник с латинской буквы, дальше можно добавить цифры. Напишите не менее 7 символов

• Прибавьте к нику обязательное окончание «bot» — слитно или через одно нижнее подчёркивание. Другие символы использовать нельзя. Готовый ник должен выглядеть примерно так: nicknamebot или nickname_bot

1. Отправьте имя бота — до 16 символов. Имя будет отображаться в чате с вашим ботом,сверху

2. Как только @MasterBot получит имя, вам придёт токен — уникальный идентификатор бота, с помощью которого он будет взаимодействовать с API MAX. Наличие токена означает, что бот зарегистрирован в MAX

1. Отправьте команду /set_description, чтобы добавить описание бота. Этот текст пользователи увидят до того, как начнут с ним общение. Напишите, что умеет бот и чем он может быть полезен — не более 512 символов

1. Отправьте команду /set_picture, если хотите добавить фото профиля бота. С ним он будет заметнее в списке чатов

1. Теперь самое интересное — надо продумать логику ответов бота и написать фразы, которыми он будет «разговаривать» в чате. Вам понадобится конструктор.

Как работать с конструктором

1. Выберите конструктор, перейдите на его сайт и зарегистрируйтесь. Рекомендуем работать на компьютере — в мобильной версии некоторые функции конструктора могут быть недоступны

1. Заполните блоки и кнопки, настройте сбор данных, чтобы проанализировать эффективность вашего сценария после запуска бота

2. Бота с настроенным сценарием можно подключать к приложению. Для этого в настройках конструктора необходимо найти MAX, добавить в специальное поле токен бота из сообщения @MasterBot и активировать интеграцию кнопкой или переключателем. Перейдите в приложение. Ваш бот готов!

Inline-клавиатура

Такая клавиатура может иметь до 210 кнопок, сгруппированных в 30 рядов — до 7 кнопок в каждом. Если ряды кнопок не помещаются в плейсхолдер клавиатуры, автоматически подключается скролл

Поддерживаемые типы кнопок

• callback — сервер MAX отправляет событие с типом message_callback (через Webhook или Long polling)

• link — позволяет пользователю открыть ссылку в новой вкладке

• request_contact — запрашивает у пользователя разрешение на доступ к контактам — нику или телефону

• request_geo_location — запрашивает у пользователя его местоположение

Подключение мессенджера

После того как вы создали бота в мессенджере, необходимо перейти в раздел "Каналы" в Сейлбот:

В разделе каналы нажимаем на “MAX” для ввода токена, который вы скопировали ранее при создании бота:

Вставьте скопированный токен и нажмите на “Готово”:

При запуске бота, в диалоге с клиентом появится сообщение /start

Как получить полный вебхук

Для получения полного вебхука от Max достаточно присвоить любое значение переменной save_webhook(переменная может быть как константой проекта, так и переменной сделки).

При этом ответ из мессенджера будет записываться в переменную tt_request, которую вы найдете в карточке клиента среди переменных сделки

Max поддерживает кнопки callback, кнопки с ссылкой, запрос номера телефона, запрос геолокации

Если клиент нажмет на кнопку с запросом номера и даст разрешение, в чат поступит сообщение с его номером телефона и появится переменная phone

Если клиент поделится своей геолокацией, данные поступят в виде сообщения, и будут созданы переменные latitude и longitude

Доступные коллбеки

bot_added - подключенный бот добавлен в групповой чат/канал

bot_removed - подключенный бот удален из группового чата/канала

user_added - в групповой чат добавлен новый участник/другой бот

user_removed - из группового чата удален участник/другой бот

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

chat_member_name - имя пользователя

chat_member_username - ник пользователя (если установлен)

chat_member_id - id пользователя

Чтобы писать сообщения от имени бота, а также видеть сообщения других участников в групповом чате/канале, бота нужно назначить администратором и дать соответствующие разрешения