Перейти к содержанию
27 минут чтения
Тема: Практика Telegram Bot API · Магазин · Остатки · PHP

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

Для примера возьмём магазин чая: пачка 250 г закончилась, покупатель нажимает «Сообщить о поступлении» в личном чате. При следующем появлении доступного остатка бот отправляет ссылку на товар. Соберём небольшой пример на PHP и SQLite: от кнопки подписки до фоновой отправки, отмены и проверки повторных событий.

Определяем, какое событие ждёт покупатель

Подписка относится к конкретному товарному варианту: размеру, цвету или фасовке. Если на складе появился чай в пачке 100 г, подписчику на 250 г это не помогает. В примере product_id обозначает именно продаваемый вариант; для нескольких складов выберите общий доступный остаток или включите склад в ключ подписки.

Доступный остаток — количество, которое сейчас можно заказать с учётом резервов и правил продажи. Источник этой величины — ваша учётная система. Сам бот не пересчитывает склад по сообщениям пользователей. Событием поступления считаем переход от нуля к положительному значению. Изменение 3 → 8 не запускает новую рассылку.

  • Одна активная подписка на пользователя и вариант. Повторное нажатие не создаёт второй записи.

  • После подтверждённой отправки подписка завершается. Следующее поступление потребует нового согласия пользователя.

  • Отмена выключает подписку и ещё не отправленные задания её текущей версии.

  • Сообщение о наличии не резервирует товар. При оформлении заказа магазин снова проверяет цену и остаток.

Сначала пользователь должен открыть личный чат с ботом. В этом примере согласие выражается отдельной кнопкой, а товар показывается по заранее настроенному адресу магазина. Случайный посетитель сайта без диалога с ботом ещё не является получателем Telegram-уведомлений.

Как сделать корзину и проверить остаток при оформлении

Подготавливаем отдельного бота и файлы

Понадобятся PHP 8.3+ с curl и pdo_sqlite, отдельный тестовый бот и HTTPS-адрес для webhook. Для небольшого воспроизводимого примера используем SQLite: изменения состояния выполняются короткими транзакциями. Для большого магазина перенесите ту же модель в его БД и штатную очередь; тысячи подписчиков не стоит планировать одной длинной SQLite-транзакцией.

Text · структура проекта
stock-demo/
  common.php
  stock.php
  schema.sql
  init.php
  setup-webhook.php
  card.php
  update-stock.php
  worker.php
  private/
  public/webhook.php

Корнем сайта назначьте только public. БД, токены и служебные скрипты остаются вне публичного каталога. Пример рассчитан на одного бота в одной БД; в общей системе добавьте bot_id к ключам пользователей, событий и доставок. Создайте private и дайте пользователю PHP право записи в него.

Bash · окружение тестового приложения
export BOT_TOKEN='TOKEN_ОТ_BOTFATHER'
export WEBHOOK_SECRET='СЛУЧАЙНЫЙ_СЕКРЕТ_ИЗ_ЛАТИНИЦЫ_ЦИФР_И_ПОДЧЕРКИВАНИЙ'
export BOT_DB_PATH='/srv/stock-demo/private/stock.sqlite'
export WEBHOOK_URL='https://stock.example.com/webhook.php'
export TELEGRAM_TEST_ENV=0

Замените пути и адреса. Это переменные окружения процесса: обычный PHP сам не загружает файл .env. Те же значения должны быть доступны PHP-FPM и cron, а не только вашему терминалу. Например, задайте env[BOT_DB_PATH], env[BOT_TOKEN] и env[WEBHOOK_SECRET] в конфигурации отдельного FPM-пула. Секрет можно сгенерировать через random_bytes и сохранить в закрытой конфигурации.

common.php содержит соединение, транзакцию, HTTP-вызов Telegram и проверку прямого webhook. Сетевой результат разделяется на подтверждённый успех, явный отказ и неизвестный исход. Автоматических повторов внутри HTTP-функции нет.

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

