Чат-бот MAX
Обращаем внимание!
В мессенджере запрещены рассылки и сообщения по таймеру. Ограничение «24-часового окна» для отправки сообщений не применяется. При этом соблюдение пункта 1.5 пользовательского соглашения MAX остаётся на вашей стороне.
Спасибо за понимание!
При настройке кнопок для чат-бота в одной строке может быть максимум 7 кнопок.
Создание бота
Чат-боты умеют решать типовые задачи прямо в MAX. Создайте бота, который будет делать что-то за вас.
Даже без навыков программирования сделать своего бота в приложении просто — придумайте сценарий и следуйте пошаговой инструкции.
Как получить токен бота
Обращаем внимание!
Создание чат-бота в MAX доступно для ю/л и ИП.
Шаг 1. Перейдите во вкладку Каналы в Salebot.
Чтобы перейти на страницу регистрации в мессенджере, войдите в личный кабинет Сейлбот и выберите проект, в котором нужно подключить чат-бота MAX.
Затем в проекте перейдите во вкладку "Каналы" и нажмите на кнопку MAX:
При клике по кнопке подключения мессенджера откроется форма, где можно найти кнопку для регистрации в мессенджере для компаний (ю/л и ИП):
Шаг 2. Создайте бота
Если вы уже создали бота на платформе и он прошёл проверку, перейдите к разделу "Подключение мессенджера" ниже.
Чтобы подключить инструменты коммуникации с клиентами в MAX, вам нужно:
Пройти регистрацию по номеру телефона на платформе MAX для партнеров;
Ввести данные своей организации, чтобы создать Личный Кабинет;
В ЛК пройти верификацию организации (через Госуслуги или Банки-провайдеры).
Шаг 3. Скопируйте токен из настроек бота
Для этого:
Перейдите на платформу и авторизуйтесь.
Если у вас несколько ботов, в левом верхнем углу выберите нужный.
В разделе Чат-бот и мини-приложение нажмите Настроить.
Шаг 4. Скопируйте токен:
Теперь можно подключать мессенджер к Сейлбот.
Подключение мессенджера
После того как вы создали бота в мессенджере, необходимо перейти в раздел "Каналы" в Сейлбот:
В разделе каналы нажимаем на “MAX” для ввода токена, который вы скопировали ранее при создании бота:
Вставьте скопированный токен и нажмите на “Готово”:
Готово! Бот подключен
При запуске бота, в диалоге с клиентом появится сообщение /start
Как получить полный вебхук
Для получения полного вебхука от Max достаточно присвоить любое значение переменной save_webhook(переменная может быть как константой проекта, так и переменной сделки).
При этом ответ из мессенджера будет записываться в переменную tt_request, которую вы найдете в карточке клиента среди переменных сделки
Max поддерживает кнопки callback, кнопки с ссылкой, запрос номера телефона, запрос геолокации
Если клиент нажмет на кнопку с запросом номера и даст разрешение, в чат поступит сообщение с его номером телефона и появится переменная phone
Если клиент поделится своей геолокацией, данные поступят в виде сообщения, и будут созданы переменные latitude и longitude
Inline-клавиатура
Такая клавиатура может иметь до 210 кнопок, сгруппированных в 30 рядов — до 7 кнопок в каждом. Если ряды кнопок не помещаются в плейсхолдер клавиатуры, автоматически подключается скролл
Поддерживаемые типы кнопок
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 пользователя
Чтобы писать сообщения от имени бота, а также видеть сообщения других участников в групповом чате/канале, бота нужно назначить администратором и дать соответствующие разрешения
Форматирование сообщений
Markdown
*Курсив* или _курсив_
**Жирный** или __Жирный__
~~Зачеркнутый~~
++Подчеркнутый++
`Моноширинный`
HTML
<i>курсив</i> или <em>курсив</em>
<b>жирный</b> или <strong>жирный</strong>
<del>зачёркнутый</del> или <s>зачёркнутый</s>
<ins>подчёркнутый</ins> или <u>подчёркнутый</u>
<pre>моноширинный</pre> или <code>моноширинный</code>
ссылка <a href="https://dev.max.ru">Docs</a>
Функции калькулятора
max_delete_message(message id) - удаляет указанное сообщение
message_id
id сообщения, которое нужно удалить. Обязательный параметр
Last updated