Перейти к содержанию
30 минут чтения
Тема: Практика GitHub · Webhook · BotGate SDK · PHP

Как получать уведомления из GitHub в Telegram через BotGate

Для примера подключим один GitHub-репозиторий к рабочему чату Telegram. Команда увидит pull request, который пора проверить, результат CI на main и итог выкладки. Webhook проверит подпись и сохранит уведомление в SQLite; отдельный процесс отправит его через BotGate. Соберём связанные файлы, разберём повторные доставки и покажем, где искать причину пропавшего сообщения.

Какие события действительно нужны команде

Начнём с правил, а не с подписки на все события. В нашем примере PR уведомляет один раз, когда он впервые готов к ревью. Добавление каждого коммита в открытый PR не вызывает сообщение. По CI получаем один итог всего workflow, а не отчёт о каждой матричной задаче. По выкладке выбираем один источник результата.

  • pull_request: opened для обычного PR и ready_for_review для бывшего черновика. Draft, synchronize, edited и повторное возвращение в review пропускаем.

  • workflow_run: только completed; workflow с именем CI, ветка main, запуск от push. Уведомляем и об успехе, и об ошибке. Для проверок PR ниже показано, как изменить фильтр.

  • Выкладка: либо completed у workflow Deploy, либо конечный deployment_status окружения production. Настройка DEPLOY_SOURCE переключает вариант; одновременно оба не отправляются.

Поля входящего запроса сверяйте с официальным описанием: Список событий и структура GitHub payload

check_run полезен, если команда ждёт одну конкретную проверку сторонней системы. Для сводки GitHub Actions мы выбрали workflow_run: подписка одновременно на check_run, check_suite и workflow_run обычно превращает один запуск в несколько похожих сообщений. Для другого репозитория правила можно расширить, но сначала сформулируйте, какое действие должен сделать человек после уведомления.

Подготовка бота, репозитория и файлов

Понадобятся PHP 8.3+ с PDO SQLite и mbstring, Composer, HTTPS-адрес обработчика и один сервер с локальным диском. Это небольшой самостоятельный сервис, не часть выполняемого кода из PR. Он не скачивает артефакты и не запускает команды из события. Веб-сервер публикует только public; БД, Composer и конфигурация находятся снаружи.

Структура проекта
github-notify/
  common.php
  init.php
  schema.sql
  events.php
  sender.php
  worker.php
  vendor/
  public/webhook.php
Shell · установка SDK
composer require botgate/sdk

Добавьте бота в BotGate, получите API-ключ аккаунта и публичный ID бота. Это разные значения: BOTGATE_BOT_ID не равен Telegram user ID, а API-ключ не равен токену BotFather. Для рабочего чата добавьте бота и разрешите отправку сообщений. Для личной проверки сначала напишите боту /start. Chat ID задаётся настройкой, а не приходит из GitHub payload.

Первую отправку и получение идентификатора чата подробно разбирает Подключение BotGate SDK

Окружение процесса · значения-примеры
APP_DB=/srv/github-notify/var/events.sqlite
GITHUB_WEBHOOK_SECRET=REPLACE_WITH_RANDOM_SECRET
GITHUB_REPOSITORY_ID=123456789
BOTGATE_API_KEY=REPLACE_WITH_BOTGATE_KEY
BOTGATE_BOT_ID=bot_REPLACE_WITH_PUBLIC_ID
TELEGRAM_CHAT_ID=-1001234567890
DEPLOY_SOURCE=workflow

Это список переменных, а не автоматически загружаемый .env. Передайте их PHP-FPM и процессу worker через защищённую конфигурацию вашего менеджера процессов. Для локального CLI-сеанса используйте export NAME=value. Секрет не храните в репозитории, URL webhook или журнале. Случайную строку можно получить через php -r 'echo bin2hex(random_bytes(32)), PHP_EOL;'. Каталог var создайте заранее; PHP-FPM и worker должны иметь доступ к одному файлу БД и его каталогу.

В репозитории GitHub откройте Settings → Webhooks → Add webhook. Укажите HTTPS URL /webhook.php, тип application/json, случайный Secret и оставьте проверку TLS включённой. Выберите отдельные события Pull requests и Workflow runs. Для DEPLOY_SOURCE=deployment дополнительно выберите Deployment statuses. Нужны права управления webhook репозитория. Токен GitHub этому приёмнику не требуется: он получает события, а не читает приватный API.