function database(): PDO
{
    $path = getenv('BOT_DB_PATH');
    if (!$path || !is_file($path)) throw new RuntimeException('Создайте БД и задайте BOT_DB_PATH');
    $db = new PDO('sqlite:'.$path, null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
    $db->exec('PRAGMA foreign_keys = ON');
    $db->exec('PRAGMA busy_timeout = 1000');
    return $db;
}

/** @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 $error) {
        $db->exec('ROLLBACK');
        throw $error;
    }
}

/** @return array<string, int|string|null>|false */
function row(PDOStatement $query): array|false
{
    $value = $query->fetch(PDO::FETCH_ASSOC);
    if ($value === false) return false;
    if (!is_array($value)) throw new RuntimeException('Некорректная строка БД');
    foreach ($value as $key => $field) {
        if (!is_string($key) || !(is_int($field) || is_string($field) || $field === null)) {
            throw new RuntimeException('Некорректное поле БД');
        }
    }
    return $value;
}

/** @param array<string, mixed> $params
 * @return array{state: string, result?: mixed, code?: int, retry_after?: int}
 */
function telegram(string $method, array $params, int $timeout = 8): array
{
    $token = getenv('BOT_TOKEN');
    if (!$token) throw new RuntimeException('Задайте BOT_TOKEN');
    $prefix = getenv('TELEGRAM_TEST_ENV') === '1' ? '/test/' : '/';
    $curl = curl_init('https://api.telegram.org/bot'.$token.$prefix.$method);
    curl_setopt_array($curl, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 2, CURLOPT_TIMEOUT => $timeout,
        CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode($params, JSON_THROW_ON_ERROR)]);
    $raw = curl_exec($curl);
    $status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    unset($curl);
    $body = is_string($raw) ? json_decode($raw, true) : null;
    if ($status >= 200 && $status < 300 && is_array($body) && ($body['ok'] ?? null) === true) {
        return ['state' => 'ok', 'result' => $body['result'] ?? null];
    }
    if ($status < 500 && is_array($body) && ($body['ok'] ?? null) === false
        && is_int($body['error_code'] ?? null)) {
        $parameters = $body['parameters'] ?? [];
        $wait = is_array($parameters) ? ($parameters['retry_after'] ?? 60) : 60;
        return ['state' => 'rejected', 'code' => $body['error_code'],
            'retry_after' => is_int($wait) ? max(1, $wait) : 60];
    }
    return ['state' => 'unknown'];
}

/** @return array<array-key, mixed> */
function incomingUpdate(): array
{
    $secret = getenv('WEBHOOK_SECRET');
    $provided = $_SERVER['HTTP_X_TELEGRAM_BOT_API_SECRET_TOKEN'] ?? '';
    if ($_SERVER['REQUEST_METHOD'] !== 'POST' || !$secret
        || !is_string($provided) || !hash_equals($secret, $provided)) {
        http_response_code(403);
        exit;
    }
    $raw = file_get_contents('php://input', false, null, 0, 1024 * 1024 + 1);
    if (!is_string($raw) || strlen($raw) > 1024 * 1024) {
        http_response_code(413);
        exit;
    }
    $update = json_decode($raw, true, 64, JSON_THROW_ON_ERROR);
    if (!is_array($update) || !is_int($update['update_id'] ?? null)) {
        throw new InvalidArgumentException('Некорректное событие');
    }
    return $update;
}

Создаём таблицы и сохраняем версии подписки

