Callback API ВКонтакте
Как ВКонтакте сообщает Sender о сообщениях и подписках, как Sender настраивает это сам и что делать, если события не приходят.
Что приходит через Callback API
- новые сообщения и нажатия кнопок;
- прочтения сообщений и реакции на них;
- разрешение и запрет сообщений от сообщества;
- вступления в сообщество и выходы из него;
- новые записи, комментарии, лайки и репосты, голоса в опросах;
- блокировка в сообществе и разблокировка;
- подписки VK Donut и заказы в товарах.
На этих событиях работают боты, триггеры, диалоги и аналитика.
Всё настраивается само
- При подключении сообщества Sender сам создаёт в нём сервер Callback API с названием «Sender» и включает нужные события.
- Раз в час Sender проверяет сервер. Если что-то сбилось — например, сменились адрес или секрет, — он настраивает его заново.
- Лишние серверы «Sender», оставшиеся от прежних настроек, Sender удаляет сам. Серверы других сервисов не трогает.
Как проверить
- Откройте Управление → Каналы.
- Нажмите плашку «Callback API» над карточкой текущего канала.
- Посмотрите статус: «Настроен» — всё в порядке, «Не настроен» — события не приходят.
| Что видно | Что значит |
|---|---|
| «Настроен» | ВКонтакте подтвердил сервер Sender, события приходят |
| «Не настроен» | Сервер не создан или не подтверждён. Под статусом — причина |
| «Последнее событие» | Когда ВКонтакте последний раз что-то присылал. «ещё не было» — событий пока не было |
| «URL», «Секрет», «Код подтверждения» | Служебные данные сервера. Вручную их вводить не нужно — Sender всё делает сам |
На свёрнутой карточке канала то же видно коротко: «Работает» или «События не приходят».
Настроить заново
Нажмите «Настроить Callback API». Кнопка покажет «Настройка…», а затем появится сообщение «Callback API настроен». Нажимать можно сколько угодно раз: Sender только обновит свой сервер.
Если события не приходят
- Нажмите «Настроить Callback API» — чаще всего этого достаточно.
- Проверьте плашку «Ключи доступа». Ключ «Не действует» или у него нет права на управление сообществом — добавьте новый ключ (как) или переподключите сообщество через приложение.
- Видите «Достигнут лимит серверов Callback API. Удалите лишние серверы.» — у сообщества уже 10 серверов, больше ВКонтакте не разрешает. Во ВКонтакте откройте «Управление» → «Работа с API» → «Callback API», удалите серверы сервисов, которыми больше не пользуетесь, и снова нажмите «Настроить Callback API».
- Проверьте результат: напишите сообществу сами и нажмите «Обновить данные» в шапке кабинета. Время «Последнее событие» должно обновиться.
Если события перестали приходить, Sender пришлёт уведомление «Канал не получает события» — не чаще раза в 6 часов. Как включить уведомления — Уведомления о событиях.
Частые вопросы
«Последнее событие: ещё не было» — это ошибка?
Нет, если сообщество только что подключили и ему ещё никто не писал. Напишите сообществу сами — событие появится.
В сообществе уже работает другой сервис. Sender ему помешает?
Нет. Sender создаёт свой сервер и не трогает серверы других сервисов.
Есть ли Callback API у Telegram и МАКС?
Там то же самое называется вебхуком, и Sender тоже настраивает его сам. Состояние — в карточке бота, строки «Вебхук» или «События». Подробнее — Настройки канала.