Подключение ВКонтакте

Подключите своё сообщество ВКонтакте одним ключом: создайте ключ, вставьте его в Excella и проверьте переписку. Инструкция со скриншотами и ручным способом подключения.

Версия API v3.2Обновлено 10 ноября 2026 г.Время чтения ~3 минAPI оперативно: 99.98%

Что получится

Сообщения вашего сообщества ВКонтакте будут приходить в раздел «Чаты» в Excella. Оператор сможет отвечать из кабинета, а клиент увидит ответ от имени сообщества. Для каждого кабинета подключается своё сообщество.

i
Подготовьте две вкладки
Откройте управление сообществом ВК и кабинет Excella → Настройки → Каналы. Настройку ВК выполняет владелец или администратор сообщества. В Excella нужен доступ к настройкам каналов.
ШАГ 01

Создайте ключ сообщества ВК

Нужны права управления сообществом, сообщений и фотографий.

ШАГ 02

Вставьте ключ в Excella

Нажмите «Подключить по ключу». Адрес, секрет и подтверждение настроятся автоматически.

ШАГ 03

Проверьте переписку

Отправьте сообществу новое сообщение и ответьте на него из Excella.

1. Откройте управление сообществом ВК

Войдите во ВКонтакте под аккаунтом администратора. Откройте нужное сообщество и нажмите «Управление». В разделе «Сообщения» включите сообщения сообщества и сохраните настройку.

Страница сообщества ВК: пункт «Управление» в правом меню
ВК: вход в управление сообществом. Учебный скриншот из справочных материалов VK; оформление вашего сообщества может отличаться.

Если кнопки «Управление» нет, попросите владельца сообщества выполнить настройку или предоставить вам права администратора. Обычного доступа к странице сообщества недостаточно.

2. Создайте ключ доступа сообщества

  1. Откройте «Управление → Дополнительно → Работа с API → Ключи доступа» и нажмите «Создать ключ». Названия пунктов могут немного отличаться.
  2. Отметьте «Управление сообществом», «Сообщения сообщества» и «Фотографии». Подтвердите создание ключа.
  3. Скопируйте ключ целиком. Нужен ключ именно подключаемого сообщества, созданный его владельцем или администратором.
Настройки ВК: «Работа с API», вкладка «Ключи доступа» и кнопка «Создать ключ»
ВК: раздел ключей и кнопка «Создать ключ». Учебный пример, набор прав на экране может отличаться. Для автоматической настройки выберите три права из шага выше.
!
Токен вводится только в карточку канала
Это ключ доступа к переписке сообщества. Не публикуйте его в постах, общих документах и скриншотах. Личный пользовательский токен вместо ключа сообщества не подходит. Права на стену, товары и участников для обычной переписки не нужны.

3. Подключите сообщество одним ключом

В кабинете Excella откройте «Настройки → Каналы → ВКонтакте». Вставьте полный ключ в поле «Ключ доступа сообщества» и нажмите «Подключить по ключу». Эта кнопка включает канал. Сообщество определяется по ключу; ID, секрет и код подтверждения вручную вводить не нужно.

Новая карточка ВКонтакте в Excella. Реальный экран интерфейса в изолированной проверке с учебным сообществом; ключ скрыт. Для автоматической настройки используется кнопка «Подключить по ключу».
Новая карточка ВКонтакте в Excella. Реальный экран интерфейса в изолированной проверке с учебным сообществом; ключ скрыт. Для автоматической настройки используется кнопка «Подключить по ключу».

Дождитесь результата. Excella создаст или обновит сервер Callback API, настроит событие нового сообщения и попробует включить сообщения сообщества. Готовое подключение показывает статус «Подключен». Если появилось предупреждение о подтверждении адреса или сообщениях, выполните указания и повторите «Подключить по ключу».

✓
Одна компания, одно подключение
Одно активное сообщество ВК подключается к одному кабинету Excella. Если появится сообщение «Это сообщество ВК уже подключено в другом кабинете», проверьте прежнее подключение. Не подставляйте ID другого сообщества.

4. Проверьте сообщение и ответ

ШАГ 01

Напишите сообществу с другого аккаунта

Например: «Проверка подключения». Используйте новое сообщение после завершения настройки.

ШАГ 02

Найдите диалог в Excella

Откройте «Чаты», выберите все диалоги и проверьте, что сообщение пришло в нужный кабинет с каналом ВК.

ШАГ 03

Ответьте из Excella