SQL · schema.sql
CREATE TABLE products (
  id INTEGER PRIMARY KEY, title TEXT NOT NULL, url TEXT NOT NULL,
  available INTEGER NOT NULL DEFAULT 0 CHECK (available >= 0),
  source_version INTEGER NOT NULL DEFAULT 0, episode INTEGER NOT NULL DEFAULT 0
);
CREATE TABLE watches (
  id INTEGER PRIMARY KEY, user_id INTEGER NOT NULL,
  product_id INTEGER NOT NULL REFERENCES products(id),
  generation INTEGER NOT NULL DEFAULT 1, active INTEGER NOT NULL DEFAULT 1,
  UNIQUE (user_id, product_id)
);
CREATE TABLE watch_events (update_id INTEGER PRIMARY KEY);
CREATE TABLE stock_deliveries (
  id INTEGER PRIMARY KEY, watch_id INTEGER NOT NULL REFERENCES watches(id),
  generation INTEGER NOT NULL, episode INTEGER NOT NULL,
  state TEXT NOT NULL DEFAULT 'pending', ready_at INTEGER NOT NULL,
  attempts INTEGER NOT NULL DEFAULT 0, started_at INTEGER, message_id INTEGER,
  UNIQUE (watch_id, generation, episode)
);
CREATE INDEX stock_ready ON stock_deliveries(state, ready_at);
INSERT INTO products (id, title, url) VALUES
  (1, 'Зелёный чай, 250 г', 'https://shop.example.com/products/green-tea');

episode — номер поступления. Он растёт только при переходе 0 → положительный остаток. generation — номер повторной подписки конкретного покупателя. Эти значения решают разные задачи: одно поступление не создаёт два задания, а кнопка отмены старой подписки не выключает новую.

source_version приходит от источника остатков и увеличивается для каждого нового состояния варианта. Не подставляйте сюда время обработки webhook: запоздавшая доставка тогда ошибочно станет «новее». Если ваша система не предоставляет версию, последовательно читайте её актуальный снимок и назначайте номер в одном контролируемом процессе.

