Определите границу данных
В приложении есть внутренний bot_id, владелец tenant_id и Telegram ID самого бота. Это разные идентификаторы. route key нужен для адреса webhook, а chat_id и update_id имеют смысл внутри выбранного бота. Один пользователь может писать двум ботам; это не повод объединять его историю и настройки.
Данные | Ключ в примере |
|---|---|
Настройки бота | tenant_bots.id; public_key и telegram_bot_id уникальны. |
Входящее обновление | bot_id + update_id. |
Контакт | bot_id + chat_id. |
Ответ на обновление | bot_id + inbox_id. |
Задание очереди | Явные botId и ID сохранённой операции. |
tenant_id объединяет ботов владельца, но сам по себе не даёт администратору чужого клиента доступ. Панель управления должна проверять текущего сотрудника и принадлежность tenant. В статье настройка выполняется доверенным сотрудником через CLI; публичного API для создания и редактирования ботов здесь нет.
Для файлов, диалогов, кеша, ограничителей и аналитики применяйте ту же область. Кеш по одному chat_id, глобальный текущий токен или поиск заявки только по её номеру разрушат изоляцию, даже если webhook правильно определяет бота. Случайный URL не заменяет проверку подписи и владельца.
Подготовьте Laravel и таблицы
Пример рассчитан на Laravel 13 и PHP 8.3+. Используются штатные HTTP client, database queue, Scheduler и Crypt; SDK Telegram не требуется. Команды ниже создают отдельное учебное приложение. Для проверки используйте два своих тестовых бота и отдельную БД.
composer create-project laravel/laravel multi-bot "^13.0" cd multi-bot
APP_URL=https://bots.example.com APP_DEBUG=false QUEUE_CONNECTION=database CACHE_STORE=database
Сохраните штатный APP_KEY нового приложения; для уже существующего проекта его не перевыпускают. Crypt использует этот ключ для токенов. Выберите БД и проверьте наличие стандартных миграций jobs, failed_jobs и cache. Миграция ниже добавляет только таблицы сценария; не создавайте вторые таблицы очереди с теми же именами.
<?php
declare(strict_types=1);
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class () extends Migration {
public function up(): void
{
Schema::create('tenant_bots', function (Blueprint $t): void {
$t->id();
$t->string('tenant_id');
$t->string('label');
$t->string('public_key', 32)->unique();
$t->string('telegram_bot_id')->unique();
$t->text('token_ciphertext');
$t->string('webhook_hash', 64)->nullable();
$t->boolean('enabled')->default(false);
});
Schema::create('bot_inbox', function (Blueprint $t): void {
$t->id();
$t->foreignId('bot_id')->constrained('tenant_bots');
$t->bigInteger('update_id');
$t->text('payload');
$t->string('state')->default('pending');
$t->unique(['bot_id','update_id']);
});
Schema::create('bot_chats', function (Blueprint $t): void {
$t->id();
$t->foreignId('bot_id')->constrained('tenant_bots');
$t->string('chat_id');
$t->timestamp('last_seen_at');
$t->unique(['bot_id','chat_id']);
});
Schema::create('bot_outbox', function (Blueprint $t): void {
$t->id();
$t->foreignId('bot_id')->constrained('tenant_bots');
$t->foreignId('inbox_id')->constrained('bot_inbox');
$t->text('payload');
$t->string('state')->default('pending');
$t->unsignedInteger('attempts')->default(0);
$t->timestamp('next_attempt_at')->nullable();
$t->bigInteger('message_id')->nullable();
$t->integer('error_code')->nullable();
$t->unique(['bot_id','inbox_id']);
});
}
public function down(): void
{
foreach (['bot_outbox','bot_chats','bot_inbox','tenant_bots'] as $table) {
Schema::dropIfExists($table);
}
}
};
app/GuideBots/BotRecord.php app/GuideBots/BotWebhook.php app/GuideBots/ProcessBotUpdate.php app/GuideBots/BotTransport.php app/GuideBots/SendBotMessage.php app/Console/Commands/AddTenantBot.php app/Console/Commands/ConfigureBotWebhook.php app/Console/Commands/DrainBots.php routes/api.php routes/console.php
SQLite подходит для локальной проверки на одном процессе. Для параллельных production-worker используйте СУБД с нужными блокировками строк и проверьте lockForUpdate на ней. Локальный тест SQLite не доказывает конкурентное поведение MariaDB или PostgreSQL.
Загружайте настройки конкретного бота
<?php
declare(strict_types=1);
namespace App\GuideBots;
use Illuminate\Support\Facades\DB;
final readonly class BotRecord
{
public function __construct(public int $id, public string $label, public string $key, public string $ciphertext, public ?string $webhookHash, public bool $enabled)
{
}
public static function find(int $id): self
{
$row = DB::table('tenant_bots')->where('id', $id)->first();
if ($row === null) {
throw new \RuntimeException('Bot missing');
}
return new self(
(int)$row->id,
(string)$row->label,
(string)$row->public_key,
(string)$row->token_ciphertext,
$row->webhook_hash === null ? null : (string)$row->webhook_hash,
(bool)$row->enabled
);
}
public function queue(string $direction): string
{
if (!in_array($direction, ['in','out'], true)) {
throw new \InvalidArgumentException('Queue direction');
}
return 'bot-'.$direction.'-'.$this->id;
}
public static function idValue(mixed $value): int
{
if (!is_int($value) && !is_string($value)) {
throw new \InvalidArgumentException('Invalid ID');
}
$id = filter_var($value, FILTER_VALIDATE_INT);
if ($id === false || $id < 1) {
throw new \InvalidArgumentException('Invalid ID');
}
return $id;
}
}
BotRecord — короткий неизменяемый объект настроек. В очередь передаётся только внутренний ID; при выполнении настройки перечитываются. Поэтому уже поставленное задание увидит новый токен или выключенный enabled, а сериализованная задача не содержит старый секрет.
Не меняйте config("telegram.token") или singleton-клиент перед каждой отправкой. Долгоживущий worker обработает после клиента A задачу клиента B, и оставшееся глобальное состояние может выбрать чужого бота. Здесь HTTP-запрос получает конкретный BotRecord, а URL строится из его расшифрованного токена.
Имя очереди также формируется сервером из числового ID. Клиент не присылает tenant_id, bot_id или имя очереди в теле webhook. Для крупной установки можно распределить ботов по нескольким фиксированным группам очередей, но область данных и явный bot_id должны сохраниться.
Добавьте двух ботов и настройте webhook
<?php
declare(strict_types=1);
namespace App\Console\Commands;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\{Crypt,DB,Http};
final class AddTenantBot extends Command
{
protected $signature = 'bots:add {tenant} {label}';
protected $description = 'Add a bot with an encrypted token';
public function handle(): int
{
$token = $this->secret('Токен тестового бота');
if (!is_string($token) || !preg_match('/^[0-9]+:[A-Za-z0-9_-]+$/D', $token)) {
return self::FAILURE;
}
try {
$response = Http::timeout(15)->get('https://api.telegram.org/bot'.$token.'/getMe');
} catch (\Throwable) {
$this->error('Проверка токена недоступна');
return self::FAILURE;
}
$body = $response->json();
$result = is_array($body) ? ($body['result'] ?? null) : null;
if (!$response->successful() || !is_array($result) || !is_int($result['id'] ?? null)) {
$this->error('Токен не подтверждён');
return self::FAILURE;
}
if (DB::table('tenant_bots')->where('telegram_bot_id', (string)$result['id'])->exists()) {
$this->error('Этот бот уже добавлен');
return self::FAILURE;
}
$id = DB::table('tenant_bots')->insertGetId(['tenant_id' => $this->argument('tenant'),'label' => $this->argument('label'),
'public_key' => bin2hex(random_bytes(16)),'telegram_bot_id' => (string)$result['id'],'token_ciphertext' => Crypt::encryptString($token),'enabled' => false]);
$this->info('Bot ID: '.$id.'. Далее: php artisan bots:webhook '.$id);
return self::SUCCESS;
}
}
<?php
declare(strict_types=1);
namespace App\Console\Commands;
use App\GuideBots\BotRecord;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\{Crypt,DB,Http};
final class ConfigureBotWebhook extends Command
{
protected $signature = 'bots:webhook {id}';
protected $description = 'Configure direct Telegram webhook';
public function handle(): int
{
$bot = BotRecord::find(BotRecord::idValue($this->argument('id')));
$base = config('app.url');
if (!is_string($base)) {
throw new \RuntimeException('APP_URL missing');
}$base = rtrim($base, '/');
if (!str_starts_with($base, 'https://')) {
$this->error('APP_URL должен использовать HTTPS');
return self::FAILURE;
}
$secret = bin2hex(random_bytes(32));
DB::table('tenant_bots')->where('id', $bot->id)->update(['enabled' => true,'webhook_hash' => hash('sha256', $secret)]);
try {
$r = Http::timeout(15)->post('https://api.telegram.org/bot'.Crypt::decryptString($bot->ciphertext).'/setWebhook', [
'url' => $base.'/api/telegram/'.$bot->key,'secret_token' => $secret,'allowed_updates' => ['message']
]);
$ok = $r->successful() && $r->json('ok') === true;
} catch (\Throwable) {
$ok = false;
}
if (!$ok) {
DB::table('tenant_bots')->where('id', $bot->id)->update(['enabled' => false]);
$this->error('Настройка не подтверждена; бот приостановлен. Повторите команду после диагностики.');
return self::FAILURE;
}
$this->info('Webhook configured for bot '.$bot->id);
return self::SUCCESS;
}
}
bots:add запрашивает токен скрытым вводом, проверяет getMe и сохраняет шифротекст. Уникальный Telegram ID не позволяет случайно добавить один токен как два независимых бота. Команда доступна сотруднику с серверным доступом; это не доказательство владения ботом для произвольного посетителя сайта.
bots:webhook создаёт отдельный секрет и сохраняет его SHA-256, затем настраивает прямой Telegram webhook. В базе не нужен исходный webhook-секрет. Повтор команды меняет его: возможен короткий отказ для старого входящего запроса, после которого Telegram повторит событие. Если результат setWebhook неизвестен, запись приостанавливается, а команда завершается с ошибкой; после диагностики настройку можно повторить.
Не выводите токен в URL журнала, exception tracker или HTTP-debugger. Код перехватывает сетевые исключения настройки и показывает общее сообщение. Если в приложении включено подробное логирование исходящих запросов, исключите URL Telegram с токеном и шифротекст настроек из такого журнала.
Выберите бота до обработки сообщения
<?php
declare(strict_types=1);
namespace App\GuideBots;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\DB;
final class BotWebhook
{
public function __invoke(Request $request, string $key): Response
{
$id = DB::table('tenant_bots')->where('public_key', $key)->value('id');
abort_if($id === null, 404);
$bot = BotRecord::find(BotRecord::idValue($id));
$secret = $request->header('X-Telegram-Bot-Api-Secret-Token', '');
abort_unless($bot->enabled && $bot->webhookHash !== null && is_string($secret) && hash_equals($bot->webhookHash, hash('sha256', $secret)), 403);
$raw = $request->getContent();
abort_if(strlen($raw) > 131072, 413);
try {
$update = json_decode($raw, true, 32, JSON_THROW_ON_ERROR);
} catch (\JsonException) {
abort(400);
}
if (!is_array($update) || !is_int($update['update_id'] ?? null)) {
abort(400);
}
DB::table('bot_inbox')->insertOrIgnore(['bot_id' => $bot->id,'update_id' => $update['update_id'],'payload' => $raw,'state' => 'pending']);
$inbox = DB::table('bot_inbox')->where('bot_id', $bot->id)->where('update_id', $update['update_id'])->value('id');
try {
ProcessBotUpdate::dispatch($bot->id, BotRecord::idValue($inbox))->onQueue($bot->queue('in'));
} catch (\Throwable) {
logger()->warning('Bot dispatch deferred', ['bot_id' => $bot->id,'inbox_id' => $inbox]);
}
return response('',200); // Событие сохранено; scheduler восстановит dispatch.
}
}
<?php
use App\GuideBots\BotWebhook;
use Illuminate\Support\Facades\Route;
Route::post('/telegram/{key}',BotWebhook::class)->where('key','[a-f0-9]{32}');
->withRouting(
web: __DIR__.'/../routes/web.php',
api: __DIR__.'/../routes/api.php',
commands: __DIR__.'/../routes/console.php',
health: '/up',
)
Стандартный api prefix делает полный путь /api/telegram/{key}. Не переносите webhook в web-группу с cookie/CSRF-проверкой и не отключайте CSRF для всего сайта. Здесь авторизация внешнего запроса выполняется секретом выбранного бота, а не пользовательской сессией. Маршруты Laravel, setWebhook.
Контроллер сначала находит конфигурацию по route key, затем проверяет секрет, enabled и размер тела. Только после этого JSON попадает в inbox. Одинаковый update_id у двух ботов создаст две независимые строки. Повтор того же обновления у одного бота использует прежнюю строку.
Ответ 200 означает, что событие надёжно сохранено, а не что клиент уже получил сообщение. Если dispatch в брокер не сработал, inbox остаётся pending, и периодическая команда поднимет его позже. Ошибка записи в БД должна вернуть неуспешный HTTP-ответ, чтобы Telegram мог повторить доставку.
Обработайте событие в области выбранного бота
<?php
declare(strict_types=1);
namespace App\GuideBots;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Queue\Queueable;
use Illuminate\Support\Facades\DB;
final class ProcessBotUpdate implements ShouldQueue
{
use Queueable;
public int $tries = 3;
public int $backoff = 10;
public function __construct(public readonly int $botId, public readonly int $inboxId)
{
}
public function handle(): void
{
$bot = BotRecord::find($this->botId);
$outbox = DB::transaction(function () use ($bot): ?int {
$row = DB::table('bot_inbox')->where('bot_id', $bot->id)->where('id', $this->inboxId)->lockForUpdate()->first();
if ($row === null || $row->state !== 'pending') {
return null;
}
if (!$bot->enabled) {
DB::table('bot_inbox')->where('id', $row->id)->update(['state' => 'paused']);
return null;
}
$update = json_decode((string)$row->payload, true, 32, JSON_THROW_ON_ERROR);
$message = is_array($update) ? ($update['message'] ?? null) : null;
$chat = is_array($message) ? ($message['chat'] ?? null) : null;
if (!is_array($chat) || ($chat['type'] ?? null) !== 'private' || !is_int($chat['id'] ?? null) || ($message['text'] ?? null) !== '/start') {
DB::table('bot_inbox')->where('id', $row->id)->update(['state' => 'ignored']);
return null;
}
$chatId = (string)$chat['id'];
DB::table('bot_chats')->upsert([['bot_id' => $bot->id,'chat_id' => $chatId,'last_seen_at' => now()]], ['bot_id','chat_id'], ['last_seen_at']);
DB::table('bot_outbox')->insertOrIgnore(['bot_id' => $bot->id,'inbox_id' => $row->id,'payload' => json_encode([
'chat_id' => $chatId,'text' => 'Здравствуйте! Это бот «'.$bot->label.'». Ваше сообщение принято.'
], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE),'state' => 'pending']);
DB::table('bot_inbox')->where('id', $row->id)->update(['state' => 'done']);
return BotRecord::idValue(DB::table('bot_outbox')->where('bot_id', $bot->id)->where('inbox_id', $row->id)->value('id'));
});
if ($outbox !== null) {
SendBotMessage::dispatch($bot->id, $outbox)->onQueue($bot->queue('out'));
}
}
public function failed(?\Throwable $e): void
{
DB::table('bot_inbox')->where('bot_id', $this->botId)->where('id', $this->inboxId)->where('state', 'pending')->update(['state' => 'failed']);
}
}
Job повторно ограничивает выборку и по bot_id, и по inboxId. Даже ошибочная постановка задачи с ID чужой строки не обработает её. В одной транзакции сохраняются контакт, outbox и состояние inbox. Внутри нет сетевого обращения к Telegram, поэтому повтор обработки до commit не оставит половину бизнес-действия.
Основной пример намеренно отвечает только на /start в личном чате. Он достаточно мал, чтобы увидеть выбор бота и проверить два имени в ответах. Ваш обработчик заказов или поддержки вставляется на этом месте, продолжая передавать bot_id во все запросы и разрешения. Прочие события отмечаются ignored; они не превращаются в исключение и не занимают очередь бесконечными повторами.
Dispatch отправки выполняется после возврата из транзакции. Между commit и dispatch возможна авария, поэтому одних afterCommit-настроек очереди недостаточно для восстановления: команда bots:drain отдельно ищет сохранённый outbox. Транзакции и задания Laravel.
Передайте ID бота в очередь отправки
<?php
declare(strict_types=1);
namespace App\GuideBots;
use Illuminate\Support\Facades\Crypt;
use Illuminate\Support\Facades\Http;
final class BotTransport
{
/**
* @param array<string,mixed> $payload
*
* @return array{state:string,delay:int,message_id:?int,error_code:?int}
*/
public function send(BotRecord $bot, array $payload): array
{
$unknown = ['state' => 'unknown','delay' => 0,'message_id' => null,'error_code' => null];
try {
$token = Crypt::decryptString($bot->ciphertext);
$response = Http::connectTimeout(5)->timeout(20)->post('https://api.telegram.org/bot'.$token.'/sendMessage', $payload);
} catch (\Throwable) {
return $unknown;
}
if ($response->status() >= 500) {
return $unknown;
}
$body = $response->json();
if (!is_array($body)) {
return $unknown;
}
$result = $body['result'] ?? null;
if ($response->successful() && ($body['ok'] ?? false) === true && is_array($result) && is_int($result['message_id'] ?? null)) {
return ['state' => 'sent','delay' => 0,'message_id' => $result['message_id'],'error_code' => null];
}
$code = $body['error_code'] ?? null;
$p = $body['parameters'] ?? null;
if (($body['ok'] ?? null) !== false || !is_int($code)) {
return $unknown;
}
if ($code === 429 && is_array($p) && is_int($p['retry_after'] ?? null) && $p['retry_after'] > 0) {
return ['state' => 'retry','delay' => $p['retry_after'],'message_id' => null,'error_code' => $code];
}
return ['state' => $code >= 400 && $code < 500 ? 'failed' : 'unknown','delay' => 0,'message_id' => null,'error_code' => $code];
}
}
<?php
declare(strict_types=1);
namespace App\GuideBots;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Queue\Queueable;
use Illuminate\Support\Facades\DB;
final class SendBotMessage implements ShouldQueue
{
use Queueable;
public int $tries = 1;
public int $timeout = 30;
public function __construct(public readonly int $botId, public readonly int $outboxId)
{
}
public function handle(BotTransport $transport): void
{
$bot = BotRecord::find($this->botId);
$payload = DB::transaction(function () use ($bot): ?array {
$q = DB::table('bot_outbox')->where('bot_id', $bot->id)->where('id', $this->outboxId);
$row = $q->lockForUpdate()->first();
if ($row === null || !in_array($row->state, ['pending','retry'], true) || ($row->next_attempt_at !== null && now()->lt($row->next_attempt_at))) {
return null;
}
if (!$bot->enabled) {
$q->update(['state' => 'paused']);
return null;
}
if ((int)$row->attempts >= 5) {
$q->update(['state' => 'failed']);
return null;
}
$payload = json_decode((string)$row->payload, true, 32, JSON_THROW_ON_ERROR);
if (!is_array($payload)) {
throw new \RuntimeException('Invalid stored payload');
}
$q->update(['state' => 'sending','attempts' => (int)$row->attempts + 1]);
return $payload;
});
if ($payload === null) {
return;
}
if (!is_array($payload)) {
throw new \RuntimeException('Invalid payload');
}
$object = [];
foreach ($payload as $key => $value) {
if (!is_string($key)) {
throw new \RuntimeException('Invalid payload key');
}$object[$key] = $value;
}
$r = $transport->send($bot, $object);
DB::table('bot_outbox')->where('bot_id', $bot->id)->where('id', $this->outboxId)->update([
'state' => $r['state'],'next_attempt_at' => now()->addSeconds($r['delay']),'message_id' => $r['message_id'],'error_code' => $r['error_code']
]);
// retry подхватит scheduler; sending после аварии разбирается вручную.
}
}
SendBotMessage ещё раз проверяет bot_id, состояние строки и активность конфигурации. Состояние sending фиксируется до сети; параллельная копия job увидит, что операция уже взята. При успехе сохраняются sent и message_id. Код использует HTTP client без retry, чтобы повторы не происходили одновременно в транспорте и очереди.
Только подтверждённый 429 с retry_after создаёт автоматический повтор; scheduler поставит его не раньше next_attempt_at. После пяти попыток операция требует разбора. Ошибки доступа не блокируют остальные боты, а 5xx и сетевой сбой остаются unknown. $tries=1 для отправки защищает от слепого повторения после исключения worker.
Если worker убит между отправкой и сохранением результата, sending останется без подтверждения. После проверки завершения процесса и конкретного чата решите, отметить ли sent или разрешить повтор. Простое queue:retry всех failed jobs не является процедурой восстановления Telegram-доставки.
Параметры HTTP client и подставные ответы описаны в документации Laravel. При смене транспорта сохраняйте различие между отказом, отложенной попыткой и неизвестным результатом. Отсутствие HTTP-исключения само по себе не означает ok=true у Telegram.
Разведите очереди и восстановление задач
<?php
declare(strict_types=1);
namespace App\Console\Commands;
use App\GuideBots\{BotRecord,ProcessBotUpdate,SendBotMessage};
use Illuminate\Console\Command;
use Illuminate\Support\Facades\DB;
final class DrainBots extends Command
{
protected $signature = 'bots:drain';
protected $description = 'Queue pending bot work';
public function handle(): int
{
$failed = false;
foreach (DB::table('tenant_bots')->where('enabled', true)->orderBy('id')->cursor() as $row) {
try {
$bot = BotRecord::find((int)$row->id);
foreach (DB::table('bot_inbox')->where('bot_id', $bot->id)->where('state', 'pending')->orderBy('id')->limit(100)->get() as $in) {
ProcessBotUpdate::dispatch($bot->id, (int)$in->id)->onQueue($bot->queue('in'));
}
foreach (DB::table('bot_outbox')->where('bot_id', $bot->id)->whereIn('state', ['pending','retry'])
->where(fn ($q) => $q->whereNull('next_attempt_at')->orWhere('next_attempt_at', '<=', now()))->orderBy('id')->limit(100)->get() as $out) {
SendBotMessage::dispatch($bot->id, (int)$out->id)->onQueue($bot->queue('out'));
}
} catch (\Throwable) {
$failed = true;
logger()->warning('Bot queue recovery failed', ['bot_id' => $row->id]);
}
}
return $failed ? self::FAILURE : self::SUCCESS;
}
}
use Illuminate\Support\Facades\Schedule;
Schedule::command('bots:drain')->everyMinute()->withoutOverlapping();
Команда берёт ограниченное число входящих и исходящих операций каждого активного бота. Возможные повторные dispatch допустимы: бизнес-уникальность обеспечивают БД и проверка состояния, а не надежда на одну копию job. Нужен постоянно работающий Scheduler; withoutOverlapping требует подходящего cache backend, общего для нескольких серверов.
php artisan queue:work database --queue=bot-in-1 --timeout=40 --sleep=1 php artisan queue:work database --queue=bot-out-1 --timeout=40 --sleep=1 php artisan queue:work database --queue=bot-in-2 --timeout=40 --sleep=1 php artisan queue:work database --queue=bot-out-2 --timeout=40 --sleep=1
Каждую строку запускают в отдельном терминале для теста или отдельном процессе под менеджером процессов. В production retry_after соединения очереди должен быть больше timeout worker; HTTP timeout в коде — 20 секунд. Нельзя запустить эти четыре долгоживущие команды последовательно в одном терминале и ожидать одновременной работы.
Так зависший запрос бота A не занимает worker исходящих сообщений бота B. Общая БД, Redis, сеть и CPU всё равно остаются общими ресурсами: для строгих квот нужны лимиты по клиенту и отдельные ресурсы. Один worker со списком bot-out-1,bot-out-2 выбирает очереди по приоритету и не даёт такой же изоляции при большом потоке первой.
Выключение enabled останавливает новые приёмы и очередные операции, но не отзывает уже начавшийся HTTP-запрос. При необходимости полного отключения остановите процессы этого бота и проверьте sending. При возобновлении отдельно разберите paused-записи, не возвращая в pending все состояния без фильтра.
Проверьте два бота на одном пользователе
php artisan migrate php artisan route:list --path=api/telegram php artisan bots:add agency-a "Север" php artisan bots:add agency-b "Юг" # Подставьте ID из вывода bots:add: php artisan bots:webhook 1 php artisan bots:webhook 2 php artisan bots:drain php artisan schedule:work
После настройки webhook и запуска отдельных worker отправьте /start обоим ботам с одного Telegram-аккаунта. Первый должен назвать себя «Север», второй — «Юг». В bot_chats появятся две строки с одинаковым chat_id и разными bot_id. Токен одного не должен попадать в запрос другого.
SELECT id,tenant_id,label,enabled FROM tenant_bots; SELECT bot_id,update_id,state FROM bot_inbox; SELECT bot_id,chat_id FROM bot_chats; SELECT bot_id,inbox_id,state,attempts,message_id,error_code FROM bot_outbox;
Один update_id для A и B создаёт две строки; повтор для A не создаёт третью.
Секрет A на URL B возвращает 403 до вставки inbox.
Job с botId=A и inboxId от B не создаёт контакт или ответ.
Два отправителя одной строки не отправляют её одновременно после захвата sending.
Подставной 429 у A не меняет состояние B.
Выключенный бот не отправляет ранее ожидавшие задания, но сохраняет их для разбора.
После разрыва между сохранением inbox/outbox и dispatch команда bots:drain восстанавливает обработку.
Что добавить для клиентского сервиса
Разделите наблюдаемость по bot_id и tenant_id: возраст pending, число unknown, failed и paused, состояние webhook и задержки очередей. Технические логи содержат ID операции и код ошибки, но не токен, initData или полную клиентскую переписку. При ротации токена очередь перечитает конфигурацию на следующем задании; выполненные сообщения не нужно отправлять заново.
Панель администратора требует серверных политик доступа. Получать bot_id из select в браузере и затем выполнять BotRecord::find без проверки владельца недостаточно. Также ограничьте, кто может менять получателя, webhook и токен, а изменения настроек фиксируйте в журнале действий.
При переходе на BotGate в конфигурации хранится public ID подключённого бота, а исходящий запрос выбирает его явно: /v1/bots/{botPublicId}/{method}. Проверка прямого webhook заменяется проверкой HMAC BotGate. Не доверяйте одному идентификатору из заголовка без проверки подписи и связи с конфигурацией. Настройки сервиса и формат заголовков смотрите в документации; команды прямого setWebhook из этой статьи для управляемого подключения не используются.
Пример демонстрирует один Laravel-процесс приложения и изоляцию операций по боту. Он не обещает физическую изоляцию хранилища клиентов или автоматическую защиту любого будущего запроса. Каждая новая сущность — заказ, файл, разговор, подписка — должна получить ту же явную область и проверку доступа.