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

Агент отвечает на сообщения вашего сообщества. Пять шагов, порядок важен.

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

ВКонтакте присылает новые сообщения сообщества на наш адрес (Callback API), агент обрабатывает их и отвечает от имени сообщества. Каждый диалог — отдельная беседа с памятью, как в Telegram. Настройка делается в двух местах — в сообществе ВКонтакте и в агенте — и порядок действий важен.

Другие каналы: Telegram, виджет на сайт и WhatsApp через Wazzup.

Шаг 1. Ключ сообщества

  1. Откройте своё сообщество → Управление → Работа с API.
  2. Создайте ключ доступа сообщества с правом «Сообщения сообщества» и скопируйте его.
  3. ID сообщества — число из настроек или из адреса страницы управления.

Шаг 2. Заполните форму в агенте

  1. Откройте агента → блок «Где работает» → «Подключить» у строки ВКонтакте. Инструкция там раскрыта сама.
  2. Вставьте ID сообщества и Токен сообщества.
  3. Нажмите «Придумать» у Секретного ключа — он обязателен, мы создадим его сами. Не закрывайте страницу: тот же ключ понадобится во ВКонтакте.

Шаг 3. Callback API во ВКонтакте

  1. В сообществе откройте Работа с API → Callback API и добавьте сервер с адресом из панели в агенте.
  2. Впишите тот же секретный ключ, что в форме агента.
  3. Скопируйте строку подтверждения в поле «Строка подтверждения» в агенте.
  4. В Типах событий включите Входящие сообщения (message_new).

Шаг 4. Подключить, затем подтвердить

  1. В агенте нажмите «Подключить».
  2. Только после этого во ВКонтакте нажмите «Подтвердить» — иначе ВКонтакте не получит ответа.
  3. Напишите сообществу в личные сообщения — агент ответит.

Включите в сообществе возможность писать сообщения (Управление → Сообщения → «Сообщения сообщества» включены), иначе клиенты не смогут написать.

Безопасность и надёжность

  • Токен сообщества хранится в зашифрованном виде.
  • Секрет Callback проверяется на каждом событии — чужие запросы отклоняются.
  • Повторные события от ВКонтакте не запускают агента дважды.
  • Частота сообщений ограничена, чтобы защитить бюджет от флуда.

Частые вопросы

Подтверждение сервера во ВКонтакте не проходит.

Проверьте, что адрес сервера скопирован полностью и строка подтверждения вставлена в агента без лишних пробелов. Нажмите «Подключить» в агенте до «Подтвердить» во ВКонтакте и проверьте, что секретный ключ в обоих местах одинаковый.

Агент не отвечает на сообщения.

Убедитесь, что в Типах событий включены «Входящие сообщения», а у токена есть право на сообщения сообщества.