Интеграция мессенджера MAX через сценарии

Платформа Altcraft позволяет интегрировать мессенджер MAX для отправки сообщений профилям из вашей базы. Интеграция осуществляется через сценарии автоматизации с использованием API MAX. Перед настройкой сценариев рекомендуется создать пользовательское поле, в которое будет храниться информация об идентификаторе профиля в мессенджере MAX.

к сведению

Без идентификатора профиля работа API-запроса мессенджеру MAX невозможна.

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

Для начала работы необходимо создать бота в мессенджере MAX. Найдите в поиске @Masterbot и начните с ним чат.

При создании бота потребуется пройти процедуру модерации. В документации мессенджера MAX описаны:

• Базовая инструкция для создания бота;
• Требования к оформлению и функционалу бота;
• Список необходимых данных для модерации;
• Сроки рассмотрения заявки;
• Ограничения и правила использования ботов.

Ознакомьтесь с документацией перед созданием бота, чтобы избежать отклонения заявки.

Настройка сценария в Altcraft

Создайте новый сценарий или клонируйте имеющийся (подойдут сценарии с использованием Telegram-бота). Вместо элементов отправки добавьте элемент Вызов API. С его помощью в MAX будет отправляться запрос с сообщением, которое разошлет бот.

Настройка запроса API

Настройте элемент Вызов API следующим образом:

• Тип авторизации: Без авторизации
• Тип запроса: POST DATA
• URL запроса: https://botapi.max.ru/messages?access_token=xxxxx&user_id={max_user_id}, где xxxxx — это токен авторизации вашего бота, а {max_user_id} — идентификатор пользователя, который предварительно должен быть загружен из мессенджера и импортирован в созданное вами пользовательское поле.
• Тело запроса: укажите параметры для вашего сообщения.

{
  "text": "Рады приветствовать Вас в MAX, {lead._fname}! Эта рассылка проведена через Altcraft Platform.",
  "notify": true,
  "format": "markdown"
}

Параметр	Тип	Описание
text	string	Текст сообщения (до 4000 символов)
notify	bool	Уведомление участников чата (по умолчанию true)
format	enum	Формат текста ("markdown"или"html")

Подробнее обо всех параметрах читайте в официальной документации MAX