Chatva

Search documentation

Search titles, instructions and image captions. Use ↑ ↓ to choose a result, Enter to open, Esc to close.

Enter a channel name or describe the step you need.

    Documentation: MAX

    MAX

    Updated October 11, 2026

    On this page

    MAX has two modes: a personal profile for your account’s messages and a bot for a separate customer contact. Use QR on a computer or embedded sign-in on a phone.

    Before you connect

    • Personal profile: access to MAX and the account password if additional protection is enabled.
    • Bot: a verified organization, sole trader or self-employed profile on business.max.ru, an approved chatbot and its API token.

    Open the correct workspace in Chatva → Channels → the channel card → Connect. On first connection, use Next to go through the introductory steps. In the mobile app, the same guide is available during onboarding and under Channels.

    Choose your connection method

    Personal profile

    Prepare your MAX account, then follow the instructions for a computer or the Chatva app.

    Prepare MAX sign-in

    1. Open MAX on your phone

      Check that you are signed into the correct account. Keep your phone nearby to confirm sign-in. Official sign-in instructions.

    2. Check your sign-in password

      With an active session, MAX may require you to set a password on that device first: Settings → Security → Sign-in password. Have it ready for the next step. Password settings.

    If sign-in fails, open MAX help and use the support link at the bottom of the article. A personal-profile connection does not require a bot in the partner dashboard.

    On a computer: QR code

    1. Choose Personal profile → Show pairing QR

      Keep the code open on your computer.

    2. Scan the code in MAX

      On your phone, open MAX → Settings → Devices. Scan Chatva’s QR code and confirm the sign-in.

    3. Enter your password if MAX requests it

      The MAX account password field appears in Chatva if needed. Enter it, press Confirm password and wait for the connected account.

    In the Chatva app: sign in to MAX

    Choose Personal profile → Sign in. The app opens web.max.ru; finish signing in to MAX and Chatva captures the session automatically. If you choose By QR, display the code on another screen so MAX can scan it.

    Bot token connection

    Create and prepare a bot in the MAX partner dashboard. After moderation, copy its token into Chatva.

    Create a bot in the MAX dashboard

    1. Sign in and choose your business

      Open business.max.ru, sign in and select your business profile. If needed, complete profile creation and verification.

    2. Create a chatbot

      On the MAX platform, open Chatbots → Create. Complete the card and submit it for review. Fields and requirements.

    MAX platform: Create in the Chatbots card. Official interface example in Russian.

    Source: MAX · Создание чат-бота ↗

    MAX platform: Create in the Chatbots card. Official interface example in Russian.

    Source: MAX · Создание чат-бота ↗
    MAX platform: Create in the Chatbots card. Official interface example in Russian.

    Wait for successful moderation before obtaining the token. If changes are requested, open the bot card and follow MAX’s feedback. Moderation status.

    1. Open the published bot’s settings

      At business.max.ru, open Chatbots. On your bot’s card choose ⋮ → Settings. Token location.

    MAX: bot card menu ⋮ → Settings. Official example in Russian.

    Source: MAX · Управление ботом ↗

    MAX: bot card menu ⋮ → Settings. Official example in Russian.

    Source: MAX · Управление ботом ↗
    MAX: bot card menu ⋮ → Settings. Official example in Russian.
    1. Press the copy icon beside the token

      In MAX platform settings, find Chatbot → Access token and press the copy icon on the right. The circular arrow rotates the token; it is not the copy button. Official instructions.

    Copy a MAX token with the icon on the right. Token value hidden.

    Source: MAX · Получение токена ↗

    Copy a MAX token with the icon on the right. Token value hidden.

    Source: MAX · Получение токена ↗
    Copy a MAX token with the icon on the right. Token value hidden.

    Paste the token into Chatva

    Paste the token copied from MAX into Chatva: MAX → Bot → Bot token → Connect. Chatva checks the bot and registers its webhook automatically.

    Test an incoming message and a reply

    1. Write from a different account

      Send “Connection test” to the personal MAX account or your bot. Use a different account to test an incoming customer message.

    2. Find the conversation in Chatva

      Open the correct workspace’s Inbox and check the channel and sender. If an assignee or status filter is active, switch to all conversations.

    3. Reply from the inbox

      Send “Message received” and confirm on the customer’s side that it arrived from the correct number, bot or page. Connection status alone does not confirm two-way delivery.

    Troubleshooting

    What happenedWhat to check
    QR expiredRequest a new QR code and scan the fresh code. Check that you are authorizing the correct account.
    Password requested after QREnter the MAX account password in the new field. QR sign-in does not bypass additional protection.
    Token rejectedCheck that you copied the full token of an active bot. If MAX replaced the token, update it in Chatva.
    Personal account connected but history is incompleteRecent conversations are loaded partially. Send a new message from a different account to verify the connection.