Числовой GITHUB_REPOSITORY_ID возьмите из repository.id в тестовой доставке ping в Recent deliveries и задайте до рабочих событий. Такой ID переживает переименование репозитория. Подписанный запрос от другого репозитория, использующего тот же секрет, не должен отправить сообщение в этот чат.

Хранилище: доставка и уведомление — разные записи

В deliveries хранится факт приёма GitHub-запроса. В notifications — подготовленный текст и состояние отправки. Для повторной доставки используем X-GitHub-Delivery. Для повторного бизнес-события есть event_key: новый идентификатор доставки не должен повторно пригласить команду к ревью того же PR.

SQL · schema.sql
CREATE TABLE deliveries (
    delivery_id TEXT PRIMARY KEY,
    event TEXT NOT NULL,
    body_hash TEXT NOT NULL,
    received_at INTEGER NOT NULL
);
CREATE TABLE notifications (
    event_key TEXT PRIMARY KEY,
    text TEXT NOT NULL,
    state TEXT NOT NULL DEFAULT 'pending',
    attempts INTEGER NOT NULL DEFAULT 0,
    available_at INTEGER NOT NULL,
    message_id INTEGER,
    error_kind TEXT,
    created_at INTEGER NOT NULL
);
CREATE INDEX notifications_due ON notifications(state, available_at);
PHP · common.php
<?php
declare(strict_types=1);

function setting(string $name): string
{
    $value = getenv($name);
    if ($value === false || $value === '') {
        throw new RuntimeException('Missing setting: '.$name);
    }
    return $value;
}

