Перейти к содержимому
PHP

Бот ВКонтакте на PHP: архитектура Callback API и безопасный старт

Как устроен бот сообщества ВКонтакте на PHP: Callback API, токен сообщества, подтверждение сервера, обработка событий и безопасное хранение секретов.

Старые инструкции по ботам ВКонтакте часто предлагают создавать Standalone-приложение и вручную получать токены через устаревшие экраны. Интерфейс и способы авторизации со временем меняются, поэтому надёжнее строить интеграцию вокруг актуальных настроек сообщества и Callback API, сверяя конкретные пункты с документацией VK.

Как устроен бот

  1. ВКонтакте отправляет событие на HTTPS-адрес вашего обработчика.
  2. PHP-скрипт проверяет источник и тип события.
  3. Для нужных событий выполняется логика бота.
  4. Ответ пользователю отправляется через API от имени сообщества.

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

  • сообщество ВКонтакте;
  • сервер с публичным HTTPS;
  • PHP;
  • секрет Callback API;
  • токен с минимально необходимыми правами.

Архивные экраны старой настройки

Ниже оставлены скриншоты из первоначальной версии статьи. Они полезны как исторический контекст, но названия разделов и порядок получения токенов могли измениться, поэтому не ориентируйтесь на них как на точную карту современного интерфейса.

Архивный экран настройки приложения VK
Архивный экран параметров приложения VK

Минимальный обработчик Callback API

<?php
$payload = json_decode(file_get_contents('php://input'), true);

if (!is_array($payload)) {
    http_response_code(400);
    exit;
}

if (($payload['type'] ?? '') === 'confirmation') {
    echo getenv('VK_CONFIRMATION_CODE');
    exit;
}

if (($payload['secret'] ?? '') !== getenv('VK_CALLBACK_SECRET')) {
    http_response_code(403);
    exit;
}

// Здесь обрабатываются разрешённые типы событий.
echo 'ok';

Confirmation code, secret и токены не храните прямо в репозитории. Передавайте их через переменные окружения или менеджер секретов.

Подключение URL в сообществе

В настройках API сообщества указывается публичный HTTPS-адрес обработчика и выбираются события, которые действительно нужны боту. Старый скриншот ниже показывает общую идею такого подключения.

Архивный экран подключения Callback API к сообществу VK

Что важно для production

  • использовать HTTPS;
  • проверять секрет входящих событий;
  • не логировать токены;
  • давать токену только необходимые права;
  • ограничивать типы обрабатываемых событий;
  • обрабатывать повторную доставку событий идемпотентно;
  • вести журнал ошибок без персональных данных и секретов.

Конкретные названия настроек и методы API могут меняться. Перед запуском сверяйте их с текущей документацией VK, а старый код из архивных инструкций используйте только как пример общей архитектуры.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *