ВКонтакте: прямое подключение

Сообщения сообщества ВКонтакте приходят в Amobit Chats напрямую: администратор сообщества создаёт ключ доступа, Amobit сам регистрирует Callback API и отправляет ответы операторов. Для вашей внешней системы это обычный канал: события приходят в webhook с channel: "vk", ответы уходят тем же HTTP API.

Обновлено 2026-10-28Нужны: права администратора сообщества и приложение VK на телефоне

Коротко. Ключ доступа сообщества — секрет уровня «управление сообществом»: он создаётся в VK, показывается один раз и хранится в Amobit в зашифрованном виде. Подключение занимает несколько минут; первые 3 дня канала — демо-доступ без карты.

Что понадобится

Подключение в кабинете

  1. Выберите канал

    Кабинет → Настройки → Каналы → Добавить канал → ВКонтакте → Подключить. Выберите тариф «Канал» и срок; демо-доступ на 3 дня, автоматического списания после него нет.

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

    В VK: сообщество → Управление → Работа с API → Ключи доступа → Создать ключ. Включите только четыре права: управление сообществом, сообщения сообщества, фотографии, документы. Подтвердите действие в приложении VK.

  3. Скопируйте ключ

    В списке ключей нажмите Показать, подтвердите SMS-код и скопируйте значение. VK показывает ключ один раз; если он потерян — создайте новый ключ и переподключите канал.

  4. Вставьте ключ в Amobit Chats

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

  5. Проверьте Callback API

    В VK откройте Управление → Работа с API → Callback API: сервер Amobit Chats должен быть в статусе ok, события message_new, message_reply и message_edit — включены. Если сервер в статусе failed, вернитесь в настройки канала в Amobit Chats и нажмите Переподключиться — сервер будет пересоздан и проверен.

  6. Проверьте обмен

    Напишите сообществу с другого аккаунта VK: диалог появится в Amobit Chats → Сообщения. Ответьте из Chats и убедитесь, что сообщение пришло в VK.

Как это работает

Внешняя система не получает доступ к VK и не хранит ключ сообщества: всё взаимодействие идёт через Amobit Chats.

Клиент VK → сообщество (Callback API) → Amobit Chats
                                              │
                          webhook message.created  (channel: "vk")
                                              ↓
                                  ваша CRM / ERP / helpdesk
                                              │
                 POST /api/v1/external-integrations/inbound/messages/
                        Authorization: Bearer amc_…   (ответ в диалог)
                                              ↓
                          Amobit Chats → VK → клиент

В payload webhook сообщения VK приходят с thread.channel и channel_profile.channel равными vk. Поле phone может быть пустым: у сообщества нет телефона клиента. Ответ отправляется по thread.id из события — так же, как для других каналов. Отдельного VK-специфичного API нет.

Имя и аватар клиента Amobit подтягивает из профиля VK при первом сообщении: контакт в кабинете и CRM-карточка получают те же данные, что и в других мессенджерах. Для групповых чатов используются название и фото чата.

Ограничения

Если что-то не работает

СимптомЧто проверить
Ошибка «не хватает прав»Ключ создан без нужных прав. Создайте новый ключ с правами «Сообщения», «Управление», «Фотографии», «Документы» и переподключите канал: изменить права существующего ключа нельзя.
Сообщения не приходятCallback API сервер Amobit Chats в статусе ok; события включены; ключ не отозван. Если сервер failed — «Переподключиться» в настройках канала.
Клиент получил два ответаУ сообщества остался Callback-сервер другой интеграции. Отключите её или удалите её сервер в VK; сервер Amobit Chats не трогайте.
Канал не виден в спискеОбновите страницу после подключения. Если канал так и не появился — напишите в поддержку, проверьте workspace и права пользователя.
Ответ из API возвращает 502VK не подтвердил отправку: проверьте, что диалог ещё существует и клиент не ограничил сообщения; повторите с тем же idempotency_key.

Дальше: быстрый старт · контракт webhooks · справочник HTTP API.

Нужна помощь с подключением? Напишите на info@amobit.io — проверим права ключа, Callback API и доставку событий.