Как подключить сообщения сообщества VK к Chatix

Chatix подключается к личным сообщениям сообщества ВКонтакте по ключу доступа сообщества. Пользователь пишет в сообщество, AI-агент отвечает по базе знаний, а диалог появляется в общем helpdesk. Для запуска не нужен отдельный сервер: Chatix автоматически создаёт Callback API-подключение.

Не используйте токен личной страницы или обычный вход VK ID. Каналу нужен ключ конкретного сообщества с разрешениями на сообщения и управление.

Что подготовить#

Перед подключением убедитесь, что:

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

1. Включите сообщения сообщества#

Откройте сообщество VK и перейдите в Управление. Найдите настройки сообщений и включите возможность писать сообществу. Если сообщения отключены, пользователь не сможет открыть новый диалог, даже если API-ключ создан правильно.

После включения проверьте кнопку Написать сообщение на публичной странице сообщества с тестового пользовательского аккаунта.

2. Создайте ключ доступа сообщества#

Откройте Управление → Работа с API → Ключи доступа и создайте новый ключ. Это должен быть ключ доступа сообщества, а не пользовательский access token.

Выдайте права:

• Сообщения сообщества — для получения и отправки сообщений;
• Управление сообществом — для автоматической настройки Callback API;
• Фотографии и Документы — если сценарий требует обмена поддерживаемыми файлами.

Набор прав соответствует текущей форме подключения Chatix. Официальная схема методов VK также разделяет community access token и пользовательскую авторизацию; для работы от имени сообщества нужен токен сообщества, доступный его администратору.

Скопируйте ключ один раз и храните как пароль. Не публикуйте его в URL, скриншоте или задаче. Chatix сохраняет ключ зашифрованным и не отдаёт его обратно в публичном конфиге канала.

3. Подключите VK в Chatix#

В Chatix откройте AI-агента и раздел Каналы. На карточке ВКонтакте нажмите Подключить. Вставьте ключ в поле Ключ доступа сообщества и подтвердите подключение.

Chatix автоматически выполняет следующую последовательность:

1. Проверяет ключ методом groups.getById и получает ID и название сообщества.
2. Запрашивает код подтверждения через groups.getCallbackConfirmationCode.
3. Генерирует отдельный секрет для входящих событий.
4. Создаёт Callback API сервер методом groups.addCallbackServer.
5. Включает событие message_new через groups.setCallbackSettings.

Реализация Chatix использует VK API 5.199. Пользователю не нужно копировать URL сервера, confirmation-код или секрет. Если у ключа недостаточно прав либо VK отвергает один из шагов, подключение завершается ошибкой, а не остаётся частично настроенным.

4. Проверьте канал с тестового аккаунта#

Откройте публичную страницу сообщества из другого аккаунта и отправьте личное сообщение. Проверьте несколько реальных сценариев из базы знаний: частый вопрос, вопрос с конкретным условием, уточнение в продолжение диалога и просьбу связать с оператором.

Новый диалог должен появиться в helpdesk Chatix с отметкой VK. Ответ проверяйте по фактам, а не только по стилю. Если агент не находит нужный материал, пройдите диагностику базы знаний.

Какие обращения обрабатываются#

Текущий VK-канал принимает личные сообщения пользователей сообществу. Групповые беседы отсекаются, чтобы не смешивать историю разных контекстов.

Входящее сообщение может содержать текст, фотографию или документ. Chatix загружает только поддерживаемые типы и файлы, проходящие ограничения по размеру. Если вложение отклонено, но в сообщении есть текст, текст всё равно обрабатывается. Длинные ответы разбиваются на части с учётом лимита VK.

Кнопки и другие интерактивные блоки агента в текстовых каналах имеют текстовое представление. Перед запуском проверьте действия агента именно в VK, а не только в веб-виджете.

Почему канал не отвечает#

Проверяйте причины по порядку:

1. Сообщения сообщества выключены. Включите их и проверьте публичную кнопку.
2. Неверный тип токена. Создайте ключ сообщества, а не токен пользователя.
3. Не хватает прав. Проверьте сообщения и управление; для файлов — фотографии и документы.
4. Ключ отозван. Создайте новый и переподключите канал.
5. Пользователь запретил сообщения. VK может запретить отправку из-за блокировки или настроек приватности.
6. Канал отключён в Chatix. Верните статус active и повторите тест.

В отличие от WhatsApp, у VK нет стандартного 24-часового окна ответа для уже открытого диалога. Но сообщество не может игнорировать явный запрет пользователя на сообщения.

Как безопасно заменить ключ#

Если ключ утёк, отзовите его в настройках сообщества. Затем создайте новый ключ с минимально необходимыми правами и переподключите VK в Chatix.

При удалении VK-канала Chatix пытается удалить связанный Callback API сервер, чтобы VK не продолжал отправлять события на старый адрес. Само сообщество, его сообщения и администраторы при этом не удаляются.

Чек-лист перед запуском#

• В сообществе включены личные сообщения.
• Создан именно ключ доступа сообщества.
• Выданы права на сообщения и управление.
• Права на фото и документы добавлены только при необходимости.
• Chatix определил правильное сообщество.
• Тест проведён с отдельного аккаунта на типовых вопросах клиентов.
• Команда знает, что групповые беседы не поддерживаются.
• В базе знаний нет устаревших условий.

Подробнее о возможностях интеграции читайте на странице AI-агента для ВКонтакте. Тот же агент можно подключить к Telegram, MAX и другим опубликованным каналам без копирования базы знаний.