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 botchatbot. A chatbot is a program that exchanges messages with a person in a chat window: on a website, in a messenger or in an app. 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 moderationAI content moderation. Content moderation is the check of messages, reviews, images and AI answers for banned and harmful content, before or after publication. AI content moderation does this check with a program.”: 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 tokentoken. A token is a piece of text that a language model works with: a word, part of a word, or a symbol. 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

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 labeltarget variable. A target variable is the value a machine learning model learns to predict: whether a customer will leave, how much product will sell, how much a flat costs. 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 agentAI agent. By definition, an AI agent is a neural network that does not just answer but carries out a task step by step on its own: it looks for data, uses programs and checks the result.: 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 modelopen weights model. An open weights model is a neural network whose parameter files you can download and run on your own hardware. 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.


