MAX

В статье расскажем, как подключить мессенджер Max к Сейлбот

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

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

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

Как получить токен бота

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

После этого у вас появится токен бота — он нужен для дальнейшей интеграции с MAX.

Обращаем внимание!

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

Позднее в мессенджере появится возможность подключения ботов для ИП.

Чтобы получить токен:

Шаг 1. Создайте бота

Если вы уже создали бота на платформе (https:/ /business.max.ru/self) и он прошёл проверку, перейдите к следующему шагу.

Если у вас ещё нет бота, следуйте следующим шагам:

1. Войдите на платформу или зарегистрируйтесь по номеру телефона.

2. Создайте и верифицируйте профиль организации.

3. Создайте бота и пройдите его модерацию.

Готово!

Шаг 2. Скопируйте токен из настроек бота

Для этого:

1. Перейдите на платформу и авторизуйтесь.

2. Если у вас несколько ботов, в левом верхнем углу выберите нужный.

3. В разделе Чат-бот и мини-приложение нажмите Настроить.

1. Скопируйте токен:

Теперь можно подключать мессенджер к Сейлбот.

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

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

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

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

Готово! Бот подключен

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

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

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

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

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

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

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

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

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

Inline-клавиатура в чат-боте

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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