Чат-бот MAX
Как получить полный вебхук
Для получения полного вебхука от 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 WebApp
В MAX теперь можно добавлять мини-приложения (WebApp) с ссылкой на ваш сайт или онлайн-магазин.
Ссылку возможно вставить только на бота, у которого настроено мини-приложение.
Ссылка на сайт настраивается вручную в настройках бота. Подробнее в официальной документации MAX.
Важно!
В настройке кнопки на стороне Salebot допустимо вставлять ссылку на другого бота с настроенным мини-приложением. Ссылку сразу на сайт вставить нельзя
Настройки: как добавить приложение в MAX
Откройте платформу MAX для партнёров, зайдите в профиль организации → перейдите в раздел Чат-боты
Если у вас несколько ботов, в панели управления ботом нажмите на имя текущего бота и выберите нужный из списка
Перейдите в раздел Чат-бот и мини-приложение → Настроить
Вставьте URL мини-приложения в поле для ссылки
Выберите вид кнопки открытия мини-приложения (Открыть, Старт, Играть или без названия) и нажмите Сохранить
Требования к URL мини-приложения:
Длина: не более 1024 символов
Протокол: только https://
Допустимые символы: буквы (латиница), цифры, точка (.) и дефис (-)
Пробелы не поддерживаются
URL должен быть валидный
Как только вы подключите мини-приложение к платформе, в чате с его ботом появится заметная кнопка для быстрого запуска сервиса.
Настройки кнопки с WebApp
Чтобы отправлять клиенту кнопку с WebApp в цепочке бота, в блоке создайте кнопку:
В настройках кнопки выберите функцию MAX Web Application и вставьте ссылку на вашего бота.
Последнее обновление