MAX in a project: connecting a bot

SENSEVER

The official Sensever channel: guides and API documentation for Chat, Requests, Flow, Studio, bots and messaging channels.

3 min de lectura

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

  1. Open business.max.ru and sign in with your phone number — you'll get a confirmation code.

  2. Enter the organization's INN, check the company details and click "Create".

  3. Verify the organization using one of the methods the portal offers.

Step 2. Create a chat bot

  1. In the "Chat bot and mini app" section, click "Create".

  2. Fill in the name, description, company phone and website, and upload a logo. Customers will see the name.

  3. Click "Create" — the bot goes to MAX moderation. It usually takes about 24 hours.

  4. Once the bot is approved, a check mark appears next to the logo and the status changes to "Created".

Step 3. Get the token

  1. Open the bot settings on the portal.

  2. In the "Integration" block, click "Get token" and copy the token.

Step 4. Connect the bot in Sensever

  1. Projects → the project → "Channels" → the "Messaging channels" block.

  2. On the grey MAX tile, click "Connect".

  3. Paste the token into the "Bot token" field, and choose a department or leave "Shared queue".

  4. 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".

Comentarios

Autores