Answer in MAX work chats as your own bot
Connect MAX Messenger to the AI agent: chats, messages, attachments and buttons. The agent replies in work chats, reads uploaded files and posts scheduled digests.
How the agent works with MAX
The agent works through the MAX Bot API at platform-api2.max.ru and passes the bot token in the authorization header. Its first request is get_me: that checks the token is alive and shows whose name the messages will go out under. From there only the chats the bot has been added to are in play — their conversations, attachments and button taps: a delivery note, an export or a screenshot of a report is read by the agent straight from the message feed.
A bot in MAX is a chat participant, not an observer on the side: until it is added to a conversation the agent receives not a single message from there, and no permission gets around that. Incoming messages arrive not by polling but over a webhook: the address is registered at connection time, MAX pushes new messages and button taps itself, and signs every request with a secret in the x-max-bot-api-secret header.
Writing is the main mode for this connector. The agent answers in the thread, shows the typing indicator while it prepares a reply, uploads files, asks follow-up questions with buttons and handles the tap through a callback. It can edit and delete only its own messages — other people's lines in the chat stay untouched — and a scheduled digest goes to the chat you named.
The token carries exactly this bot's rights and nothing beyond: the profile owner's personal correspondence is out of reach through it. Chat history is read page by page, from the newest messages backwards, attachments are fetched by the link from the event, and the agent holds the request rate itself. A file goes out as an upload to MAX rather than a link to an outside drive, and the agent names the chat it landed in instead of a short «sent».
Integration scenarios
Replies in a work chat
The agent receives a message from a MAX chat over a webhook, works out the question and answers as the bot without waiting for you to free up.
Reading the files people send
The agent reads attachments from the chat — a delivery note, an export, a screenshot of a report — and answers on their content right in the thread.
Scheduled digest
The agent posts the morning digest to the right MAX chat at the agreed time, so the numbers arrive on their own, without reminders.
Buttons and follow-up questions
The agent asks a question with buttons, handles the tap through a callback and edits its own message once the answer is no longer relevant.
What was discussed without you
The agent reads chat history page by page, from the newest messages backwards, and retells what was agreed there while you were away from the thread.
A file straight into the chat
The agent uploads a finished report or export into MAX and names the chat it put the file in — instead of passing around a link to an outside drive.
MAX examples
Разобрал вложение: 18 позиций на 246 800 ₽, две расходятся с заказом.
Ответил прямо в чате: по «Кабель ВВГ 3х2,5» пришло 40 бухт вместо 60, а «Гофра 20 мм» в заказе не значилась вовсе. Остальное сошлось до копейки.
Накладная из чата
Document · DOCXHow to connect
Before you connect
- Russian residency: a company, a sole trader or a self-employed person
- The company INN — the bot nickname is built from it
- Admin rights in the chats where the bot will be added
- 1
Set up a business profile at business.max.ru
Only Russian residents can create MAX bots: a company, a sole proprietor or a self-employed person. Until the profile is verified, «Чат-боты» stays locked.
- 2
Create a bot in the «Чат-боты» section
In your profile open «Чат-боты» → «Создать» and fill the card: a 500×500 px logo, a name and a description. The nickname is auto-generated as idИНН_bot.
- 3
Wait for the bot to pass moderation
Review takes up to 48 business hours. The status «создан» means the bot is ready; «требует исправлений» means fix the card and submit it again.
- 4
Copy the token from the bot card
The token appears in the bot card only after moderation succeeds. Copy the whole string and add the bot to the MAX chats where it should answer.
FAQ
With a bot token. Create a business profile at business.max.ru, create a bot in the Chatbots section and wait for moderation: the token appears in the bot card only after it. Copy the whole string.
Messages and attachments in the chats the bot has been added to, and the data of the bot itself. It does not read conversations where the bot is absent.
Yes, that is the main scenario: it sends and edits messages, deletes its own, uploads files, shows the typing indicator and responds to button taps.
Only residents of Russia — a company, a sole trader or a self-employed person. The profile goes through verification and the bot itself through moderation, which takes up to 48 hours on business days.