Как подключить VK к AI-чат-боту
Канал VK нужен, чтобы AI-чат-бот отвечал на сообщения вашего сообщества VK. Основной сценарий первой линии — текстовые сообщения.
Важно: канал считается подключенным только после полной настройки Callback API в VK и тестового сообщения. Одной успешной проверки token недостаточно.
Что нужно заранее
- У вас уже есть сообщество VK.
- У вас есть доступ к настройкам этого сообщества.
- AI-чат-бот уже создан.
- AI-чат-бот включен.
Какие данные понадобятся
- Название канала — задается в Mobitsa.
- Group token — создается в VK и вставляется в Mobitsa.
- Строка подтверждения VK — показывается в VK и вставляется в Mobitsa.
- Secret key Callback API — берется в Mobitsa и вставляется в VK.
- Адрес Callback API — берется в Mobitsa и вставляется в VK.
Шаг 1. Добавьте канал VK в Mobitsa
- Откройте нужного AI-чат-бота.
- Перейдите в раздел Подключения.
- Добавьте новый канал VK.
Шаг 2. Получите данные из формы канала VK
В форме канала VK вам понадобятся следующие поля и значения:
- Название канала.
- Group token.
- Строка подтверждения VK.
- Secret key Callback API для копирования.
- Адрес Callback API для копирования.
На этом этапе важно запомнить источники данных: Group token и Строка подтверждения VK приходят из VK, а Secret key Callback API и Адрес Callback API берутся из Mobitsa.
Шаг 3. Подготовьте сообщество VK
- Откройте сообщество VK.
- Перейдите в Управление.
- Откройте раздел Сообщения.
- Включите Сообщения сообщества.
- Затем откройте Управление → Дополнительно → Работа с API.
Шаг 4. Получите Group token в VK
В разделе работы с API создайте ключ доступа для сообщений сообщества.
- Создайте ключ доступа.
- Скопируйте его.
- Вставьте значение в поле Group token в Mobitsa.
Именно этот токен используется для проверки доступа к сообществу.
Шаг 5. Добавьте Callback API сервер
Во вкладке Callback API в VK добавьте сервер.
- Откройте вкладку Callback API.
- Нажмите добавление сервера.
- В поле адреса сервера вставьте Адрес Callback API из формы канала VK в Mobitsa.
Шаг 6. Скопируйте строку подтверждения VK
После добавления сервера VK покажет строку вида «Строка, которую должен вернуть сервер».
- Скопируйте эту строку в VK.
- Вставьте ее в поле Строка подтверждения VK в Mobitsa.
- Вернитесь в VK и нажмите Подтвердить.
Важно: строку подтверждения выдает VK, а не Mobitsa.
Шаг 7. Укажите Secret key
- Скопируйте Secret key Callback API из Mobitsa.
- Вставьте его в поле Секретный ключ в настройках Callback API в VK.
Важно: Secret key Callback API берется из Mobitsa, а Строка подтверждения VK — из VK.
Шаг 8. Включите события сообщений
После настройки сервера откройте в VK раздел Типы событий и включите события из блока Сообщения.
Это обязательный шаг. Даже если токен проверен и сервер добавлен, без событий сообщения не будут приходить в канал.
Шаг 9. Проверьте token в Mobitsa
Вернитесь в Mobitsa и нажмите Проверить token.
После успешной проверки нажмите Сохранить в канале чат-бота.
Успешная проверка подтверждает только корректность токена сообщества. Она не означает, что весь канал уже полностью работает.
Шаг 10. Отправьте тестовое сообщение
- Отправьте сообщение в сообщения сообщества VK.
- Вернитесь в Mobitsa.
- Проверьте, появился ли новый диалог.
- Проверьте, ответил ли AI-чат-бот.
Именно тестовое сообщение считается финальной проверкой подключения.
Как понять, что VK подключен правильно
- Проверка token прошла успешно.
- Callback API настроен.
- События сообщений включены.
- Тестовое сообщение пришло.
- В Mobitsa появился диалог.
- AI-чат-бот ответил.
Что делать, если канал не работает
- Проверьте, правильно ли вставлен Group token.
- Убедитесь, что в VK указан Адрес Callback API из Mobitsa.
- Проверьте, заполнено ли поле Строка подтверждения VK.
- Проверьте, вставлен ли Secret key Callback API.
- Убедитесь, что в VK включены события из раздела Сообщения.
- После настройки отправьте новое тестовое сообщение.
Если token проходит проверку, но диалогов нет, причина обычно связана с Callback API или настройкой событий.
Что важно не путать
- Group token — ключ доступа сообщества из VK.
- Строка подтверждения VK — строка, которую показывает VK.
- Secret key Callback API — значение из Mobitsa для настроек VK.
- Адрес Callback API — адрес сервера из Mobitsa для настроек VK.
Помните: рабочим подключением канал считается только после успешного тестового сообщения и появления диалога в Mobitsa.