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

Пока закрыто пометкой «Скоро» — рассказываем, как это будет работать.

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

Скоро

Адрес для приёма сообщений мы ещё настраиваем на своей стороне — подключить сообщество пока не получится, форма в агенте неактивна. Не заводите ключ и Callback API заранее: настройки во ВКонтакте нужно будет делать одновременно с подключением здесь. Telegram и виджет на сайт работают уже сейчас.

Как это будет работать

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

Что доступно вместо этого прямо сейчас: Telegram, виджет на сайт и WhatsApp через Wazzup.

Шаг 1. Ключ и Callback API во ВКонтакте

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

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

Шаг 2. Подключите сообщество в агенте

  1. Откройте агента → секция «Запуск 24/7 — ВКонтакте».
  2. Скопируйте оттуда адрес сервера и вставьте его в Callback API ВКонтакте (шаг 1).
  3. Заполните поля: ID сообщества, Токен сообщества, Строка подтверждения и, по желанию, Секрет Callback (рекомендуем — повышает безопасность).
  4. Сохраните. В ВКонтакте подтвердите сервер — статус станет зелёным.
  5. Напишите сообществу в личные сообщения — агент ответит.

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

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

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

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

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

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

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