# Подключение VK

Прямая интеграция VK передаёт в ChatRex новые сообщения сообщества и отправляет ответы бота от имени сообщества. Для подключения не нужно создавать ключ доступа, копировать ID сообщества или вручную настраивать Callback API: сообщество и разрешения выбираются в официальном приложении ChatRex в VK.

ChatRex принимает входящий текст, фотографии, документы и голосовые сообщения. Голосовые сообщения передаются на распознавание, а изображения и документы могут использоваться ботом при обработке обращения.

# Перед подключением

Подготовьте:

• аккаунт ChatRex;
• сообщество VK с включёнными сообщениями;
• аккаунт VK с правами администратора нужного сообщества.

Одно сообщество можно подключить только к одному аккаунту ChatRex.

# Подключение сообщества

1. В ChatRex откройте Интеграции.
2. Нажмите Подключить интеграцию.
3. На вкладке Каналы выберите VK и нажмите Подключить.
4. В настройках интеграции нажмите Открыть приложение VK.
5. Если приложение предложит авторизоваться, нажмите Войти в ChatRex и войдите в нужный аккаунт. После входа вернитесь в приложение VK.
6. Нажмите Выбрать сообщество.
7. Выберите сообщество, которым вы управляете.
8. Подтвердите запрошенный VK доступ к управлению сообществом и его сообщениям.
9. Дождитесь сообщения Сообщество подключено.

После подтверждения ChatRex проверит права и автоматически настроит получение новых сообщений. ID сообщества и выданный VK ключ передаются приложением безопасно — вводить или копировать их вручную не требуется.

# Подписка на канал

После подключения ChatRex автоматически добавит VK к подходящей действующей подписке, если в ней есть свободное место для канала.

Возможны три результата:

• канал добавлен к подписке автоматически — можно переходить к назначению бота;
• аккаунт работает в режиме использования без абонентской платы — отдельная подписка на канал пока не требуется;
• подходящей подписки или свободного места нет — добавьте канал VK в подписку вручную в ChatRex.

# Назначение канала боту

1. Откройте Мои боты и нажмите Изменить напротив нужного бота.
2. Перейдите во вкладку Каналы и запуск.
3. В блоке Условия по каналам нажмите Добавить канал.
4. Выберите подключённый VK.
5. При необходимости настройте дополнительные условия и время работы.
6. Сохраните изменения.

# Чат в приложении сообщества

После подключения приложение ChatRex остаётся доступно на странице сообщества VK:

• администратор видит, что сообщество уже подключено;
• посетитель сообщества может открыть приложение и написать назначенному боту прямо в нём;
• если канал не назначен ни одному боту, посетитель увидит сообщение, что чат пока недоступен.

Диалоги из приложения обрабатываются в ChatRex. Для ответа бота на аккаунте владельца должен быть доступный баланс.

# Проверка

1. Отправьте тестовое сообщение сообществу VK от имени обычного пользователя.
2. Дождитесь текстового ответа бота.
3. Откройте Историю или Чаты в ChatRex и найдите тестовый диалог.
4. Проверьте текст запроса, ответ и результат обработки.
5. Дополнительно отправьте тестовую фотографию, документ или голосовое сообщение, если бот должен работать с такими вложениями.

Если бот не отвечает, проверьте:

• включены ли сообщения сообщества;
• завершилось ли подключение сообщества в приложении VK;
• активна ли подписка на канал, если она требуется для вашего аккаунта;
• назначен ли канал нужному боту;
• подходят ли обращение, время и другие условия запуска;
• достаточно ли средств на балансе ChatRex.

# Если сообщество не подключается

• Доступ не выдан. Повторно выберите сообщество, где у вас есть права администратора, и подтвердите все запрошенные разрешения.
• VK не подтвердил доступ. Нажмите Разрешить доступ снова и повторно подтвердите права.
• Сообщество уже подключено. Оно связано с другим аккаунтом ChatRex. Сначала отключите интеграцию в том аккаунте или обратитесь к его владельцу.
• Подключение уведомлений не завершилось. Удалите ChatRex из приложений сообщества и установите его заново через мини-приложение по инструкции выше.
• VK долго не отвечает. Закройте приложение, откройте его снова и нажмите Проверить статус подключения. При необходимости выберите другое сообщество.

# Передача диалога сотруднику

При необходимости остановите автоматическую обработку и продолжите диалог с клиентом через Чаты ChatRex.

# Отключение и повторное подключение

Чтобы отозвать доступ ChatRex, отключите интеграцию VK в ChatRex. При необходимости также удалите приложение ChatRex в разделе Управление → Приложения выбранного сообщества VK.

Для повторного подключения откройте интеграцию VK и снова перейдите в приложение. Выберите сообщество и подтвердите разрешения. Создавать ключ доступа сообщества или настраивать Callback API вручную не нужно.