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

Для получения полного вебхука от 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

курсив или курсив

жирный или жирный

зачёркнутый или зачёркнутый

подчёркнутый или подчёркнутый

моноширинный
или моноширинный

ссылка Docs

Кнопка MAX WebApp

В MAX теперь можно добавлять мини-приложения (WebApp) с ссылкой на ваш сайт или онлайн-магазин.

Ссылку возможно вставить только на бота, у которого настроено мини-приложение.

Ссылка на сайт настраивается вручную в настройках бота. Подробнее в официальной документации MAX.

Важно!

В настройке кнопки на стороне Salebot допустимо вставлять ссылку на другого бота с настроенным мини-приложением. Ссылку сразу на сайт вставить нельзя.

Настройки: как добавить мини-приложение в MAX

  1. Откройте платформу MAX для партнёров, зайдите в профиль организации → перейдите в раздел Чат-боты.
  2. Если у вас несколько ботов, в панели управления ботом нажмите на имя текущего бота и выберите нужный из списка.
  3. Перейдите в раздел Чат-бот и мини-приложение → Настроить.
  4. Вставьте URL мини-приложения в поле для ссылки.
  5. Выберите вид кнопки открытия мини-приложения (Открыть, Старт, Играть или без названия) и нажмите Сохранить.

Требования к URL мини-приложения

  • Длина: не более 1024 символов
  • Протокол: только https://
  • Допустимые символы: буквы (латиница), цифры, точка (.) и дефис (-)
  • Пробелы не поддерживаются
  • URL должен быть валидным

Мини-приложение в MAX

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

Как добавить кнопку с мини-приложением (WebApp)

Чтобы отправлять клиенту кнопку с WebApp в цепочке бота, в блоке создайте кнопку:

Создаем кнопку Вебапп / WebApp для MAX

В настройках кнопки выберите функцию MAX Web Application и вставьте ссылку на вашего бота.