Connecting MAX Bot
Direct integration MAX Bot transmits messages to ChatRex official bot MAX and sends responses ChatRex in the same dialog. The channel works in personal and group chats.
MAX Bot and MAX by QR code are different integrations. Select MAX Bot if the bot is built on the MAX partner platform and you have its token.
Before connecting n
Prepare:
- ChatRex account;
- Created and moderated bot MAX;
- the token of this bot;
- Active ChatRex subscription with free channel space.
The creation of bots on the MAX platform for partners is available to organizations, individual entrepreneurs and self-employed residents of the Russian Federation. The profile must undergo a verification process.
Obtaining the MAX token
- Open MAX Partner Platform and go to Chatbots.
- Pick the right bot.
- Open Advanced settings →Configure.
- Copy the value of the Token field.
The token appears after successful moderation of the bot. A detailed procedure for creating and configuring is given in official MAX documentation.
The token provides access to bot management. Do not send it in correspondence, do not add to the prompt and do not store it in a public file. If the token has become known to an outsider, update it on the MAX platform.
Connecting to ChatRex
-
Open Integrations.
-
Press Connect integration.
-
On the Channels tab, find MAX Bot and click Connect.
-
In the Token field of the MAX bot insert the token.
-
Press Connect.
-
Make sure that the integration list for MAX Bot shows the status Connected.
ChatRex will verify the token, identify the bot, and automatically configure to receive new messages. You do not need to manually configure webhook.
note
Once connected, the token is hidden and no longer displayed in the ChatRex interface.
Activation of the subscription
MAX Bot is considered a separate channel type and occupies one place in the subscription. The location used by MAX QR code integration does not apply to MAX Bot.
If the subscription is inactive:
- Add MAX Bot to your subscription.
- Check the available number of channels.
- Make sure your subscription status has changed to active.
Designation of a botoo channel
- Open My Bots and press Change opposite the desired bot.
- Go to Channels and Launch.
- In Conditions on channels click Add channel.
- Select the connected MAX Bot.
- If necessary, adjust the conditions and working hours.
- Save the changes.
Verification
- Open the connected bot in MAX.
- Send him a test text message.
- Wait for ChatRex's response in the same dialog.
- Open History or Chats in ChatRex and find the test dialog.
- If necessary, repeat the check in the group chat, which added the bot MAX.
In the first version, integration processes text messages. Events containing only textless attachments are not transmitted to the ChatRex bot.
If there is no answer, check:
- Is the token valid and belongs to the MAX bot?
- Is MAX Bot connected to an active subscription?
- Is the channel assigned to the desired ChatRex bot?
- Whether the time and other launch conditions are appropriate;
- Whether the MAX bot has been added to the group chat if the group is being checked
- Is there enough money on the ChatRex balance sheet?
Token replacement and disconnection
If the token has been updated or withdrawn, open Configure from the existing MAX Bot integration, disable the connection and reconnect it with the new token.
After disabling, ChatRex stops receiving new messages from this bot and sending responses. The token is stored on the ChatRex server in encrypted form and is not transmitted to the ChatRex bot or dialog text.