PHP · init.php
<?php
declare(strict_types=1);
if (PHP_SAPI !== 'cli') exit(1);
$path = getenv('BOT_DB_PATH');
if (!$path || file_exists($path)) throw new RuntimeException('Нужен путь к новой БД');
$db = new PDO('sqlite:'.$path, null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('PRAGMA foreign_keys = ON');
$db->exec(file_get_contents(__DIR__.'/schema.sql'));
echo "База создана\n";
Bash · создание новой учебной БД
php init.php

Скрипт намеренно отказывается работать с уже существующим файлом. После запуска в БД есть товар 1 с нулевым остатком. Замените демонстрационный URL в schema.sql до создания базы либо обновите строку своим административным инструментом.

Показываем карточку, подписываем и отменяем

Создайте stock.php следующим блоком. Он формирует карточку, создаёт подписку и обрабатывает отмену. Получателя берём из проверенного личного чата. ID из callback_data обозначает товар или подписку, но не заменяет проверку владельца.

PHP · stock.php — карточка и подписки
<?php
declare(strict_types=1);
require_once __DIR__.'/common.php';

/** @return array<string, mixed> */
function watchCard(PDO $db, int $userId, int $productId): array
{
    $q = $db->prepare('SELECT p.*, w.id AS watch_id, w.generation, w.active FROM products p
        LEFT JOIN watches w ON w.product_id = p.id AND w.user_id = ? WHERE p.id = ?');
    $q->execute([$userId, $productId]);
    $row = row($q);
    if (!$row) throw new InvalidArgumentException('Нет товара');
    $button = (int) ($row['active'] ?? 0) === 1
        ? ['text' => 'Отменить подписку', 'callback_data' => 'unwatch:'.$row['watch_id'].':'.$row['generation']]
        : ['text' => 'Сообщить о поступлении', 'callback_data' => 'watch:'.$productId];
    return ['chat_id' => $userId, 'text' => $row['title'],
        'reply_markup' => ['inline_keyboard' => [[$button], [['text' => 'Открыть товар', 'url' => $row['url']]]]]];
}

function subscribe(PDO $db, int $userId, int $productId, int $updateId): string
{
    return atomic($db, function () use ($db, $userId, $productId, $updateId): string {
        $q = $db->prepare('INSERT INTO watch_events VALUES (?) ON CONFLICT DO NOTHING');
        $q->execute([$updateId]);
        if ($q->rowCount() === 0) return 'Это действие уже обработано.';
        $q = $db->prepare('SELECT * FROM products WHERE id = ?');
        $q->execute([$productId]);
        $product = row($q);
        if (!$product) return 'Товар не найден.';
        if ((int) $product['available'] > 0) return 'Товар уже в наличии. Откройте карточку.';
        $db->prepare('INSERT INTO watches (user_id, product_id) VALUES (?, ?)
            ON CONFLICT(user_id, product_id) DO UPDATE
            SET active = 1, generation = generation + 1 WHERE active = 0')
            ->execute([$userId, $productId]);
        return 'Подписка сохранена. Сообщим один раз, когда товар появится.';
    });
}

function unsubscribe(PDO $db, int $userId, int $watchId, int $generation): void
{
    atomic($db, function () use ($db, $userId, $watchId, $generation): void {
        $q = $db->prepare('UPDATE watches SET active = 0
            WHERE id = ? AND user_id = ? AND generation = ?');
        $q->execute([$watchId, $userId, $generation]);
        if ($q->rowCount() === 1) {
            $db->prepare("UPDATE stock_deliveries SET state = 'cancelled'
                WHERE watch_id = ? AND generation = ? AND state = 'pending'")
                ->execute([$watchId, $generation]);
        }
    });
}

watch_events защищает от повтора исходного update после отмены: такая доставка не включит подписку снова. Условие active = 0 повышает generation только при новой подписке после завершения предыдущей. Активная подписка от второго нажатия не меняется.

После нажатия интерфейс должен показывать действующую кнопку отмены. Для списка всех подписок можно выбирать watches по user_id и active = 1 и использовать тот же формат unwatch:id:generation. Пока завершим пример обработчиком одной карточки.

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

try {
    $update = incomingUpdate();
    $db = database();
    $q = $update['callback_query'] ?? null;
    if (is_array($q) && is_int($q['from']['id'] ?? null)
        && ($q['message']['chat']['type'] ?? null) === 'private'
        && ($q['message']['chat']['id'] ?? null) === $q['from']['id']) {
        $text = 'Кнопка устарела.';
        $productId = null;
        $data = $q['data'] ?? '';
        if (is_string($data) && preg_match('/\Awatch:([1-9][0-9]{0,9})\z/', $data, $m)) {
            $productId = (int) $m[1];
            $text = subscribe($db, $q['from']['id'], (int) $m[1], $update['update_id']);
        } elseif (is_string($data) && preg_match('/\Aunwatch:([1-9][0-9]{0,9}):([1-9][0-9]{0,9})\z/', $data, $m)) {
            unsubscribe($db, $q['from']['id'], (int) $m[1], (int) $m[2]);
            $find = $db->prepare('SELECT product_id FROM watches WHERE id = ? AND user_id = ?');
            $find->execute([(int) $m[1], $q['from']['id']]);
            $productId = $find->fetchColumn() ?: null;
            $text = 'Этот запрос отмены обработан. Новые подписки не изменены.';
        }
        telegram('answerCallbackQuery', ['callback_query_id' => $q['id'], 'text' => $text], 3);
        if ($productId !== null) {
            $card = watchCard($db, $q['from']['id'], (int) $productId);
            telegram('editMessageReplyMarkup', ['chat_id' => $q['from']['id'],
                'message_id' => $q['message']['message_id'], 'reply_markup' => $card['reply_markup']], 3);
        }
    }
    http_response_code(200);
} catch (Throwable) {
    http_response_code(503);
}

Вебхук сохраняет действие до ответа 200. Если БД не ответила, возвращается 503. Ошибка редактирования клавиатуры не отменяет сохранённое состояние: устаревшую кнопку всё равно проверяет сервер. Для события из неподходящего чата пример ничего не меняет.

PHP · setup-webhook.php
<?php
declare(strict_types=1);
if (PHP_SAPI !== 'cli') exit(1);
require __DIR__.'/common.php';
$url = getenv('WEBHOOK_URL');
$secret = getenv('WEBHOOK_SECRET');
if (!$url || !str_starts_with($url, 'https://') || !$secret) {
    throw new RuntimeException('Задайте HTTPS URL и WEBHOOK_SECRET');
}
$answer = telegram('setWebhook', ['url' => $url, 'secret_token' => $secret,
    'allowed_updates' => ['message', 'callback_query']]);
if ($answer['state'] !== 'ok' || $answer['result'] !== true) {
    throw new RuntimeException('Webhook не подтверждён; проверьте getWebhookInfo');
}
echo "Webhook установлен\n";
PHP · card.php
<?php
declare(strict_types=1);
if (PHP_SAPI !== 'cli') exit(1);
require __DIR__.'/stock.php';
$user = filter_var($argv[1] ?? '', FILTER_VALIDATE_INT, ['options' => ['min_range' => 1]]);
if ($user === false) throw new InvalidArgumentException('Передайте ID своего тестового чата');
$reply = telegram('sendMessage', watchCard(database(), $user, 1));
echo $reply['state'].PHP_EOL;

Разместите public/webhook.php по заданному HTTPS-адресу и откройте чат тестового бота кнопкой Start. Дальше команды установят webhook и отправят карточку только в указанный тестовый чат. Вместо 123456789 подставьте свой ID из проверенного входящего сообщения.

Bash · подключение и показ карточки
php setup-webhook.php
php card.php 123456789

Настройка и диагностика webhook Telegram

Превращаем изменение остатка в задание

Добавьте в конец stock.php функцию updateStock. Она принимает итоговый доступный остаток, а не приращение. В одной транзакции сохраняются новая версия товара и задания для подписчиков. Повторное или более старое событие ничего не меняет.

PHP · stock.php — обработка остатка
function updateStock(PDO $db, int $productId, int $available, int $sourceVersion): bool
{
    if ($available < 0 || $sourceVersion < 1) throw new InvalidArgumentException('Некорректный остаток');
    return atomic($db, function () use ($db, $productId, $available, $sourceVersion): bool {
        $q = $db->prepare('SELECT * FROM products WHERE id = ?');
        $q->execute([$productId]);
        $old = row($q);
        if (!$old) throw new InvalidArgumentException('Нет товара');
        if ($sourceVersion <= (int) $old['source_version']) return false;
        $restocked = (int) $old['available'] === 0 && $available > 0;
        $episode = (int) $old['episode'] + (int) $restocked;
        $db->prepare('UPDATE products SET available = ?, source_version = ?, episode = ? WHERE id = ?')
            ->execute([$available, $sourceVersion, $episode, $productId]);
        if ($restocked) {
            $db->prepare('INSERT INTO stock_deliveries (watch_id, generation, episode, ready_at)
                SELECT id, generation, ?, ? FROM watches WHERE product_id = ? AND active = 1
                ON CONFLICT DO NOTHING')->execute([$episode, time(), $productId]);
        }
        return true;
    });
}

Для подключения к магазину вызывайте функцию после надёжного получения актуального остатка варианта. Если магазин хранит данные в другой БД, используйте журнал исходящих событий или периодическую сверку снимков: отдельный HTTP-запрос после сохранения товара может потеряться при сбое. Уведомления Telegram не выполняются внутри складской транзакции.

PHP · update-stock.php
<?php
declare(strict_types=1);
if (PHP_SAPI !== 'cli') exit(1);
require __DIR__.'/stock.php';
$amount = filter_var($argv[1] ?? '', FILTER_VALIDATE_INT, ['options' => ['min_range' => 0]]);
$version = filter_var($argv[2] ?? '', FILTER_VALIDATE_INT, ['options' => ['min_range' => 1]]);
if ($amount === false || $version === false) throw new InvalidArgumentException('Нужны остаток и версия');
echo updateStock(database(), 1, $amount, $version) ? "Остаток применён\n" : "Повтор или старая версия\n";

После подписки выполните команды ниже. Первая означает «доступно три пачки, версия 1», вторая — повтор того же события, третья — увеличение уже положительного остатка. В stock_deliveries должна остаться одна строка.

Bash · имитация поступления и повторов
php update-stock.php 3 1
php update-stock.php 3 1
php update-stock.php 8 2

Отправляем уведомление и завершаем подписку

Последний блок stock.php — обработка одного задания. Перед отправкой заново проверяются подписка, её версия, текущее поступление и наличие. Задание со старым episode отменяется: после нового поступления для активной подписки уже создаётся новое.

PHP · stock.php — одна отправка
/** @param callable(string, array<string, mixed>): array{state: string, result?: mixed, code?: int, retry_after?: int} $send */
function notifyOne(PDO $db, callable $send): bool
{
    $job = atomic($db, function () use ($db) {
        $q = $db->prepare("SELECT d.*, w.user_id, w.product_id, w.active,
            w.generation AS current_generation, p.episode AS current_episode, p.available, p.title, p.url
            FROM stock_deliveries d JOIN watches w ON w.id = d.watch_id
            JOIN products p ON p.id = w.product_id
            WHERE d.state = 'pending' AND d.ready_at <= ?
              AND NOT EXISTS (SELECT 1 FROM stock_deliveries x
                WHERE x.watch_id = d.watch_id AND x.generation = d.generation
                  AND x.id <> d.id AND x.state IN ('sending', 'unknown'))
            ORDER BY d.id LIMIT 1");
        $q->execute([time()]);
        $job = row($q);
        if (!$job) return null;
        $valid = (int) $job['active'] === 1 && (int) $job['available'] > 0
            && $job['generation'] === $job['current_generation']
            && $job['episode'] === $job['current_episode'];
        $db->prepare('UPDATE stock_deliveries SET state = ?, attempts = attempts + 1, started_at = ? WHERE id = ?')
            ->execute([$valid ? 'sending' : 'cancelled', time(), $job['id']]);
        return $valid ? $job : [];
    });
    if ($job === null) return false;
    if ($job === []) return true;
    $outcome = $send('sendMessage', [
        'chat_id' => $job['user_id'], 'text' => $job['title'].' снова в наличии. Остаток не зарезервирован.',
        'reply_markup' => ['inline_keyboard' => [[['text' => 'Открыть товар', 'url' => $job['url']]]]],
    ]);
    atomic($db, function () use ($db, $job, $outcome): void {
        $result = $outcome['result'] ?? null;
        $messageId = is_array($result) ? ($result['message_id'] ?? null) : null;
        $sent = $outcome['state'] === 'ok' && is_int($messageId);
        $limited = $outcome['state'] === 'rejected' && ($outcome['code'] ?? null) === 429;
        $state = $sent ? 'sent' : ($outcome['state'] === 'rejected' ? 'failed' : 'unknown');
        if ($limited && (int) $job['attempts'] + 1 < 5) $state = 'pending';
        $db->prepare('UPDATE stock_deliveries SET state = ?, message_id = ?, ready_at = ? WHERE id = ?')
            ->execute([$state, $sent ? $messageId : null, time() + ($outcome['retry_after'] ?? 60), $job['id']]);
        if ($sent || ($outcome['code'] ?? null) === 403) {
            $db->prepare('UPDATE watches SET active = 0 WHERE id = ? AND generation = ?')
                ->execute([$job['watch_id'], $job['generation']]);
        }
    });
    return true;
}

После успешного ответа сохраняется message_id и выключается только соответствующая generation. Если за время запроса пользователь отменил подписку и оформил новую, завершение прежней отправки новую подписку не затронет. У ответа с подтверждённым 429 учитывается retry_after, всего разрешено до пяти попыток.

PHP · worker.php
<?php
declare(strict_types=1);
if (PHP_SAPI !== 'cli') exit(1);
require __DIR__.'/stock.php';
$db = database();
for ($i = 0; $i < 20 && notifyOne($db, 'telegram'); $i++) {
    sleep(1);
}
Bash · ручная проверка worker
php worker.php

Для небольшого магазина запускайте worker раз в минуту отдельным процессом. Пример обрабатывает не более 20 заданий за проход с паузой между ними. Это учебное ограничение скорости; учитывайте остальные отправки этого же бота. Окружение cron должно содержать BOT_TOKEN и BOT_DB_PATH.

Bash · строка crontab на Linux
* * * * * flock -n /srv/stock-demo/private/worker.lock /usr/bin/php /srv/stock-demo/worker.php

Рассылка через очередь Laravel: ограничение скорости и повторы

Разбираем отмену, быстрое исчезновение и потерянный ответ

Если товар закончился до захвата задания, worker отменит отправку, а подписка останется активной до следующего поступления. Если запас исчез после последней проверки, сообщение уже может уйти. Именно поэтому оно сообщает о поступлении и ведёт на карточку, а окончательное наличие проверяется при заказе.

Отмена останавливает pending-задания. Запрос, уже отправленный Telegram, отозвать этой кнопкой нельзя. Интерфейс должен честно сообщать об отмене будущих уведомлений; обещать мгновенно остановить любое сообщение было бы неверно.

При таймауте сохраняется unknown. Если процесс завершился после HTTP-запроса, но до записи ответа, строка останется sending. Оба состояния блокируют новые отправки этой generation до разбора. Иначе очередное поступление могло бы создать второе сообщение, хотя первое уже дошло.

Добавьте наблюдение за sending старше рабочего таймаута, unknown и failed. После проверки журналов оператор решает, завершить подписку или разрешить повтор с пониманием возможного дубля. Не сбрасывайте эти состояния автоматически в pending. Отказ 403 выключает подписку; при новом обращении пользователь сможет подписаться снова.

Почему Telegram-бот отправляет дубли и как учитывать неизвестный результат

Проверяем сценарий перед подключением склада

  • Дважды нажмите «Сообщить о поступлении»: в watches одна активная строка с той же generation.

  • Примените 0 → 3 → 8 и повтор одной source_version: одно задание и одно сообщение после worker.

  • Отмените подписку до worker: уведомления нет. Затем подпишитесь снова и нажмите старую кнопку отмены: новая подписка остаётся активной.

  • Измените остаток обратно на ноль до worker: сообщение не отправляется; новое поступление снова планирует уведомление.

  • Подмените отправку фиктивным результатом unknown: следующие поступления не запускают отправку этой версии подписки до разбора.

  • После успешного уведомления проведите ещё одно поступление: без нового согласия покупателя сообщения нет.

Для проверки без Telegram вызовите notifyOne($db, fn () => ['state' => 'ok', 'result' => ['message_id' => 10]]) на отдельной тестовой БД. Такой ответ проверяет бизнес-логику завершения, но не сетевую доставку. Отдельно пройдите реальный сценарий своим тестовым ботом.

Подключаем BotGate и сохраняем правила магазина

Когда сервер магазина не может стабильно обращаться к Telegram, исходящие sendMessage, answerCallbackQuery и editMessageReplyMarkup можно передавать через BotGate. Склад, подписки и задания остаются в приложении магазина. Шлюз не определяет наличие товара и не заменяет защиту от повторных событий.

Для исходящего вызова используется POST /v1/bots/{botPublicId}/{method} с Bearer API-ключом. При переходе входящих обновлений на BotGate замените проверку прямого secret_token на проверку HMAC из документации. В обработке результата сохраняйте неизвестный исход; автоматические повторы транспорта согласуйте с очередью.

BotGate API и проверка webhook

Telegram: inline-кнопки и callback_query

SQLite: транзакции