MMOOZZGG.com

AI assistant

In short

Creating a bot in the MAX messenger takes four steps on the MAX for partners platform, from verifying the company profile through Gosuslugi to building the flow. The guide follows the MAX documentation as checked on 16 October 2026. It also covers linking the bot to the website, CRM and team, and the common reasons bots get stuck at review.

Key ideas

  • Moderation of a new bot takes up to 48 hours on working days.
  • Legal entities, sole proprietors and self-employed people who are residents of Russia can create bots.
  • MAX does not publish a list of rejection reasons, but the reason appears in the bot card each time.
  • After moderation the bot is empty and answers only by the flow the company builds.
  • A scripted bot with buttons covers answers known in advance, such as working hours, the price list and lead collection.

Prepared by AI from the article

How to create a MAX messenger bot for your company: profile, moderation, buttons and CRM

GuideIT

Medium14 min read11 sources

To create a MAX messenger bot, a company takes four steps on the MAX for partners platform: verify the organization profile through Gosuslugi, the Russian state services portal, fill in the bot card, wait for moderation of up to 48 hours on working days and build the flow in a builder or with its own code. Below is each step by the MAX documentation as checked on 16 October 2026, plus how to link the bot to the website, the CRM and the team, and where bots most often get stuck at review.

How to create a MAX messenger bot for your company: profile, moderation, buttons and CRM
On this page · 9 sections

Who can create a bot in MAX

Bots in MAX are created on the MAX for partners platform, and legal entities, sole proprietors and self-employed people who are residents of Russia can join it. Profile verification is not yet available to private persons and non-residents, so you cannot register a bot for a private person or a foreign company.

An organization or a sole proprietor can create up to 5 bots, and a self-employed person up to 2. That is enough to separate a bot for clients from a bot for partners, or to give branches different flows.

Two limits matter before you start. A bot is always public: people find it by link or nickname through search, and a closed bot only for your own team is not yet possible. You also cannot change the bot’s owner or transfer the rights to it yet. So create the bot for the organization that will use it, not for the contractor: otherwise the bot and its clients stay with someone else’s legal entity.

Step 1. Company profile and verification through Gosuslugi

Open the web version of the platform, business.max.ru/self, or the MAX for Business mini app. In the web version you log in with a phone number and a code from a text message. The documentation advises a corporate number or the work number of a responsible employee who always has it at hand: codes and important notices come to it.

Then choose the profile type: organization, sole proprietor or self-employed. One phone number or email address matches one profile type.

The organization is confirmed by the owner or a representative with the right of first or sole signature. Log in to Gosuslugi, the Russian state services portal, with the “Head” or “Administrator” role: with an employee role the check fails. If several organizations are linked to the account, pick the right one from the list.

The EGRUL or EGRIP data (the Russian state registers of legal entities and sole proprietors) on Gosuslugi must be up to date. Update old data in the “Organization profile” section, item “Organization data”, button “Update”: this usually takes from a few minutes to an hour, and in rare cases up to 24 hours. The MAX for Business bot will tell you when the check succeeds. If the organization cannot be confirmed, write to the “MAX for Business Support” chat or to partner_support@max.ru and give your tax number, phone number, the steps you took and a screenshot of the error.

Step 2. The bot and its card

In the profile, open the “Chatbots” section and press “Create”. A client sees the card before the bot’s first reply, so fill it in like a company sign.

Logo: 500 x 500 pixels, a 1:1 square, a JPG or PNG file up to 5 MB, and you can crop it right on the platform. Name: up to 59 characters, only Latin and Cyrillic letters and digits, no emoji. Description: up to 200 characters, and emoji are allowed here.

The platform creates the nickname by itself: idTAXID_bot for a legal entity or sole proprietor, where TAXID is the tax number, and a separate format with the organization’s number for a self-employed person. You cannot choose or change it yet. After creation the card shows the organization’s name, a link of the form max.ru/idTAXID_bot and a QR code: later you will put them on the website and in materials for clients.

The documentation advises putting the working hours, support contacts, a phone number or an office address in the description. The text must match the organization’s business, and the name, logo and description must not contain profanity, 18+ material or data of other companies.

Step 3. Moderation, statuses and token

After you press “Create” again, the bot goes to review. It takes up to 48 hours on working days, and the bot’s settings are locked all that time. The MAX for Business bot reports the result in private messages.

