Connecting VK

VK direct integration transmits new community messages to ChatRex and sends bot responses on behalf of the community. To connect, you do not need to create an access key, copy the community ID or manually configure the Callback API: the community and permissions are selected in the official ChatRex application in VK.

ChatRex accepts incoming text, photos, documents and voice messages. Voice messages are transmitted for recognition, and images and documents can be used by the bot in processing the appeal.

Before connecting n

Prepare:

• ChatRex account;
• VK community with included messages;
• VK account with administrator rights of the desired community.

You can only connect one community to one ChatRex account.

Community Connection

1. In ChatRex, open Integrations.
2. Press Connect integration.
3. On the Channels tab, select VK and click Connect.
4. In the integration settings, click Open VK.
5. If the application offers to log in, click Login to ChatRex and log in to the desired account. After logging in, return to the VK app.
6. Click Select community.
7. Choose the community you manage.
8. Confirm the requested VK access to community management and its messages.
9. Wait for the message Community connected.

Once confirmed, ChatRex will verify the rights and automatically configure to receive new messages. The community ID and the issued VK key are transmitted securely by the application - you do not need to enter or copy them manually.

Channel subscription

Once connected, ChatRex will automatically add VK to a suitable valid subscription if there is free space for the channel.

There are three possible outcomes:

• the channel is added to the subscription automatically - you can proceed to the appointment of the bot;
• The account is in use without a subscription fee - a separate subscription to the channel is not yet required;
• There is no suitable subscription or free space – add a VK channel to the subscription manually in ChatRex.

Designation of a botoo channel

1. Open My Bots and press Change opposite the desired bot.
2. Go to Channels and Launch.
3. In Conditions on channels click Add channel.
4. Select the connected VK.
5. If necessary, set additional conditions and working hours.
6. Save the changes.

Chat in the community app

Once connected, ChatRex remains available on the VK community page:

• The administrator sees that the community is already connected.
• A community visitor can open the application and write to the designated bot directly in it.
• If the channel is not assigned to any bot, the visitor will see a message that the chat is not yet available.

Dialogues from the app are processed in ChatRex. To respond to the bot on the account of the owner must be available balance.

Verification

1. Send a test message to the VK community on behalf of a regular user.
2. Wait for the bot's text response.
3. Open History or Chats in ChatRex and find the test dialog.
4. Check the text of the request, the response and the result of the processing.
5. Additionally, send a test photo, document or voice message if the bot needs to work with such attachments.

If the bot does not respond, check:

• whether community messages are included;
• whether the connection of the community in the VK application is completed;
• whether the subscription to the channel is active, if it is required for your account;
• Is the channel assigned to the right bot?
• Whether the call, time and other launch conditions are appropriate;
• Is there enough money on the ChatRex balance sheet?

If the community is not connected

• No access granted. Re-select a community where you have administrator rights and confirm all permissions requested.
• VK has not confirmed access. Press Allow access again and confirm the rights again.
• The community is already connected. It is linked to another ChatRex account. First, disable the integration in that account or contact its owner.
• Notifications are available. Remove ChatRex from community apps and install it again through the mini app as instructed above.
• VK does not respond long. Close the application, open it again and press Check Connection Status. Choose another community if necessary.

Transfer of dialogue to staff

If necessary, stop the automatic processing and continue the dialogue with the client via ChatsChatRex.

Disconnection and reconnection

To revoke ChatRex access, disable VK integration in ChatRex. If necessary, also uninstall the ChatRex app under Manage > Applications of the selected VK community.

To reconnect, open VK integration and go back to the app. Choose a community and confirm permissions. You do not need to create a community access key or manually configure the Callback API.