Integrating the MAX Messenger via Scenarios

The Altcraft platform integrates the MAX messenger for sending messages to profiles stored in your database. Integration runs through automation scenarios using the MAX API. Before configuring scenarios, create a custom field that stores the profile ID from the MAX messenger.

info

Without a profile ID, API requests to the MAX messenger cannot be executed.

Creating a Bot in MAX

Start by creating a bot in the MAX messenger. Search for @Masterbot and start a chat with it.

During bot creation, you must pass moderation. The MAX documentation includes:

• A basic bot creation guide;
• Requirements for bot design and functionality;
• A list of required data for moderation;
• Review timelines;
• Bot usage rules and limitations.

Check the documentation before creating a bot to avoid rejection.

Configuring a Scenario in Altcraft

Create a new scenario or clone an existing one (scenarios using a Telegram bot also fit). Replace sending elements with the API Call element. It sends a request to MAX containing the message that the bot will distribute.

API Request Configuration

Configure the API Call element as follows:

• Authorization type: No authorization
• Request type: POST DATA
• Request URL: https://botapi.max.ru/messages?access_token=xxxxx&user_id={max_user_id}, where xxxxx is your bot’s authorization token and {max_user_id} is the user ID that must be previously retrieved from the messenger and imported into your custom field.
• Request body: set the parameters for your message.

{
  "text": "Welcome to MAX, {lead._fname}! This distribution was sent through Altcraft Platform.",
  "notify": true,
  "format": "markdown"
}

Parameter	Type	Description
text	string	Message text (up to 4000 characters)
notify	bool	Chat notification (true by default)
format	enum	Text format ("markdown" or "html")

More details are available in the official MAX documentation.