There are three statuses. “Under moderation”: the bot waits for review. “Published”: the bot is available to clients, people find it by nickname, and you can keep setting it up and connect services. “Needs fixes”: the bot is rejected, the reason is shown in the card, and after the fixes it goes to review again.

Any edit in the “Basic information” section sends a published bot back to moderation, and clients see the old version until it ends. So collect edits in a batch, not one at a time.

The token is issued only after moderation. In the “Chatbots” section, choose the bot, press “⋮” and “Settings”, then the copy icon to the right of the token field. The token gives full control of the bot: do not keep it in the open, and pass it only to the service or contractor who builds the flow. If the token may have reached outsiders, refresh it in the same place with the refresh icon.

Step 4. A builder or your own code

How to create a MAX messenger bot for your company: profile, moderation, buttons and CRM

After moderation the bot is empty: it has no default commands and starts answering only by the flow you set. You can build the flow in two ways.

A builder. Ready templates, a flow made of blocks and buttons, and analytics after launch. Builders are made by official MAX partners, not by the messenger itself: on the platform open “Integrations”, “Connect” and choose a category or find a service by name. The partners include chatbot platforms, support chats, CRM systems and mini app builders. You connect a service with your token or order a turnkey build from the partner. Later edits are made on the builder’s website, not in MAX, and the documentation advises working in it from a computer.

Your own code. The bot works through the MAX API at platform-api2.max.ru, the token goes in the Authorization header, and the limit is 30 requests per second. MAX has official libraries for JavaScript, TypeScript and Go, and the API schema is published in OpenAPI format, from which you can generate code for Python, Java, PHP and other languages.

For a working bot, MAX delivers messages only through a webhook: an HTTPS address on port 443 with a certificate from a trusted authority or from Russia’s Ministry of Digital Development. The server must answer within 30 seconds, or MAX retries up to 10 times, and if there is no successful answer for 8 hours, it unsubscribes the bot from the webhook. Long Polling is only for development and tests, and you cannot turn on both methods at once. We covered the webhook subscription step by step in the guide to building an AI agent in MAX.

How to choose. A builder is faster, but the flow is stored at the vendor and can be changed only in its interface. Your own code needs a server and a developer, but the logic and the data stay with the company, and you can link the bot to any of your systems.

Buttons and flows

A regular bot’s flow is built on buttons. MAX supports seven types: callback sends your server an event about the press, link opens a link, request_contact asks the client to share a phone number, request_geo_location asks for a location, open_app opens a mini app, message sends the bot a ready text, and clipboard copies text to the clipboard.

One keyboard holds up to 210 buttons in 30 rows, up to 7 buttons per row, and no more than 3 buttons with a link, a mini app, a phone request or a location request. A label that does not fit on a button is cut off, so keep it short: “Book”, “Get a price”, “Call a manager”.

A message text is up to 4,000 characters and can be formatted with Markdown or HTML. The bot sends no more than two messages per second to one dialog, so a long answer works better as one message than as five short ones in a row.

A working flow for a company is short: a greeting with three or four buttons, answers to frequent questions, a phone request button for a lead and a “Call a manager” button at every step. If the bot collects names and phone numbers, decide before launch where they are stored: the requirements of 152-FZ, Russia’s personal data law, and our approach are described on the page about data security.

How to connect a MAX chatbot to your website, CRM and team

Website. The simplest way is to put the max.ru/idTAXID_bot link and the QR code from the bot card on the contacts page and in the website footer. To know where a client came from, use a deep link of the form max.ru/nickname?start=tag. When a client follows it, the bot receives a bot_started event with this tag, and you see that the person came from the delivery page, not from an ad.

The tag has three rules. It is no longer than 128 characters, or the bot will not receive it. It must not carry confidential data in plain text, and sending authorization messages through deep links is forbidden. For the bot to receive such visits, the bot_started event must be included in the webhook subscription.

CRM. If your CRM is in the “Integrations” section, you connect it with the bot token and no development. If not, your code passes the lead from the bot: the flow collects the name, phone number and the gist of the request and creates a lead or a deal through the CRM’s API. How this works in specific systems is shown on the pages about amoCRM and Bitrix24.

