Подключение ВКонтакте
Подключите своё сообщество ВКонтакте одним ключом: создайте ключ, вставьте его в Excella и проверьте переписку. Инструкция со скриншотами и ручным способом подключения.
Что получится
Сообщения вашего сообщества ВКонтакте будут приходить в раздел «Чаты» в Excella. Оператор сможет отвечать из кабинета, а клиент увидит ответ от имени сообщества. Для каждого кабинета подключается своё сообщество.
Создайте ключ сообщества ВК
Нужны права управления сообществом, сообщений и фотографий.
Вставьте ключ в Excella
Нажмите «Подключить по ключу». Адрес, секрет и подтверждение настроятся автоматически.
Проверьте переписку
Отправьте сообществу новое сообщение и ответьте на него из Excella.
1. Откройте управление сообществом ВК
Войдите во ВКонтакте под аккаунтом администратора. Откройте нужное сообщество и нажмите «Управление». В разделе «Сообщения» включите сообщения сообщества и сохраните настройку.

Если кнопки «Управление» нет, попросите владельца сообщества выполнить настройку или предоставить вам права администратора. Обычного доступа к странице сообщества недостаточно.
2. Создайте ключ доступа сообщества
- Откройте «Управление → Дополнительно → Работа с API → Ключи доступа» и нажмите «Создать ключ». Названия пунктов могут немного отличаться.
- Отметьте «Управление сообществом», «Сообщения сообщества» и «Фотографии». Подтвердите создание ключа.
- Скопируйте ключ целиком. Нужен ключ именно подключаемого сообщества, созданный его владельцем или администратором.

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

Дождитесь результата. Excella создаст или обновит сервер Callback API, настроит событие нового сообщения и попробует включить сообщения сообщества. Готовое подключение показывает статус «Подключен». Если появилось предупреждение о подтверждении адреса или сообщениях, выполните указания и повторите «Подключить по ключу».
4. Проверьте сообщение и ответ
Напишите сообществу с другого аккаунта
Например: «Проверка подключения». Используйте новое сообщение после завершения настройки.
Найдите диалог в Excella
Откройте «Чаты», выберите все диалоги и проверьте, что сообщение пришло в нужный кабинет с каналом ВК.
Ответьте из Excella
Отправьте короткий ответ из открытого диалога. На стороне клиента он должен появиться от имени нужного сообщества.
Кнопка «Проверить» в карточке канала помогает проверить доступ к ВК. Окончательная проверка подключения: новое входящее сообщение и успешный ответ в обе стороны.
Если ключ не принимается
| Ошибка | Что сделать |
|---|---|
| User authorization failed: invalid access_token (4), «ВК не принял ключ» | ВК отклонил сам ключ. Создайте новый ключ нужного сообщества с тремя правами из шага 2 и вставьте его целиком. Права администратора в Excella сами по себе не создают ключ ВК. |
| Не хватает прав | Создайте ключ с правами «Управление сообществом», «Сообщения сообщества» и «Фотографии». Если право управления недоступно, используйте ручной способ ниже. |
| Callback API не подтверждён | Повторите «Подключить по ключу» через минуту. При повторной ошибке проверьте доступность адреса Excella и раздел Callback API → Запросы в ВК. |
| Сообщения сообщества выключены | Включите сообщения в настройках ВК и повторите «Подключить по ключу». |
| Сообщество уже подключено в другом кабинете | Проверьте кабинет, к которому оно относится. Одно сообщество подключается к одному активному кабинету. |
Ручной способ: если у ключа нет права управления
Разверните «Ручная настройка Callback API» в карточке ВКонтакте. Настройте сервер в ВК самостоятельно и заполните ID группы, секрет и строку подтверждения. Сохранение выполняется кнопкой «Сохранить ручные настройки». Эта кнопка также сохраняет выключение канала.
В ВК откройте «Работа с API → Callback API», добавьте сервер и укажите адрес:
https://api.excella.ru/api/channels/webhook/VK- Найдите текст «Строка, которую должен вернуть сервер». Скопируйте значение: это код подтверждения для Excella.
- Скопируйте числовой ID сообщества. В примере запроса ВК он указан после
group_id. Если адрес страницы выглядит какclub123456789илиpublic123456789, ID будет123456789, без букв и минуса. - Задайте секретный ключ в настройках Callback API и сохраните его в ВК. Это отдельное случайное значение, которое затем нужно ввести точно так же в Excella.

| Поле в Excella | Что в него ввести |
|---|---|
| Название канала | Понятное вам название, например «Сообщество магазина». |
| Ключ доступа сообщества | Полный ключ доступа, созданный на шаге 2. |
| ID группы | Числовой ID своего сообщества, без club, public и минуса. |
| Секретный ключ | Тот же секретный ключ, который сохранён в Callback API ВК. |
| Строка подтверждения | Строку, которую должен вернуть сервер. При первом подтверждении Callback API это поле нужно заполнить. |
Включите канал в Excella и нажмите «Сохранить ручные настройки». Затем вернитесь в ВК, подтвердите адрес сервера и включите событие нового сообщения:
- Вернитесь в ВК на вкладку «Callback API» и нажмите «Подтвердить» у адреса сервера. ВК должен подтвердить адрес.
- Откройте «Типы событий» для этого сервера. В разделе сообщений включите входящие сообщения, событие
message_new, и сохраните выбор. - Убедитесь, что адрес сервера, код подтверждения и секретный ключ относятся к одному и тому же сообществу.
Кнопка «Проверить» при ручной настройке проверяет доступ ключа к сообществу. Приём событий и отправку ответа обязательно проверьте новым сообщением, как в шаге 4.
Если настройка всё ещё не проходит, откройте «Callback API → Запросы» в ВК. Сохраните время попытки и текст ошибки. В обращении в поддержку укажите ID сообщества; токен и секретный ключ на скриншоте закройте.
Справочные материалы
Экран Excella снят 10 ноября 2026 года на изолированной проверке актуального интерфейса с учебными данными. Скриншоты ВК приведены как учебные примеры, расположение пунктов может отличаться. Источники: VK: ключ доступа сообщества, VK: подключение Callback API. Иллюстрации справки ВК доступны также в открытом учебном материале Chatva.