Как подключить 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

1. Откройте нужного AI-агента.
2. Перейдите в раздел Каналы.
3. Добавьте новый канал 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

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

Шаг 4. Получите Group token в VK

В разделе работы с API создайте ключ доступа для сообщений сообщества.

1. Создайте ключ доступа.
2. Скопируйте его.
3. Вставьте значение в поле Group token в Mobitsa.

Именно этот токен используется для проверки доступа к сообществу.

Шаг 5. Добавьте Callback API сервер

Во вкладке Callback API в VK добавьте сервер.

1. Откройте вкладку Callback API.
2. Нажмите добавление сервера.
3. В поле адреса сервера вставьте Адрес Callback API из формы канала VK в Mobitsa.

Шаг 6. Скопируйте строку подтверждения VK

После добавления сервера VK покажет строку вида «Строка, которую должен вернуть сервер».

1. Скопируйте эту строку в VK.
2. Вставьте ее в поле Строка подтверждения VK в Mobitsa.
3. Вернитесь в VK и нажмите Подтвердить.

Важно: строку подтверждения выдает VK, а не Mobitsa.

Шаг 7. Укажите Secret key

1. Скопируйте Secret key Callback API из Mobitsa.
2. Вставьте его в поле Секретный ключ в настройках Callback API в VK.

Важно: Secret key Callback API берется из Mobitsa, а Строка подтверждения VK — из VK.

Шаг 8. Включите события сообщений

После настройки сервера откройте в VK раздел Типы событий и включите события из блока Сообщения.

Это обязательный шаг. Даже если токен проверен и сервер добавлен, без событий сообщения не будут приходить в канал.

Шаг 9. Проверьте token в Mobitsa

Вернитесь в Mobitsa и нажмите Проверить token.

После успешной проверки нажмите Сохранить в канале агента.

Успешная проверка подтверждает только корректность токена сообщества. Она не означает, что весь канал уже полностью работает.

Шаг 10. Отправьте тестовое сообщение

1. Отправьте сообщение в сообщения сообщества VK.
2. Вернитесь в Mobitsa.
3. Проверьте, появился ли новый диалог.
4. Проверьте, ответил ли 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.