Подключение ВКонтакте: бот, сообщения и мини-приложения

Для многих заведений ВКонтакте — основной канал общения с гостями. После подключения сообщества к WellCa:

• AI-ассистент отвечает на сообщения группы от имени сообщества (или зовёт администратора);
• переписка попадает в диалоги WellCa и в карточки гостей CRM;
• база знаний ассистента наполняется автоматически из истории ваших ответов гостям;
• гости открывают карту гостя, бронь и доставку прямо в VK — через мини-приложение.

Подключение занимает около 10 минут. Понадобятся права администратора сообщества.

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

1. Откройте страницу группы. В адресной строке будет vk.com/club123456789 — число после club и есть ID.
2. Если у группы короткое имя (vk.com/mycafe) — откройте Управление → Информация: ID виден в адресе страницы настроек.

Шаг 2. Создайте ключ доступа

1. В группе: Управление → Работа с API → Ключи доступа → Создать ключ.
2. Отметьте права: сообщения сообщества, управление, фотографии.
3. Подтвердите создание по SMS или через двухфакторную аутентификацию.
4. Скопируйте токен — длинная строка вида vk1.a.…

Токен показывается один раз при создании. Не успели скопировать — создайте новый.

Шаг 3. Вставьте данные в WellCa

1. Откройте AI-ассистент → вкладка «Каналы» → карточка «ВКонтакте».
2. Заполните «Ключ доступа» и «ID сообщества».
3. Подсказка «Как получить ключи» с теми же шагами есть прямо в карточке.

Шаг 4. Настройте Callback API

Callback API — это «звонок» от VK на сервер WellCa о каждом новом сообщении. Без него сообщения гостей до WellCa не дойдут.

1. Скопируйте «URL вебхука» из карточки «ВКонтакте» в WellCa.
2. В группе: Управление → Работа с API → Callback API → вставьте URL в поле «Адрес сервера».
3. VK покажет строку подтверждения — вставьте её в одноимённое поле в WellCa и сохраните настройки.
4. Секретный ключ придумайте сами (любая строка) и впишите одинаково в двух местах: в WellCa и в настройках Callback API группы.
5. Нажмите «Подтвердить» в VK — адрес сервера должен подтвердиться.
6. На вкладке «Типы событий» включите «Входящие сообщения». Хотите собирать комментарии в мониторинг отзывов — включите и события комментариев.
7. Рядом, в разделе Long Poll API, тоже включите события сообщений — это резервный канал получения.

Шаг 5. Проверьте

Напишите сообщение сообществу с личного аккаунта. Оно должно появиться в диалогах WellCa, и ассистент ответит (в настроенном режиме). Если сообщение не пришло — см. чек-лист ниже.

Наполните базу знаний из истории VK

После подключения нажмите «Наполнить» в настройках AI-ассистента — WellCa подтянет историю диалогов сообщества и соберёт базу знаний из реальных ответов ваших администраторов. Это закрывает большую часть настройки ассистента без ручного ввода.

Мини-приложения: карта, бронь, доставка и меню в VK

В VK нет ботов в привычном смысле — карта гостя, бронирование и доставка работают через мини-приложение VK. Готовые ссылки уже собраны в кабинете:

1. Откройте Настройки → Интеграции → вкладка «Каналы гостя» → раздел «Ссылки приложения „Карта гостя“».
2. Там четыре ссылки с кодом вашего заведения в адресе: Карта гостя, Бронирование, Доставка и Меню.
3. Скопируйте нужную и добавьте кнопкой в меню сообщества (Управление → Меню), в пост, на сайт или в QR-код.

Заведение и раздел зашиты в параметрах ссылки, поэтому она работает по прямому переходу — даже до установки приложения в сообщество.

Ссылка «Меню» — просто посмотреть

Ссылка Меню открывает меню заведения в режиме просмотра: блюда, состав и цены — без корзины, без выбора адреса и без входа по номеру телефона. Это то, что нужно для поста «а вот наше новое меню», кнопки в шапке сообщества или QR-кода на витрине: гость сразу видит блюда, а не форму заказа.

В режиме просмотра показываются все позиции, в том числе те, что сейчас вне часов доставки, — гость смотрит меню целиком. Открывается оно на домене вашего заведения: если подключён свой домен, гость останется на нём, а не уйдёт на чужой адрес.

Для заказа по-прежнему нужна ссылка Доставка — там корзина, адрес и оплата.

Если сообщения из VK не приходят

Проверьте по порядку:

1. У группы несколько Callback-получателей. VK рассылает события всем подключённым серверам, и если сторонняя интеграция (Albato, конструктор рассылок, CRM) отвечает ошибкой, VK начинает доставлять события нестабильно — часть сообщений не доходит. Откройте Callback API → список серверов и отключите неиспользуемые; там же, в «Ключах доступа», удалите ключи старых интеграций.
2. Выключен тип события. Callback API → «Типы событий» → «Входящие сообщения» должно быть включено (после сбоев VK иногда сбрасывает галочки).
3. Ключ доступа протух или пересоздан. При создании нового ключа старый перестаёт работать — вставьте свежий токен в WellCa.
4. Не совпадает секретный ключ в VK и WellCa — такие события отбрасываются как чужие.

После исправления снова отправьте тестовое сообщение сообществу и убедитесь, что оно появилось в WellCa.

Смотрите также

• Профиль бота: название, описание и логотип
• MAX-бот: создание и подключение
• Карта гостя: что видит гость
• Мониторинг отзывов: VK, Яндекс, 2ГИС и Google
• Уведомления в Telegram: каналы для персонала

Где подключается сам канал — ВКонтакте, Telegram, MAX, Instagram и почта: Интеграции.