Вся справка

VK

Уведомления вам, виджет записи и своё сообщество ВКонтакте.

1

Уведомления вам

Откройте Интеграции → VK. Блок «Уведомления»: сообщество ЗапишиМеня должно получить от вас разрешение писать — нажмите «Открыть сообщество» и отправьте ему одним сообщением только 4-значный код из карточки (без лишних слов; код действует 5 минут, страница обновится сама). Так подключаются уведомления о записях. Подробнее про код — Как подключить Telegram, MAX и VK.

Карточка VK в «Интеграциях»: «Уведомления» с кодом, «Виджет записи», «Своё сообщество»
2

Виджет записи

Блок «Виджет записи» — запись прямо внутри вашего сообщества ВКонтакте. Укажите ID сообщества и нажмите «Сохранить», затем добавьте мини-приложение в сообщество. Внешний вид, что видит клиент и как отключить — Виджет ВК. Доступно на всех тарифах.

3

Своё сообщество: ключ доступа

Блок «Своё сообщество» (со «Стандарта») — клиентские уведомления придут от имени вашего сообщества. Откройте сообщество, которым управляете, и в левом меню настроек выберите «Работа с API» (только с компьютера — в мобильной версии ВК такого раздела нет).

Меню настроек сообщества VK — пункт «Работа с API»

На вкладке «Ключи доступа» нажмите «Создать ключ».

Список ключей доступа VK

Отметьте право «Разрешить приложению доступ к сообщениям сообщества» и нажмите «Создать».

Создание ключа доступа VK с правом на сообщения сообщества

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

4

Callback API: адрес и секретный ключ

После подключения карточка покажет «URL сервера» и «Секретный ключ» — перенесите их в настройки сообщества, в «Работа с API» → вкладка «Callback API»:

Настройки сервера Callback API VK с размеченными полями Адрес, Секретный ключ, Сохранить, Типы событий, Строка сервера

Поле «Адрес» — «URL сервера» из нашей карточки, «Секретный ключ» — оттуда же, дальше «Сохранить». На вкладке «Типы событий» включите «Входящее сообщение», «Разрешение на получение», «Запрет на получение».

Типы событий Callback API VK — отмеченные чекбоксы
5

Строка подтверждения

Вернитесь на «Настройки сервера», скопируйте «Строку, которую должен вернуть сервер» и вставьте её в поле «Строка, которую выдал VK» в нашей карточке — «Сохранить код».

Поле для строки, которую выдал VK, и кнопка Сохранить код

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

Кнопка Подтвердить в настройках сервера Callback API VK
Официальная инструкция VK Callback API
6

Проверьте и выберите «своё»

Индикаторы «Ключ принят», «Callback API подтверждён», «Тестовое сообщение». Для теста откройте сообщество и отправьте ему код из 4 цифр, затем «Отправить тестовое уведомление». После этого в Настройки → Уведомления выберите «своё» для нужных событий — Свои боты: общий или свой.

ВК не позволяет сообществу написать первым: клиент должен сам разрешить сообщения — для виджета запрос появляется в момент записи.