Отправьте короткий ответ из открытого диалога. На стороне клиента он должен появиться от имени нужного сообщества.

Кнопка «Проверить» в карточке канала помогает проверить доступ к ВК. Окончательная проверка подключения: новое входящее сообщение и успешный ответ в обе стороны.

i
Приём сообщений и AI-ответы настраиваются отдельно
Подключение канала позволяет получать сообщения и отвечать оператору. Для автоматических ответов отдельно настройте AI-бота: модель и ключ доступа, базу знаний и правила работы, затем включите его. Если AI-бот выключен, автоматического ответа не будет.

Если ключ не принимается

ОшибкаЧто сделать
User authorization failed: invalid access_token (4), «ВК не принял ключ»ВК отклонил сам ключ. Создайте новый ключ нужного сообщества с тремя правами из шага 2 и вставьте его целиком. Права администратора в Excella сами по себе не создают ключ ВК.
Не хватает правСоздайте ключ с правами «Управление сообществом», «Сообщения сообщества» и «Фотографии». Если право управления недоступно, используйте ручной способ ниже.
Callback API не подтверждёнПовторите «Подключить по ключу» через минуту. При повторной ошибке проверьте доступность адреса Excella и раздел Callback API → Запросы в ВК.
Сообщения сообщества выключеныВключите сообщения в настройках ВК и повторите «Подключить по ключу».
Сообщество уже подключено в другом кабинетеПроверьте кабинет, к которому оно относится. Одно сообщество подключается к одному активному кабинету.

Ручной способ: если у ключа нет права управления

Разверните «Ручная настройка Callback API» в карточке ВКонтакте. Настройте сервер в ВК самостоятельно и заполните ID группы, секрет и строку подтверждения. Сохранение выполняется кнопкой «Сохранить ручные настройки». Эта кнопка также сохраняет выключение канала.

В ВК откройте «Работа с API → Callback API», добавьте сервер и укажите адрес:

Адрес сервера ExcellaTEXT
https://api.excella.ru/api/channels/webhook/VK
  1. Найдите текст «Строка, которую должен вернуть сервер». Скопируйте значение: это код подтверждения для Excella.
  2. Скопируйте числовой ID сообщества. В примере запроса ВК он указан после group_id. Если адрес страницы выглядит как club123456789 или public123456789, ID будет 123456789, без букв и минуса.
  3. Задайте секретный ключ в настройках Callback API и сохраните его в ВК. Это отдельное случайное значение, которое затем нужно ввести точно так же в Excella.
Пример Callback API ВК с полями адреса сервера, строки подтверждения и секретного ключа
ВК: где находятся адрес, код подтверждения и секретный ключ. Это учебный пример. Для Excella используйте адрес из блока выше и значения своего сообщества.
Поле в ExcellaЧто в него ввести
Название каналаПонятное вам название, например «Сообщество магазина».
Ключ доступа сообществаПолный ключ доступа, созданный на шаге 2.
ID группыЧисловой ID своего сообщества, без club, public и минуса.
Секретный ключТот же секретный ключ, который сохранён в Callback API ВК.
Строка подтвержденияСтроку, которую должен вернуть сервер. При первом подтверждении Callback API это поле нужно заполнить.

Включите канал в Excella и нажмите «Сохранить ручные настройки». Затем вернитесь в ВК, подтвердите адрес сервера и включите событие нового сообщения:

  1. Вернитесь в ВК на вкладку «Callback API» и нажмите «Подтвердить» у адреса сервера. ВК должен подтвердить адрес.
  2. Откройте «Типы событий» для этого сервера. В разделе сообщений включите входящие сообщения, событие message_new, и сохраните выбор.
  3. Убедитесь, что адрес сервера, код подтверждения и секретный ключ относятся к одному и тому же сообществу.

Кнопка «Проверить» при ручной настройке проверяет доступ ключа к сообществу. Приём событий и отправку ответа обязательно проверьте новым сообщением, как в шаге 4.

Если настройка всё ещё не проходит, откройте «Callback API → Запросы» в ВК. Сохраните время попытки и текст ошибки. В обращении в поддержку укажите ID сообщества; токен и секретный ключ на скриншоте закройте.

Справочные материалы

Экран Excella снят 10 ноября 2026 года на изолированной проверке актуального интерфейса с учебными данными. Скриншоты ВК приведены как учебные примеры, расположение пунктов может отличаться. Источники: VK: ключ доступа сообщества, VK: подключение Callback API. Иллюстрации справки ВК доступны также в открытом учебном материале Chatva.