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

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

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

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

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

• аккаунт ChatRex;
• сообщество VK с включёнными сообщениями;
• права владельца или администратора сообщества;
• числовой ID сообщества;
• доступ к разделу Управление → Дополнительно → Работа с API;
• активную подписку ChatRex со свободным местом для канала.

# Создание ключа доступа

1. Откройте нужное сообщество VK.
2. Перейдите в Управление → Дополнительно → Работа с API.
3. Создайте ключ доступа сообщества.
4. Разрешите ключу:
   • Управление сообществом;
   • Сообщения сообщества.
5. Скопируйте ключ.

# Подключение в ChatRex

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

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

# Активация подписки

Подключённый VK занимает одно место канала в подписке ChatRex.

Если в списке интеграций у VK отображается неактивная подписка:

1. Добавьте канал VK в подписку.
2. Проверьте доступное количество каналов.
3. Убедитесь, что статус подписки изменился на активный.

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

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

# Проверка

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

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

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

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

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

# Замена ключа и повторное подключение

Для замены отозванного или устаревшего ключа откройте Настроить у существующей интеграции VK, отключите соединение и подключите его повторно с новым ключом. Используйте существующую карточку интеграции — создавать дубликат канала не требуется.

Ключ сообщества хранится на сервере ChatRex и не передаётся боту или в текст диалога. События VK проверяются по сообществу и защищены от повторной обработки.