Team. You cannot add a bot to a private dialog, but you can add it to a group chat of employees. First allow adding to groups in the bot’s settings in the “Privacy” section: it is off by default. Then create a group chat in MAX, add the bot through “Members” and make it an administrator with the read_all_messages and write rights. Now the bot can post every new lead to the chat, and the manager on duty sees it at once.

Limits and common mistakes at moderation

MAX does not publish a list of rejection reasons: the reason is shown in the bot card each time. But the requirements for the card and for bot content are public, and they show what to check before you submit.

In the card. Emoji in the name: only letters and digits are allowed there. A logo that is not square or is heavier than 5 MB. A description that is not about your business or contains another company’s data. Profanity and 18+ material in any field.

In the flow. MAX requirements forbid using the API for advertising, marketing and other mass mailings unless the contract with MAX directly allows it. Contests and promotions inside the bot need separate approval from MAX. The developer must publish a personal data policy and information about itself, support users and handle their complaints.

In the way you work. Do not log in to Gosuslugi with an employee role. Do not edit a published bot one line at a time: every card edit means a new moderation. And do not delete a bot to change data quickly if clients already write to it: deletion cannot be undone, and clients lose access to the bot.

When a regular bot is enough and when you need an AI agent

A scripted bot with buttons covers tasks where the answer is known in advance: working hours and address, the price list, booking a free slot, collecting a lead with a phone number and the status by order number. It is easy to check, because every answer is written in advance.

A bot stops coping when clients write in their own words: “can I come on Thursday after six, and how much with delivery?”. You cannot make enough buttons for such questions. Here you need an AI agent: it understands free text, checks prices and free slots, creates a deal in the CRM and hands a hard case to a person together with the chat history. More on the difference in the article on how an AI agent differs from a chatbot.

You can build an agent in MAX yourself by our guide: a bot, a webhook and an open model on your server. If the agent must work with the CRM and clients from day one, we connect it end to end: a 14-day pilot with the price, the term and the metric in the contract; details on the page about the AI agent for MAX. For a flow of standard requests there is a separate solution: a support chatbot in MAX.

In short

A MAX messenger bot is created by a legal entity, sole proprietor or self-employed person who is a resident of Russia, after the profile is verified through Gosuslugi. The bot goes through moderation of up to 48 hours on working days, and the token is issued after it. The flow is built in a MAX partner’s builder or with your own code on a webhook, and the bot is linked to the website with a link, a QR code and a deep link with a tag. If clients write in free text and leads must reach the CRM, you need an AI agent.

Questions and answers

How many bots can a company create in MAX?

An organization or a sole proprietor can create up to 5 bots, and a self-employed person up to 2. Each bot goes through moderation separately, and the platform creates the nickname for each one by itself.

Can you make a bot only for employees?

Not yet: anyone can find any MAX bot by link or nickname through search. If the bot is only for the team, check access in the flow itself, for example by phone number.

Can you transfer a bot to another organization or change its nickname?

No. You cannot change the bot’s owner or transfer the rights yet, and the nickname does not change either. So create the bot for the organization that will work with it.

Can you send mailings to clients through a MAX bot?

MAX requirements forbid advertising, marketing and other mass mailings through the API unless the contract with MAX directly allows them. You may answer clients who wrote to the bot themselves.

What do you do if the organization profile fails verification?

Check your role on Gosuslugi: you need “Head” or “Administrator”. Update the EGRUL or EGRIP data. If that does not help, write to the “MAX for Business Support” chat or to partner_support@max.ru with your tax number, phone number and a screenshot of the error.

Sources and fact-checking

All links lead to the official “MAX for Developers” documentation, dev.max.ru. Checked by the editors on 16 October 2026.

  1. Creating and moderating a chatbot (dev.max.ru)
  2. Creating a profile of an organization, sole proprietor or self-employed person (dev.max.ru)
  3. Bot management and token (dev.max.ru)
  4. No-code flow builder (dev.max.ru)
  5. Choosing partner services (dev.max.ru)
  6. Building a bot through the API and deep links (dev.max.ru)
  7. Keyboard and buttons (dev.max.ru)
  8. POST /subscriptions (dev.max.ru)
  9. POST /messages (dev.max.ru)
  10. Requirements for the content and functions of apps (dev.max.ru)· version of 16 December 2025
  11. Frequent questions about chatbots (dev.max.ru)

Found a mistake? Tell us

Publications

Contact us