MAX in a project: connecting a bot
Customers message your organization's bot on MAX, and the requests arrive in Sensever. Sensever sets up the message subscription itself — all you need is a bot token from the MAX partner platform.
What you need
An organization (a legal entity or a sole proprietor) with a taxpayer ID (INN): only verified organizations can create bots in MAX.
A phone number to sign in to the MAX business portal.
Owner or admin rights in the Sensever project.
Step 1. Register your organization on the MAX business portal
Open business.max.ru and sign in with your phone number — you'll get a confirmation code.
Enter the organization's INN, check the company details and click "Create".
Verify the organization using one of the methods the portal offers.
Step 2. Create a chat bot
In the "Chat bot and mini app" section, click "Create".
Fill in the name, description, company phone and website, and upload a logo. Customers will see the name.
Click "Create" — the bot goes to MAX moderation. It usually takes about 24 hours.
Once the bot is approved, a check mark appears next to the logo and the status changes to "Created".
Step 3. Get the token
Open the bot settings on the portal.
In the "Integration" block, click "Get token" and copy the token.
Step 4. Connect the bot in Sensever
Projects → the project → "Channels" → the "Messaging channels" block.
On the grey MAX tile, click "Connect".
Paste the token into the "Bot token" field, and choose a department or leave "Shared queue".
Click "Connect". The message "MAX connected" appears, and the tile turns colored.
If the bot is already connected to another service, Sensever offers "Switch this bot from another service to Sensever Chat". Check it and click "Connect" again — the other service's subscription is removed.
Step 5. Check it
Find the bot in MAX by its name (format id0000000000_bot) and message it. The message appears in the project's requests. The MAX button appears in the widget on your site once the bot has a public name and "Show in widget" is checked on the tile.
What is passed
From the customer: text, photos, videos, voice messages, files, links, location, contacts, forwarded messages (with the author's name), message edits.
To the customer: text, edits to your replies, files. Photos, videos, audio and documents are sent as files; a file larger than 20 MB is sent as a link that is valid for 48 hours.
A reply deleted in the request disappears for the customer.
While an agent is writing a reply, the customer sees "typing…".
If the customer replies to a specific message, the request shows it as a reply.
Read receipts: the customer sees that you've read their messages.
The MAX API has no reactions — neither from the customer nor from the agent.
Possible errors
Message | What to do |
|---|---|
The messenger didn't accept the token | The token wasn't copied in full or a new one was issued. Get the token again in the "Integration" block and connect again |
This bot is already connected to another project | Remove the bot from that project or create a separate one |
The messenger is unavailable right now | The MAX platform didn't respond. Try again in a few minutes |
General channel settings — department, showing in the widget, button order, notifications — are described in the article "Project messaging channels: messengers in Requests".
Comments