Как подключить ВКонтакте к O-Key

В этом руководстве вы узнаете, как подключить ВКонтакте к O-Key, чтобы AI-агент автоматически отвечал на сообщения. Доступны два способа: через сообщество (рекомендуемый) и через личный аккаунт.

Сообщество (рекомендуемый)

Подключение через сообщество

Это официальный и стабильный способ подключения. Вам потребуется VK-сообщество с правами администратора.

Что нужно для начала

• Аккаунт ВКонтакте
• VK-сообщество (группа), в котором вы администратор
• Аккаунт O-Key с настроенным AI-агентом

Шаги подключения

1. Найдите ID вашего сообщества

   Откройте вашу группу ВКонтакте. ID группы — это число в URL-адресе (например, vk.com/club123456789 — ID = 123456789).

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

   Перейдите в «Управление» → «Сообщения» и включите получение сообщений.

3. Создайте токен доступа

   В разделе «Управление» → «Работа с API» создайте новый ключ доступа, выбрав все необходимые разрешения.

4. Получите код подтверждения

   На вкладке «Callback API» скопируйте строку из поля «Код подтверждения».

5. Откройте настройки каналов в O-Key

   В O-Key CRM перейдите в «Агенты» → «Настройки» → «Подключение каналов».

6. Выберите ВКонтакте

   Нажмите «ВКонтакте» и убедитесь, что выбран режим «Сообщество».

7. Заполните данные

   Введите три поля: ID группы, токен группы и код подтверждения.

8. Сохраните и скопируйте Callback URL

   После сохранения O-Key сгенерирует Callback URL — скопируйте его.

9. Вставьте URL в VK

   Вернитесь в VK, на вкладку «Callback API», и вставьте URL в поле адреса сервера.

10. Подтвердите подключение

    Нажмите «Подтвердить». Зелёная галочка означает успешное подключение.

11. Включите событие «Входящее сообщение»

    На вкладке «Типы событий» поставьте галочку напротив message_new (Входящее сообщение).

12. Протестируйте

    Напишите сообщение в сообщество с другого аккаунта — AI-агент должен ответить автоматически.

Совет

Если бот не отвечает сразу, подождите 1–2 минуты — первое подключение может занять некоторое время.

Личный аккаунт

Подключение через личный аккаунт

Опасно

Это неофициальный способ. ВКонтакте может в любой момент ограничить ваш аккаунт. Используйте на свой страх и риск.

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

1. Откройте vkhost.github.io

   Перейдите на сайт для получения токена.

2. Авторизуйтесь через VK Admin

   Выберите приложение VK Admin и пройдите авторизацию.

3. Скопируйте access_token

   Из URL-адреса в адресной строке извлеките значение access_token.

4. Переключите режим в O-Key

   В настройках канала ВКонтакте выберите «Личный аккаунт» и вставьте токен.

5. Протестируйте

   Попросите кого-нибудь написать вам в личные сообщения.

Осторожно

Токен личного аккаунта истекает примерно через 12 часов. При возникновении предупреждений от VK рекомендуем перейти на метод через сообщество.

Устранение неполадок

Бот не отвечает в группе

• Убедитесь, что событие message_new включено в типах событий VK
• Проверьте, что токен доступа не истёк
• Убедитесь, что AI-агент не поставлен на паузу в O-Key

VK показывает «Ошибка сервера»

• Сравните код подтверждения в O-Key и VK — они должны совпадать точно
• Пересохраните настройки в O-Key и повторите подтверждение

Личный бот перестал отвечать

• Сгенерируйте новый токен через vkhost.github.io
• Если VK присылает предупреждения, перейдите на метод через сообщество

Чаты не отображаются в CRM

• Отправьте новое сообщение после подключения — старые чаты могут не синхронизироваться
• Проверьте фильтр каналов — выберите «Все каналы»

---

Если проблема не решена, напишите нам: support@o-key.ai