Интеграция с VK (ВКонтакте)

Интеграция Wikilect с VK позволяет создать AI-бот для сообщества ВКонтакте на основе вашего AI-консультанта. Это дает возможность пользователям взаимодействовать с вашим ботом через сообщения сообщества VK.

Настройка интеграции с VK

Шаг 1: Подготовка сообщества VK

Перед настройкой интеграции в Wikilect необходимо подготовить сообщество VK:

Создайте новое сообщество VK или используйте существующее
Перейдите в Управление → Сообщения
Включите возможность отправки сообщений сообществу
Задайте приветственное сообещние, которое будет отображаться при первом открытии диалога
Сохраните изменения

Шаг 2: Настройка Callback API в VK

Перейдите в Управление → Дополнительно → Работа с API → Callback API
В поле Адрес укажите URL вебхука в формате:
```
https://app.wikilect.com/api/bots/vk_bot/webhook/{group_id}
```
где {group_id} — это ID вашего сообщества VK
Скопируйте код подтверждения ("Строка, которую должен веруть сервер") — он понадобится при создании интеграции в Wikilect
Не нажимать кнопку Подтвердить до создания интеграции в интерфейсе Wikilect !
При необходимости можно задать секретный ключ для дополнительной безопасности. Лучше задать для безопасности! (любая строка)
В разделе Типы событий включите событие Входящее сообщение

Шаг 3: Получение ключа доступа

В настройках сообщества перейдите в Работа с API → Ключи доступа
Нажмите Создать ключ
Выберите необходимые права доступа:
Разрешить приложению доступ к сообщения сообщества — обязательно
Подтвердите создание ключа и скопируйте его

Шаг 4: Настройка интеграции в Wikilect

Перейдите в раздел Настройки → Консультанты
Выберите навык, для которого хотите настроить интеграцию с VK
На вкладке Интеграции выберите VK
Заполните необходимые поля:

Название — имя интеграции для отображения в системе
ID сообщества — числовой ID вашего сообщества VK
Код подтверждения — код из настроек Callback API
Ключ доступа сообщества — ключ, полученный на предыдущем шаге
Секретный ключ — опционально, для дополнительной безопасности
Приветственное сообщение — текст, отправляемый при создании нового диалога (комманды /start или начать)

Шаг 5: Подтверждение сервера в VK

После создания интеграции в Wikilect вернитесь в настройки Callback API в VK
Нажмите кнопку Подтвердить
Если всё настроено правильно, статус сервера изменится на "Подтверждён"

Возможности интеграции с VK

Автоматические ответы на сообщения

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

Обработка команд

Бот поддерживает следующие команды для управления диалогом:

/start или начать — начало нового диалога с ботом
Любое другое сообщение обрабатывается AI-консультантом

Индикатор набора текста

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

Панель управления чатами

В личном кабинете Wikilect в разделе Внешние консультанты вы можете управлять чатами VK-бота:

Просматривать историю сообщений
Отвечать пользователям вручную (отключив автоответы)
Видеть информацию о пользователях VK
Просматривать статистику использования бота

Переключение между ботом и оператором

Функция "отвечает AI консультант" позволяет при необходимости отключить автоматические ответы бота и перейти на ручное общение с пользователем:

В чате с пользователем выключите переключатель "отвечает AI консультант"
Теперь вы можете отвечать пользователю напрямую из интерфейса Wikilect
Пользователь не будет знать, что общается уже не с ботом, а с оператором

Интеграция с другими системами

AmoCRM

VK-интеграция поддерживает передачу данных в AmoCRM:

Автоматическое создание лидов из диалогов VK
Передача истории переписки в карточку клиента
Синхронизация контактной информации

Использование плагинов с VK-ботом

Плагины Wikilect также могут работать в интеграции с VK:

Вызов менеджера — переключение на живого оператора при определенных условиях
Поисковик по контексту — использование базы знаний для ответов
API и другие плагины для расширения функциональности

API для управления VK-ботами

Для программного управления VK-интеграциями доступен REST API:

Создание интеграции

POST /bots/vk_bot/
Content-Type: application/json

{
  "name": "Мой VK бот",
  "group_id": 123456789,
  "access_token": "vk_access_token",
  "confirmation_code": "abc123",
  "secret_key": "optional_secret",
  "bot_first_message": "Здравствуйте! Чем могу помочь?",
  "skill": 1
}

Параметры модели VKBot

Параметр	Тип	Описание
`name`	string	Название интеграции
`group_id`	integer	ID сообщества VK
`access_token`	string	Ключ доступа сообщества
`confirmation_code`	string	Код подтверждения для Callback API
`secret_key`	string	Опциональный секретный ключ
`bot_first_message`	string	Приветственное сообщение
`api_version`	string	Версия API VK (по умолчанию 5.199)
`skill`	integer	ID навыка для обработки сообщений

Webhook для Callback API

GET/POST /bots/vk_bot/webhook/{group_id}

Этот endpoint обрабатывает входящие события от VK Callback API.

Решение проблем

Сервер не подтверждается

Убедитесь, что URL вебхука указан правильно
Проверьте, что код подтверждения в Wikilect совпадает с кодом в VK
Убедитесь, что интеграция сохранена в Wikilect перед подтверждением

Бот не отвечает на сообщения

Проверьте статус сервера в настройках Callback API
Убедитесь, что включено событие message_new
Проверьте права ключа доступа (должно быть разрешение на сообщения)
Проверьте, что навык активен и правильно настроен

Ошибки доступа

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