canonical: https://jentic.com/apis/platform-api.max.ru/max-bot

# Platform Api Max Ru Max Bot API

The Max Bot API connects bots to the Max messenger, sending, editing, and deleting messages in chats. It manages chat members and administrators, pins and unpins messages, uploads files, and responds to inline button callbacks. Bots receive incoming events through subscriptions or by polling the updates endpoint.

## For AI agents

Send, edit, and delete messages in Max messenger chats, manage members and administrators, pin messages, upload files, and respond to button callbacks. Receive events via subscriptions or the updates endpoint.

## Scope

Does not handle voice calls, SMS, or email. Use for Max messenger bot chat and messaging only.

## Capabilities

- Send, edit, and delete messages in chats
- Send chat actions such as typing indicators
- Add and remove chat members and administrators
- Pin and unpin messages in a chat
- Subscribe to bot updates or poll the updates endpoint
- Upload files and respond to inline button callbacks

## Use cases

### AI Chatbot Agent

An AI agent connected to the Max Bot API through Jentic can hold a conversation in a chat by reading incoming updates, sending replies, and responding to the buttons a user taps. It can send a typing action while it works, so the chat feels responsive to users.

Example prompt: Poll the updates endpoint for a new message, then send a reply to the originating chat

### Automated Chat Responses

Send transactional and notification messages to chats and let users act through inline buttons. The Max Bot API sends messages, edits them in place, and answers the callbacks that buttons trigger.

Example prompt: Send a message with an inline button and answer the callback when the user taps it

### Chat Administration

Keep a chat organized by managing its members and administrators and pinning the messages that matter. The Max Bot API adds and removes members, grants and revokes admin rights, and pins or unpins messages.

Example prompt: Add a new administrator to a chat and pin the welcome message

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/chats` | List the chats the bot belongs to |
| POST | `/messages` | Send a message |
| POST | `/chats/{chatId}/actions` | Send a chat action such as typing |
| PUT | `/chats/{chatId}/pin` | Pin a message in a chat |
| POST | `/chats/{chatId}/members/admins` | Add a chat administrator |
| GET | `/updates` | Get incoming updates |

## Key resources

- **Messages** — Send, edit, delete, and fetch chat messages
- **Chats** — List chats and read, edit, or leave individual chats
- **Members** — Chat members and administrators, added and removed via the API
- **Updates and Subscriptions** — Incoming events via long polling or webhook subscriptions

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 45 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 72 / 100
  - Developer Experience & Jentic Compatibility: 44 / 100
  - AI-Readiness & Agent Experience: 57 / 100
  - Agent Usability: 94 / 100
  - Security: 15 / 100
  - AI Discoverability: 61 / 100
- **View full report:** https://jentic.com/apis/platform-api.max.ru/max-bot/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Max Bot API by hand means passing your access token on every request and learning its chat, message, and members endpoints yourself. Through Jentic you install once, import Max Bot from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** The Max Bot API puts the chat id in the URL path, so a rule can pin your agent to one chat: it can send messages and actions there and nothing else. You choose the operations, so member removal or chat deletion is not included unless you add it.
- **Credential handling:** Your Max access token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'send a message' or 'pin a message', and Jentic returns the matching Max Bot operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Telegram Bot API** — Bot API for the Telegram messenger, a close parallel to the Max Bot API.
- **Discord** — Chat platform API for servers and bots, where Max targets the Max messenger.
- **Slack** — Team messaging API, complementing Max for internal workspace notifications.

## FAQ

### Is there a Max Bot MCP server?

You don't need an MCP server to give your agent the Max Bot API. Jentic connects it directly from the API Directory: import it, store your access token once, and your agent can send messages and manage chats. Operations are discovered on demand, so your agent's context stays lean.

### Can I limit what my agent is allowed to do with the Max Bot API?

Yes. The Max Bot API puts the chat id in the URL path, so a rule can pin your agent to one chat and allow only sending messages and actions there. It cannot remove members or delete the chat unless you add those operations, and every call is logged.

### What authentication does the Max Bot API use?

The Max Bot API authenticates with an access token passed as the access_token query parameter per its OpenAPI spec; you receive the token from MasterBot when you create a bot. With Jentic, the token is stored encrypted by your own Jentic One instance and injected at call time.

### Can I pin a message with the Max Bot API?

Yes. The pin endpoint sets the pinned message for a chat, and a matching endpoint removes it. An agent can also read the current pinned message before replacing it.

### What are the rate limits for the Max Bot API?

The OpenAPI spec does not specify rate limits. Check the Max platform documentation at https://platform-api.max.ru for current limits before sending high-volume messages.

### How do I send a chat message with the Max Bot API through Jentic?

Import the Max Bot API from the Jentic API Directory, store your access token once, and have your agent search by intent such as 'send a message'. Jentic returns the send operation with its input schema, and your agent passes the chat and text. To run it on your own infrastructure, install Jentic One from its GitHub repo.