function database(): PDO
{
    $path = setting('APP_DB');
    if (!is_file($path)) {
        throw new RuntimeException('Run init.php first');
    }
    $db = new PDO('sqlite:'.$path, options: [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
    $db->exec('PRAGMA foreign_keys=ON; PRAGMA busy_timeout=3000');
    return $db;
}

/** @param list<int|string|null> $params */
function sql(PDO $db, string $query, array $params = []): PDOStatement
{
    $statement = $db->prepare($query);
    $statement->execute($params);
    return $statement;
}

/**
 * @param list<int|string|null> $params
 * @return array<string, int|string|null>|null
 */
function row(PDO $db, string $query, array $params = []): ?array
{
    $value = sql($db, $query, $params)->fetch(PDO::FETCH_ASSOC);
    if ($value === false) {
        return null;
    }
    /** @var array<string, int|string|null> $value */
    return $value;
}

/**
 * @template T
 * @param callable(): T $work
 * @return T
 */
function atomic(PDO $db, callable $work): mixed
{
    $db->exec('BEGIN IMMEDIATE');
    try {
        $result = $work();
        $db->exec('COMMIT');
        return $result;
    } catch (Throwable $e) {
        $db->exec('ROLLBACK');
        throw $e;
    }
}

/** @return array<string, mixed> */
function objectJson(string $raw): array
{
    $value = json_decode($raw, true, 64, JSON_THROW_ON_ERROR);
    if (!is_array($value) || array_is_list($value)) {
        throw new InvalidArgumentException('Expected JSON object');
    }
    $object = [];
    foreach ($value as $key => $item) {
        if (!is_string($key)) {
            throw new InvalidArgumentException('Expected string keys');
        }
        $object[$key] = $item;
    }
    return $object;
}

function finish(int $status): never
{
    http_response_code($status);
    header('Cache-Control: no-store');
    exit;
}

function requestHeader(string $key): string
{
    $value = $_SERVER[$key] ?? '';
    return is_string($value) ? $value : '';
}
PHP · init.php
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
if (PHP_SAPI !== 'cli') { exit(1); }
$path = setting('APP_DB');
if (file_exists($path)) { throw new RuntimeException('Database already exists'); }
$schema = file_get_contents(__DIR__.'/schema.sql');
if ($schema === false) { throw new RuntimeException('Missing schema'); }
$db = new PDO('sqlite:'.$path, options: [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec($schema);
echo "Database created\n";
Shell · создание отдельной БД
php init.php

init.php откажется работать поверх существующего файла. Веб-обработчик не создаёт таблицы при каждом запросе. Операция приёма одной транзакцией сохраняет delivery и уведомление: либо обе записи видны worker, либо нет ни одной. SQLite здесь рассчитана на небольшой поток одного репозитория; для нескольких серверов нужны общая БД и механизм блокировок вместо локального flock.

Фильтры и ссылки на конкретный запуск

events.php содержит чистое преобразование события в сообщение и транзакцию сохранения. Название PR ограничиваем по длине; не включаем его описание, diff или логи сборки. Сообщение отправляется без parse_mode, поэтому символы HTML из заголовка не становятся разметкой. Ссылки на PR и запуск собираем из проверенных идентификаторов репозитория и события.

PHP · events.php
<?php
declare(strict_types=1);

/** @return array<string, mixed> */
function obj(mixed $value): array
{
    if (!is_array($value)) { return []; }
    $object = [];
    foreach ($value as $key => $item) {
        if (!is_string($key)) { return []; }
        $object[$key] = $item;
    }
    return $object;
}

function shortText(mixed $value, int $limit = 180): string
{
    if (!is_string($value)) { return ''; }
    $value = preg_replace('/[\p{C}\s]+/u', ' ', $value) ?? '';
    return mb_substr(trim($value), 0, $limit);
}

function positiveId(mixed $value): ?int
{
    return is_int($value) && $value > 0 ? $value : null;
}

function githubSignatureValid(string $body, string $signature, string $secret): bool
{
    return preg_match('/^sha256=[a-f0-9]{64}$/D', $signature) === 1
        && hash_equals('sha256='.hash_hmac('sha256', $body, $secret), $signature);
}

/**
 * @param array<string, mixed> $payload
 * @return array{key:string,text:string}|null
 */
function notification(string $event, array $payload): ?array
{
    $repo = obj($payload['repository'] ?? null);
    $repoId = positiveId($repo['id'] ?? null);
    $fullName = $repo['full_name'] ?? null;
    if ((string) $repoId !== setting('GITHUB_REPOSITORY_ID')
        || !is_string($fullName)
        || preg_match('~^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$~D', $fullName) !== 1) {
        return null;
    }
    $base = 'https://github.com/'.$fullName;
    $action = $payload['action'] ?? null;
    if ($event === 'pull_request') {
        $pr = obj($payload['pull_request'] ?? null);
        $number = positiveId($pr['number'] ?? null);
        if (!in_array($action, ['opened', 'ready_for_review'], true)
            || ($pr['draft'] ?? true) !== false || $number === null) {
            return null;
        }
        // Один запрос на ревью за жизнь PR, даже при повторном ready_for_review.
        return ['key' => "$repoId:pr:$number:review", 'text' =>
            "$fullName: PR #$number готов к ревью\n".
            shortText($pr['title'] ?? null)."\n$base/pull/$number"];
    }
    if ($event === 'workflow_run' && $action === 'completed') {
        $run = obj($payload['workflow_run'] ?? null);
        $id = positiveId($run['id'] ?? null);
        $attempt = positiveId($run['run_attempt'] ?? null);
        $name = $run['name'] ?? null;
        $result = $run['conclusion'] ?? null;
        $isDeploy = $name === 'Deploy' && setting('DEPLOY_SOURCE') === 'workflow';
        if ($id === null || $attempt === null
            || ($name !== 'CI' && !$isDeploy)
            || ($run['head_branch'] ?? null) !== 'main'
            || ($run['event'] ?? null) !== 'push'
            || !in_array($result, ['success', 'failure', 'timed_out', 'cancelled', 'action_required', 'startup_failure', 'stale'], true)) {
            return null;
        }
        return ['key' => "$repoId:run:$id:$attempt", 'text' =>
            "$fullName: $name — $result (попытка $attempt)\n".
            "$base/actions/runs/$id/attempts/$attempt"];
    }
    if ($event === 'deployment_status' && setting('DEPLOY_SOURCE') === 'deployment') {
        $deployment = obj($payload['deployment'] ?? null);
        $status = obj($payload['deployment_status'] ?? null);
        $id = positiveId($deployment['id'] ?? null);
        $statusId = positiveId($status['id'] ?? null);
        $state = $status['state'] ?? null;
        if ($id === null || $statusId === null
            || ($deployment['environment'] ?? null) !== 'production'
            || !in_array($state, ['success', 'failure', 'error'], true)) {
            return null;
        }
        // Ссылка только на запуск в том же репозитории, не произвольный log_url.
        $url = $status['log_url'] ?? null;
        $runPattern = '~^'.preg_quote($base, '~').'/actions/runs/[0-9]+(?:/attempts/[0-9]+)?$~D';
        $url = is_string($url) && preg_match($runPattern, $url) === 1
            ? $url : $base.'/deployments';
        return ['key' => "$repoId:deployment:$id:$state", 'text' =>
            "$fullName: production — $state\nDeployment #$id, status #$statusId\n$url"];
    }
    return null;
}

/** @param array<string, mixed> $payload */
function acceptDelivery(PDO $db, string $id, string $event, string $body, array $payload): void
{
    atomic($db, function () use ($db, $id, $event, $body, $payload): void {
        $hash = hash('sha256', $body);
        $old = row($db, 'SELECT * FROM deliveries WHERE delivery_id=?', [$id]);
        if ($old !== null) {
            if ($old['body_hash'] !== $hash || $old['event'] !== $event) {
                throw new DomainException('Delivery ID collision');
            }
            return;
        }
        $item = notification($event, $payload);
        sql($db, 'INSERT INTO deliveries VALUES (?, ?, ?, ?)', [$id, $event, $hash, time()]);
        if ($item !== null) {
            sql($db, 'INSERT INTO notifications(event_key,text,available_at,created_at)
                VALUES (?,?,?,?) ON CONFLICT(event_key) DO NOTHING',
                [$item['key'], $item['text'], time(), time()]);
        }
    });
}

run_attempt входит в ключ и ссылку: перезапуск того же workflow имеет право прислать новый результат. В варианте deployment ключ объединяет deployment ID и конечное состояние. Повторный success того же deployment пропускается, а переход failure → success виден. Если ваша система переиспользует один deployment ID для нескольких независимых выкладок, выдавайте новый deployment ID либо включите собственный номер попытки в ключ.

Для CI по pull request замените проверку event=push на разрешённый список [push, pull_request], а фильтр head_branch=main применяйте только к push. Иначе PR из feature-ветки закономерно исчезнут. Для режима «только проблемы» добавьте условие conclusion !== success. Если нужны также сообщения о восстановлении после ошибки, храните предыдущий результат по workflow и ветке: просто убрать success из фильтра недостаточно.

Workflow Deploy должен завершаться после выкладки и проверки работоспособности приложения. Если он только ставит задачу внешнему сервису, зелёный workflow сообщает об успешной постановке, а не о готовности production. В таком процессе используйте deployment_status от системы, которая знает итог. log_url должен указывать на запуск Actions; если такой ссылки нет, пример ведёт в историю deployments.

Правила окружений и согласований описаны отдельно: Окружения и выкладки в GitHub Actions

Webhook: проверяем исходное тело и сохраняем событие

Подпись вычисляется по исходным байтам запроса, до json_decode. Повторная сериализация меняет пробелы или порядок полей и ломает проверку. Secret нужен именно от этого GitHub webhook. Подпись BotGate и Telegram secret_token к этому endpoint отношения не имеют.

PHP · public/webhook.php
<?php
declare(strict_types=1);
require dirname(__DIR__).'/common.php';
require dirname(__DIR__).'/events.php';

if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') { finish(405); }
if (!str_starts_with(requestHeader('CONTENT_TYPE'), 'application/json')) { finish(415); }
$body = file_get_contents('php://input', length: 1048577);
if ($body === false || strlen($body) > 1048576) { finish(413); }
if (!githubSignatureValid($body, requestHeader('HTTP_X_HUB_SIGNATURE_256'), setting('GITHUB_WEBHOOK_SECRET'))) {
    finish(403);
}
$id = requestHeader('HTTP_X_GITHUB_DELIVERY');
$event = requestHeader('HTTP_X_GITHUB_EVENT');
if (preg_match('/^[a-zA-Z0-9-]{1,100}$/D', $id) !== 1
    || !in_array($event, ['ping', 'pull_request', 'workflow_run', 'deployment_status'], true)) {
    finish(400);
}
try {
    $payload = objectJson($body);
} catch (JsonException|InvalidArgumentException) {
    finish(400);
}
try {
    acceptDelivery(database(), $id, $event, $body, $payload);
} catch (DomainException) {
    finish(409);
} catch (Throwable) {
    error_log('GitHub webhook: save failed');
    finish(503);
}
finish(202);

Алгоритм и заголовок: Проверка подписи GitHub

202 возвращается после COMMIT. При недоступной БД возвращается 503; при неправильной подписи — 403. ping и отфильтрованные события сохраняют delivery, но не создают уведомление. Это нормально: успешная доставка webhook не означает, что для неё обязательно отправляется сообщение.

В примере свой предел тела — 1 МиБ. Он меньше максимума GitHub; слишком большой запрос получит 413 и потребует разбора. Не повышайте его без контроля памяти и размера запроса на веб-сервере. Заголовки event и delivery не входят в HMAC тела, поэтому дополнительно проверяются структура события, repository.id и бизнес-ключ. Перехваченный корректный webhook нельзя считать новым действием только из-за нового заголовка доставки.

Быстрый ответ, HTTPS и повторные доставки: Рекомендации GitHub по webhook

Отправка через BotGate и определённые ошибки

sender.php делает ровно одну попытку HTTP-запроса. Он различает подтверждённый отказ, лимит и неизвестный результат. Для Telegram 429 используется retry_after из TelegramException; для лимита самого BotGate — RateLimitException. В остальных случаях автоматический повтор может оказаться небезопасным.

PHP · sender.php
<?php
declare(strict_types=1);
use BotGate\BotClient;
use BotGate\Exception\BotGateException;
use BotGate\Exception\RateLimitException;
use BotGate\Exception\TelegramException;

/** @return array{state:string,message_id:?int,delay:int,error:?string} */
function sendNotification(BotClient $bot, string $text, int $attempt): array
{
    $result = ['state' => 'unknown', 'message_id' => null, 'delay' => 0, 'error' => null];
    try {
        $answer = $bot->call('sendMessage', [
            'chat_id' => setting('TELEGRAM_CHAT_ID'),
            'text' => $text,
            'link_preview_options' => ['is_disabled' => true],
        ]);
        if (is_array($answer->result) && is_int($answer->result['message_id'] ?? null)) {
            $result['state'] = 'sent';
            $result['message_id'] = $answer->result['message_id'];
        } else {
            $result['error'] = 'unexpected_response';
        }
    } catch (TelegramException $e) {
        $code = $e->telegramErrorCode();
        $result['error'] = 'telegram_'.($code ?? 0);
        $result['state'] = $code !== null && $code < 500 ? 'failed' : 'unknown';
        if ($code === 429 && $attempt < 4) {
            $result['state'] = 'pending';
            $result['delay'] = max(1, $e->retryAfter() ?? 60) + 1;
        }
    } catch (RateLimitException $e) {
        $result['state'] = $attempt < 4 ? 'pending' : 'failed';
        $result['delay'] = max(1, $e->retryAfter() ?? 60) + 1;
        $result['error'] = 'botgate_limit';
    } catch (BotGateException $e) {
        $result['error'] = 'botgate_or_transport';
        $result['state'] = in_array($e->httpStatusCode(), [401, 403, 404], true) ? 'failed' : 'unknown';
    } catch (Throwable) {
        $result['error'] = 'unexpected_failure';
    }
    return $result;
}

Лимит повторяем максимум до четырёх попыток, с указанной задержкой. Ошибки прав или неверного chat_id сохраняются как failed: их надо исправить, а не повторять каждую секунду. Сетевой обрыв, 5xx и неожиданный ответ дают unknown. В журнал пишется категория ошибки без API-ключа, тела webhook и текста приватного PR.

Различия лимитов подробнее: Ограничения и retry_after

PHP · worker.php
<?php
declare(strict_types=1);
require __DIR__.'/vendor/autoload.php';
require __DIR__.'/common.php';
require __DIR__.'/sender.php';
if (PHP_SAPI !== 'cli') { exit(1); }
$lock = fopen(setting('APP_DB').'.worker.lock', 'c');
if ($lock === false || !flock($lock, LOCK_EX | LOCK_NB)) { exit(0); }
$db = database();
$bot = BotGate\Client::fromConfig(new BotGate\Config(
    apiKey: setting('BOTGATE_API_KEY'), timeout: 8, maxRetries: 0,
))->bot(setting('BOTGATE_BOT_ID'));
for ($i = 0; $i < 20; $i++) {
    $item = atomic($db, function () use ($db): ?array {
        $next = row($db, "SELECT * FROM notifications WHERE state='pending'
            AND available_at<=? ORDER BY created_at,event_key LIMIT 1", [time()]);
        if ($next !== null) {
            sql($db, "UPDATE notifications SET state='sending',attempts=attempts+1 WHERE event_key=?", [$next['event_key']]);
        }
        return $next;
    });
    if ($item === null) { break; }
    $result = sendNotification($bot, (string) $item['text'], (int) $item['attempts'] + 1);
    sql($db, 'UPDATE notifications SET state=?,message_id=?,available_at=?,error_kind=? WHERE event_key=?', [
        $result['state'], $result['message_id'], time() + $result['delay'], $result['error'], $item['event_key'],
    ]);
    // Не устраиваем всплеск отправок в один рабочий чат.
    if ($result['state'] !== 'sent') { break; }
    usleep(3500000);
}

maxRetries: 0 отключает автоматические повторы SDK: решения о повторе принимает этот worker. flock допускает один процесс отправки для этой БД на одном сервере. Перед сетевым запросом состояние становится sending, после ответа — sent, pending, failed или unknown. Пауза между успешными отправками снижает нагрузку на один групповой чат; она не заменяет обработку 429.

Shell · обработка накопленных уведомлений
php worker.php

Для небольшой команды запускайте worker.php раз в минуту планировщиком или менеджером процессов с теми же переменными окружения. Один проход обрабатывает до 20 записей; параллельный запуск завершится благодаря flock. Контролируйте возраст самой старой pending-записи: если минутной частоты недостаточно, переходите на постоянный worker и общую очередь, сохранив те же состояния.

Что делать после сбоя и повторной доставки

GitHub не повторяет неуспешные доставки автоматически. После восстановления обработчика откройте Recent deliveries и вручную повторите неуспешную доставку; для большого потока добавьте отдельный контролируемый процесс redelivery через GitHub API. Если событие уже сохранено, повтор не создаст второе уведомление.

Порядок повторной доставки описан у GitHub: Восстановление неуспешных доставок

SQL · диагностика локальной очереди
SELECT state, COUNT(*) FROM notifications GROUP BY state;
SELECT event_key, state, attempts, error_kind, created_at
FROM notifications WHERE state IN ('sending','unknown','failed')
ORDER BY created_at;
SELECT MIN(created_at) AS oldest_pending
FROM notifications WHERE state='pending';

sending после остановки worker — тоже неизвестный результат: процесс мог погибнуть между отправкой и записью message_id. Нельзя безусловно переводить все такие записи в pending. Сначала проверьте рабочий чат и журнал запросов BotGate. Если сообщение найдено, зафиксируйте его message_id и sent; если принято решение отправить заново, меняйте только конкретный event_key и учитывайте риск дубля.

Не удаляйте историю ключей раньше выбранного горизонта повторов. Для крупного сервиса можно удалить текст старых sent-уведомлений, сохранив ключ, состояние и дату. Удаление всей строки снова разрешит отправку старого события. База содержит названия приватных PR: доступ к её резервным копиям должен соответствовать доступу к репозиторию.

Окно сбоя между API и БД подробнее объясняет статья Почему бот отправляет дубли

Проверка перед подключением рабочего чата

  • Начните с личного тестового чата и отдельного репозитория. ping получает 202, но сообщения не создаёт.

  • Откройте обычный PR: появится одна pending-запись и после worker — одно сообщение со ссылкой. Draft не уведомляет; ready_for_review уведомляет один раз.

  • Нажмите Redeliver в GitHub: число notifications не меняется. Измените тело сохранённого тестового запроса, оставив старую подпись: ожидается 403.

  • Завершите CI на main, затем повторите запуск: в ссылках различаются attempts/1 и attempts/2. Workflow с другим именем и промежуточное событие requested пропускаются.

  • Проверьте Deploy или deployment_status, в зависимости от выбранного режима. Зелёный результат должен соответствовать завершённой проверке приложения.

  • Остановите worker, отправьте событие и убедитесь, что запись остаётся pending. Верните worker — уведомление уйдёт. При недоступной БД webhook должен отвечать 503, а не 202.

  • На тестовом транспорте проверьте 429, 403 и таймаут. Только подтверждённый лимит возвращается в pending; таймаут остаётся unknown.

Для приватного репозитория используйте чат с тем же кругом доступа. Наличие ссылки не даёт права читать GitHub, но название PR уже может раскрыть внутреннюю информацию. Не добавляйте токены, содержимое Secrets, полный payload или логи CI в Telegram.

BotGate в этой схеме отвечает за вызовы Telegram API. Проверка GitHub-подписи, правила уведомлений и очередь остаются в вашем приложении. Поэтому смена транспорта не исправит неправильный фильтр и не превратит неуспешную выкладку в успешную.

Настройка API и диагностика запросов: Документация BotGate