Выберите подписную ссылку для канала
Для этого сценария используем createChatSubscriptionInviteLink. Он предназначен для канала; боту нужны права администратора can_invite_users. Период — 2592000 секунд, цена — от 1 до 10000 Stars. Это параметры метода Bot API.
Оплата подписной ссылки поступает на баланс канала. После оплаты Telegram добавляет пользователя и обслуживает продление. Схема отличается от покупки услуги по invoice бота: не создавайте второй счёт поверх платной ссылки и не ожидайте от неё платёжный процесс своего магазина. Описание различий есть в документации подписок Telegram.
Если продаётся доступ к функции приложения, отдельному файлу или личной консультации, потребуется другой сценарий. Его разбирает статья об оплате цифрового доступа в Stars. Здесь строим именно платный вход в канал.
Подготовьте канал и предложение
Создайте отдельный закрытый канал для теста и добавьте бота администратором с правом приглашать участников. Получите числовой chat_id канала.
Проверьте все действующие приглашения. Обычная бесплатная ссылка или ручное добавление участника обходит выбранный платный вход. Решите, кому нужны исключения, и фиксируйте их отдельно.
Сформулируйте предложение: название клуба, содержание, 300 Stars за 30 дней, повторное списание при продлении и способ обратиться в поддержку.
Определите правила для уже добавленных участников. Создание платной ссылки само по себе не превращает всех прежних участников в плательщиков.
Платная ссылка — вход в канал, а не персональный секрет конкретного покупателя. Не используйте факт выдачи ссылки пользователю как доказательство покупки. Для аналитики достаточно хранить версию предложения и канал распространения; реальный доступ проверяется отдельно.
Файлы и подготовка PHP-примера
Пример рассчитан на PHP 8.3+ с cURL, mbstring, PDO и pdo_sqlite. Дополнительные Composer-пакеты не нужны. SQLite упрощает пробный запуск; для нескольких серверов используйте общую БД и блокировки, подходящие её драйверу. Здесь каждый сценарий — отдельная папка со своей БД, не смешивайте одноимённые common.php из разных статей.
public/webhook.php common.php values.php schema.sql init.php create-offer.php bot.php worker.php support-reply.php setup-webhook.php
APP_DB=/private/channel-bot.sqlite BOT_TOKEN=TOKEN_FROM_BOTFATHER CHANNEL_ID=-1001234567890 ACTIVE_OFFER=club-300 WEBHOOK_SECRET=RANDOM_HEX_64 WEBHOOK_URL=https://example.com/webhook.php
Задайте настоящие значения в окружении процесса. Обычный PHP не читает .env автоматически. Не размещайте токены, базу или файлы блокировок в public и не сохраняйте их в Git. Для WEBHOOK_SECRET сгенерируйте случайную строку из допустимых Telegram символов; её длина в примере — 64 шестнадцатеричных знака.
values.php проверяет типы на границе JSON и БД. Некорректные данные прерывают операцию; они не должны превращаться в ложный успешный результат.
<?php
declare(strict_types=1);
/**
* @return array<string,mixed>
*/
function objectValue(mixed $value): array
{
if (!is_array($value)) {
throw new InvalidArgumentException('Expected object');
}
$result = [];
foreach ($value as $key => $item) {
if (!is_string($key)) {
throw new InvalidArgumentException('Expected object keys');
}
$result[$key] = $item;
}
return $result;
}
function stringValue(mixed $value): string
{
if (!is_string($value)) {
throw new InvalidArgumentException('Expected string');
}
return $value;
}
function intValue(mixed $value): int
{
if (!is_int($value) && !is_string($value)) {
throw new InvalidArgumentException('Expected integer');
}
$integer = filter_var($value, FILTER_VALIDATE_INT);
if ($integer === false) {
throw new InvalidArgumentException('Invalid integer');
}
return $integer;
}
<?php
declare(strict_types=1);
require_once __DIR__.'/values.php';
function envRequired(string $name): string
{
$value = getenv($name);
if ($value === false || $value === '') {
throw new RuntimeException('Missing environment: '.$name);
}
return $value;
}
/**
* @param array<string, mixed>|null $data
*
* @param list<string> $headers
*
* @return array{status:int, body:array<string, mixed>}
*/
function jsonHttp(string $method, string $url, ?array $data = null, array $headers = []): array
{
if ($method === '') {
throw new InvalidArgumentException('Empty HTTP method');
}
$curl = curl_init($url);
if ($curl === false) {
throw new RuntimeException('Cannot initialize HTTP client');
}
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 5,
CURLOPT_TIMEOUT => 40,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTPHEADER => ['Accept: application/json', 'Content-Type: application/json', ...$headers],
]);
if ($data !== null) {
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($data, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE));
}
$raw = curl_exec($curl);
$status = (int) curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
if (!is_string($raw)) {
throw new RuntimeException('Transport result unknown');
}
if ($status === 204) {
return ['status' => 204, 'body' => []];
}
$body = objectValue(json_decode($raw, true, 64, JSON_THROW_ON_ERROR));
return ['status' => $status, 'body' => $body];
}
/**
* @param array<string, mixed> $params
* @return array<string, mixed>
*/
function telegram(string $method, array $params): array
{
$response = jsonHttp('POST', 'https://api.telegram.org/bot'.envRequired('BOT_TOKEN').'/'.$method, $params);
if ($response['status'] !== 200 || ($response['body']['ok'] ?? false) !== true) {
throw new RuntimeException('Telegram call failed; inspect HTTP/error_code without logging token');
}
return $response['body'];
}
function database(): PDO
{
$db = new PDO('sqlite:'.envRequired('APP_DB'), null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('PRAGMA busy_timeout=5000');
return $db;
}
CREATE TABLE IF NOT EXISTS inbox (
update_id INTEGER PRIMARY KEY,
payload TEXT NOT NULL,
state TEXT NOT NULL DEFAULT 'pending',
created_at INTEGER NOT NULL,
error_kind TEXT
);
CREATE TABLE IF NOT EXISTS offers (
code TEXT PRIMARY KEY,
chat_id TEXT NOT NULL,
price INTEGER NOT NULL,
invite_link TEXT,
state TEXT NOT NULL,
created_at INTEGER NOT NULL
);
CREATE TABLE IF NOT EXISTS support (
id INTEGER PRIMARY KEY AUTOINCREMENT,
user_id INTEGER NOT NULL,
offer_code TEXT NOT NULL,
state TEXT NOT NULL DEFAULT 'open',
details TEXT NOT NULL DEFAULT '',
created_at INTEGER NOT NULL
);
CREATE UNIQUE INDEX IF NOT EXISTS open_support ON support(user_id) WHERE state='open';
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
$sql = file_get_contents(__DIR__.'/schema.sql');
if ($sql === false) {
throw new RuntimeException('Schema missing');
}
database()->exec($sql);
echo "Database ready\n";
Создайте ссылку один раз
Создание ссылки вынесено в CLI-команду администратора. В таблице offers хранится версия предложения, канал, цена и статус создания. Обработчик /start только читает готовую ссылку и не создаёт новые приглашения. Это позволяет отдельно проверить предложение до выдачи клиентам.
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
$db = database();
$code = $argv[1] ?? '';
$price = filter_var($argv[2] ?? '', FILTER_VALIDATE_INT);
if (!preg_match('/^[a-z0-9-]{1,32}$/D', $code) || $price === false || $price < 1 || $price > 10000) {
throw new RuntimeException('Usage: php create-offer.php club-300 300');
}
$channel = envRequired('CHANNEL_ID');
// Уникальный code не позволяет повторно создать ссылку незаметно.
$db->prepare("INSERT INTO offers(code,chat_id,price,state,created_at) VALUES(?,?,?,'creating',?)")
->execute([$code,$channel,$price,time()]);
try {
$reply = telegram('createChatSubscriptionInviteLink', [
'chat_id' => $channel,'name' => $code,'subscription_period' => 2592000,'subscription_price' => $price,
]);
$link = objectValue($reply['result'] ?? [])['invite_link'] ?? null;
if (!is_string($link) || !str_starts_with($link, 'https://t.me/')) {
throw new RuntimeException('Missing link');
}
$db->prepare("UPDATE offers SET invite_link=?,state='active' WHERE code=?")->execute([$link,$code]);
echo "Offer saved: ".$code."\n";
} catch (Throwable $error) {
$db->prepare("UPDATE offers SET state='review' WHERE code=?")->execute([$code]);
throw $error;
}
php init.php php create-offer.php club-300 300
Успех — сообщение Offer saved и строка offers.state=active. Проверьте ссылку из offers.invite_link на тестовом аккаунте: открывается нужный канал и Telegram показывает 300 Stars за период. Сам скрипт ничего не списывает с пользователя; реальная оплата требует отдельного подтверждения в Telegram.
Состояние creating записывается до API-вызова. При ошибке будет review, а повтор с тем же code остановится на уникальном ключе. Сначала проверьте список приглашений канала у администратора: после потерянного ответа ссылка могла быть создана. Если нашли её, сверьте канал, цену, период и имя, затем восстановите именно эту запись; не удаляйте блокировку и не запускайте создание вслепую.
SELECT code,chat_id,price,state,invite_link FROM offers WHERE code='club-300';
Параметры предложения хранятся на сервере. Не принимайте стоимость или chat_id из callback пользователя. Для нового предложения создайте новый code, протестируйте его и только потом поменяйте ACTIVE_OFFER. Старые строки сохраняйте для поддержки.
Объясните продление и отмену
Период в 30 дней не равен календарному месяцу: не обещайте списание всегда первого числа. Telegram автоматически продлевает подписку за Stars; пользователь управляет ею в интерфейсе Telegram. Если средств не хватает или продление отключено, не объявляйте следующий период оплаченным. Жизненный цикл подписки описан отдельно от Bot API.
Текст перед оплатой для нашего примера: «Доступ к закрытому каналу клуба — 300 Stars на 30 дней. Подписка продлевается автоматически при доступном балансе и включённом продлении. Управлять подпиской можно в Telegram. По вопросам доступа нажмите Помощь с подпиской». Проверьте этот путь на используемых клиентах: названия экранов могут различаться.
Выход из канала и отмена дальнейшего продления — разные действия. Если оплаченный период ещё действует, Telegram поддерживает повторный вход без новой оплаты. Не отправляйте ушедшему участнику новый счёт автоматически: попросите открыть исходное приглашение и проверить подписку в Telegram.
Боту не нужен собственный таймер списаний или ежедневный массовый ban участников. Он обслуживает поддержку и проверку членства. Самостоятельное исключение по устаревшей локальной дате может лишить доступа человека, у которого подписка уже продлилась.
Проверяйте доступ, не подменяя его платёжным отчётом
В bot.php реализованы /start, /access и /help, а также кнопки проверки и помощи. Для личного чата user_id берётся из самого события; у callback дополнительно проверяется совпадение from.id с получателем сообщения. Произвольный Telegram ID из пользовательского текста здесь не принимается.
<?php
declare(strict_types=1);
/**
* @param array<string,mixed> $member
*/
function accessText(array $member): string
{
$status = $member['status'] ?? '';
if ($status === 'creator' || $status === 'administrator') {
return 'Доступ есть по административной роли.';
}
if ($status === 'member') {
$until = $member['until_date'] ?? null;
if (is_int($until) && $until > 0) {
$date = (new DateTimeImmutable('@'.$until))->setTimezone(new DateTimeZone('Europe/Moscow'));
return 'Вы состоите в канале. Telegram сообщает срок подписки: '.$date->format('d.m.Y H:i').' (Москва).';
}
return 'Вы состоите в канале. Срок оплаченного периода в ответе не указан.';
}
if ($status === 'left' || $status === 'kicked') {
return 'Сейчас доступа к каналу нет. Если вы уже платили, проверьте исходную ссылку и обратитесь в поддержку: /help. Не оплачивайте повторно до проверки.';
}
return 'Не удалось однозначно определить доступ. Обратитесь в поддержку: /help.';
}
/**
* @param array<string,mixed> $update
*/
function handleUpdate(PDO $db, array $update): void
{
$callback = $update['callback_query'] ?? null;
$message = is_array($callback) ? ($callback['message'] ?? null) : ($update['message'] ?? null);
if (!is_array($message) || !is_array($message['chat'] ?? null) || ($message['chat']['type'] ?? null) !== 'private'
|| !is_int($message['chat']['id'] ?? null)) {
return;
}
$userId = $message['chat']['id'];
if (is_array($callback) && (!is_array($callback['from'] ?? null) || ($callback['from']['id'] ?? null) !== $userId)) {
return;
}
$action = is_array($callback) ? ($callback['data'] ?? '') : ($message['text'] ?? '');
if (!is_string($action)) {
return;
}
if (is_array($callback) && is_string($callback['id'] ?? null)) {
// Просроченное подтверждение кнопки не должно отменять проверку доступа.
try {
telegram('answerCallbackQuery', ['callback_query_id' => $callback['id']]);
} catch (Throwable) {
}
}
$query = $db->prepare("SELECT * FROM offers WHERE code=? AND state='active'");
$query->execute([envRequired('ACTIVE_OFFER')]);
$offer = $query->fetch(PDO::FETCH_ASSOC);
if (!is_array($offer)) {
throw new RuntimeException('Active offer not configured');
}
$price = intValue($offer['price']);
$reply = [];
if ($action === '/start') {
$text = 'Закрытый клуб: '.$price.' Stars за 30 дней. Подписка продлевается автоматически при доступном балансе и включённом продлении. Управление подпиской — в Telegram. /help — поддержка.';
$reply = ['inline_keyboard' => [
[['text' => 'Вступить — '.$price.' Stars','url' => $offer['invite_link']]],
[['text' => 'Проверить доступ','callback_data' => 'access'],['text' => 'Помощь','callback_data' => 'help']],
]];
} elseif (in_array($action, ['/access','access'], true)) {
try {
$result = telegram('getChatMember', ['chat_id' => $offer['chat_id'],'user_id' => $userId]);
$member = $result['result'] ?? null;
$text = is_array($member) ? accessText(objectValue($member)) : 'Проверка пока недоступна. Попробуйте позже.';
} catch (Throwable) {
$text = 'Проверка пока недоступна. Это не означает отсутствие оплаты.';
}
} elseif (in_array($action, ['/help','help'], true)) {
$db->prepare('INSERT OR IGNORE INTO support(user_id,offer_code,created_at) VALUES(?,?,?)')
->execute([$userId,$offer['code'],time()]);
$q = $db->prepare("SELECT id FROM support WHERE user_id=? AND state='open'");
$q->execute([$userId]);
$text = 'Обращение №'.$q->fetchColumn().'. Напишите, что произошло. Не присылайте коды входа и банковские данные.';
} else {
$q = $db->prepare("UPDATE support SET details=substr(details || char(10) || ?,1,12000) WHERE user_id=? AND state='open'");
$q->execute([mb_substr($action, 0, 2000),$userId]);
$text = $q->rowCount() > 0 ? 'Добавил сообщение в обращение.' : 'Используйте /start, /access или /help.';
}
telegram('sendMessage', ['chat_id' => $userId,'text' => $text] + ($reply ? ['reply_markup' => $reply] : []));
}
accessText отдельно переводит результат getChatMember в ответ клиенту. member означает текущее членство; optional until_date показывает срок, если Telegram его вернул. Администратор получает отдельный текст. left/kicked не объясняют, почему доступа нет, поэтому код не предлагает сразу заплатить снова. Описание ChatMemberMember.
Кнопка «Помощь» и /help создают одну открытую запись поддержки пользователя. При первом обращении сохраняется текущее предложение; повтор после его смены возвращает прежнее открытое обращение. offer_code помогает маршрутизации, но сам по себе не доказывает, по какой ссылке человек платил. Следующие сообщения добавляются к обращению. Старые inline-кнопки остаются безопасными: они не меняют цену и не инициируют списание. В этом минимальном примере проверка всегда относится к настроенному каналу; при нескольких каналах добавьте проверяемый сервером идентификатор предложения.
При сбое getChatMember бот пишет о недоступной проверке, а не об отсутствии оплаты. Автоматические повторы чтения можно добавить с небольшим пределом; повтор sendMessage — отдельная операция с риском дубля. На рабочем боте ограничьте частоту /access для каждого пользователя.
Как менять предложение и отзывать приглашение
editChatSubscriptionInviteLink меняет название ссылки, но не её цену или период. Для другой цены создайте новое предложение и новую ссылку. revokeChatInviteLink отзывает приглашение, созданное ботом. Методы управления ссылкой не следует трактовать как управление всеми действующими подписками.
В приложении храните версии: club-300, club-500, дату прекращения выдачи старой ссылки и текст условий. Новым пользователям показывайте нужную версию; обращения прежних подписчиков связывайте с их исходным предложением. Не обещайте, что новая цена автоматически применится к действующим участникам.
Перед отзывом рабочей ссылки подготовьте маршрут поддержки для тех, кто сохранил старую кнопку. Отзыв ссылки не равен возврату средств, отмене продления или немедленному исключению всех вступивших по ней. Каждое из этих действий требует собственного подтверждённого механизма.
Помогите подписчику без повторной покупки
«Оплатил, но не попал»: сверить аккаунт Telegram, канал и текущее членство; попросить открыть исходную ссылку. Не запрашивать код входа, пароль или данные банковской карты.
«Вышел случайно»: предложить исходное приглашение и проверить текущий оплаченный период в Telegram, прежде чем обсуждать новую оплату.
«Не хочу продлевать»: объяснить управление подпиской в Telegram. Кнопка вашего бота «Больше не присылать новости» не отменяет подписку канала.
«Хочу возврат»: зарегистрировать обращение и передать администратору канала. Не показывать успешный возврат до фактического подтверждения операции.
Методы возврата и отмены подписки бота, привязанные к его платёжной транзакции, нельзя автоматически использовать для подписной ссылки канала. Не придумывайте telegram_payment_charge_id из ID пользователя или приглашения. Поддержка должна различать продукты и получателя платежа.
Сохраняйте номер обращения, канал, Telegram user_id, время проверки и технический результат без токенов. Пользователю сообщайте номер и следующий шаг. Переписку с сотрудником можно организовать через операторскую группу.
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
$id = filter_var($argv[1] ?? '', FILTER_VALIDATE_INT);
$text = trim($argv[2] ?? '');
if ($id === false || $id < 1 || $text === '' || mb_strlen($text) > 2000) {
throw new RuntimeException('Usage: php support-reply.php ID "Ответ"');
}
$lock = fopen(envRequired('APP_DB').'.worker.lock', 'c');
if ($lock === false || !flock($lock, LOCK_EX | LOCK_NB)) {
throw new RuntimeException('Worker busy; try later');
}
$db = database();
$q = $db->prepare("SELECT user_id FROM support WHERE id=? AND state='open'");
$q->execute([$id]);
$userId = $q->fetchColumn();
if ($userId === false) {
throw new RuntimeException('Open request not found');
}
telegram('sendMessage', ['chat_id' => (int)$userId,'text' => $text]);
$db->prepare("UPDATE support SET state='closed' WHERE id=?")->execute([$id]);
echo "Reply sent\n";
SELECT id,user_id,offer_code,details FROM support WHERE state='open' ORDER BY id;
php support-reply.php 1 "Проверьте исходное приглашение с того аккаунта, которым оплачена подписка. Если доступ не восстановился, сообщите время оплаты."
Команда отвечает конкретному пользователю и закрывает только указанное обращение после подтверждённого ответа API. Номер обращения не даёт права выполнить возврат или изменить подписку. CLI предназначен для сотрудника с серверным доступом; для веб-интерфейса потребуются аутентификация, права и журнал действий.
Если Telegram принял сообщение, а процесс остановился до UPDATE, обращение останется открытым. Перед повтором сверьте диалог. В большой поддержке вместо ручного скрипта нужен журнал исходящих сообщений с состоянием неизвестного результата.
Как подключается Telegram-транспорт
Функция telegram использует прямой Bot API. При переходе на BotGate замените исходящий адрес и авторизацию по документации, а проверку входящего webhook — на HMAC BotGate. Не запускайте приведённый setup-webhook.php для уже управляемого подключения BotGate.
Приём событий и запуск worker
Файлы ниже подключают основную логику к прямому webhook Telegram. Для одного бота используется одна SQLite-база и один worker. Секрет проверяется до разбора тела, успешный HTTP-ответ возвращается после записи события. Повтор одного update_id не создаёт вторую строку. Если используете другой существующий обработчик, перенесите вызов handleUpdate после его проверки подлинности и дедупликации.
<?php
declare(strict_types=1);
require dirname(__DIR__).'/common.php';
$secret = $_SERVER['HTTP_X_TELEGRAM_BOT_API_SECRET_TOKEN'] ?? '';
if (!is_string($secret) || !hash_equals(envRequired('WEBHOOK_SECRET'), $secret)) {
http_response_code(403);
exit;
}
$raw = file_get_contents('php://input', false, null, 0, 65537);
if (!is_string($raw) || strlen($raw) > 65536) {
http_response_code(413);
exit;
}
try {
$update = json_decode($raw, true, 32, JSON_THROW_ON_ERROR);
if (!is_array($update) || !is_int($update['update_id'] ?? null)) {
http_response_code(400);
exit;
}
$stmt = database()->prepare('INSERT OR IGNORE INTO inbox(update_id,payload,created_at) VALUES(?,?,?)');
$stmt->execute([$update['update_id'], $raw, time()]);
http_response_code(200);
} catch (Throwable) {
http_response_code(503);
}
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
require __DIR__.'/bot.php';
$lock = fopen(envRequired('APP_DB').'.worker.lock', 'c');
if ($lock === false || !flock($lock, LOCK_EX | LOCK_NB)) {
exit(0);
}
$db = database();
$pending = $db->query("SELECT * FROM inbox WHERE state='pending' ORDER BY update_id LIMIT 20");
if ($pending === false) {
throw new RuntimeException('Cannot read inbox');
}
$pending->setFetchMode(PDO::FETCH_ASSOC);
foreach ($pending as $data) {
$row = objectValue($data);
$row['update_id'] = intValue($row['update_id']);
$claim = $db->prepare("UPDATE inbox SET state='processing' WHERE update_id=? AND state='pending'");
$claim->execute([$row['update_id']]);
if ($claim->rowCount() !== 1) {
continue;
}
try {
$update = objectValue(json_decode(stringValue($row['payload']), true, 32, JSON_THROW_ON_ERROR));
handleUpdate($db, $update);
$db->prepare("UPDATE inbox SET state='done' WHERE update_id=?")->execute([$row['update_id']]);
} catch (Throwable) {
// Повтор после отправки может продублировать сообщение.
$db->prepare("UPDATE inbox SET state='review',error_kind='handler_failed' WHERE update_id=?")
->execute([$row['update_id']]);
}
}
flock($lock, LOCK_UN);
fclose($lock);
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
telegram('setWebhook', [
'url' => envRequired('WEBHOOK_URL'),
'secret_token' => envRequired('WEBHOOK_SECRET'),
'allowed_updates' => ['message', 'callback_query'],
]);
echo "Webhook configured\n";
php init.php php setup-webhook.php php worker.php
Сначала создайте отдельного тестового бота и откройте только каталог public по HTTPS. В WEBHOOK_URL укажите полный адрес /webhook.php. APP_DB находится вне public; каталог базы доступен на запись процессам PHP. Переменные окружения должны быть доступны и PHP-FPM, и CLI worker: экспорт в одной SSH-сессии не настраивает PHP-FPM.
После /start запустите worker.php: появится приветствие, а inbox.state станет done. Для теста держите цикл ниже открытым в терминале; в рабочей системе настройте постоянный процесс под менеджером процессов. Для inline-кнопок особенно важна быстрая обработка: очередь с минутным интервалом задерживает answerCallbackQuery. При нагрузке подтверждение кнопок отделяйте от долгих заданий. Один проход берёт до 20 событий; flock не допускает параллельный запуск на одном сервере. В этом учебном варианте worker последовательно делает сетевые запросы, поэтому при большом потоке нужна общая очередь и лимиты на пользователя.
processing после аварии и review после ошибки не возвращаются в pending автоматически: Telegram мог уже принять сообщение. Сверьте конкретный диалог, затем решайте, нужна ли повторная обработка. Не сбрасывайте весь inbox одним UPDATE. Для временного лимита в рабочей версии добавьте next_attempt_at и обработку retry_after; повторять все ошибки без разбора нельзя.
SELECT update_id,state,error_kind,created_at FROM inbox ORDER BY update_id DESC LIMIT 20; SELECT COUNT(*) AS pending FROM inbox WHERE state='pending';
while true; do php worker.php sleep 1 done
BotGate и проверка перед запуском
При использовании BotGate Telegram-методы вызываются через /v1/bots/{botPublicId}/{method} с Bearer API-ключом; JSON-параметры сохраняются. Ссылки и баланс Stars принадлежат Telegram, условия предложения и обращения — вашему приложению. Формат запросов описан в документации.
Проверьте, что приглашение ведёт в нужный закрытый канал и Telegram показывает выбранные 300 Stars и период до подтверждения оплаты.
Проверьте обычного участника, администратора, вышедшего пользователя и ошибку чтения. Бот не должен называть ошибку сети неоплатой.
Повторные /start и нажатия не создают новые приглашения и обращения.
Проверьте устаревшую кнопку после смены предложения и доступность поддержки.
Фактическую оплату, продление, отмену и повторный вход проверяйте отдельно на контролируемых аккаунтах. Успешный ответ создания ссылки ещё не проверяет весь платёжный цикл.
Проведите два разных теста: технический без платежа (/start, /access, /help, повтор кнопок и ответ поддержки) и отдельный пользовательский платёжный цикл. Для второго заранее выберите контролируемые аккаунты и согласованный расход Stars. Команда создания приглашения и успешный тест getChatMember не подтверждают продление через 30 дней.
Проверьте также удаление права can_invite_users у тестового бота: создание нового предложения должно остановиться, а приложение не должно объявить ссылку готовой. Верните право и разберите review-запись вручную. Это помогает отличить недостаточные права от сетевого сбоя и не выдавать клиенту несуществующее приглашение.