Перейти к содержанию
35 минут чтения
Тема: Практика Laravel · Telegram · Несколько ботов

Как обслуживать несколько Telegram-ботов в одном приложении Laravel

Для примера агентство обслуживает два филиала: у каждого свой Telegram-бот, название и переписка с клиентами, а Laravel-приложение одно. При /start приложение должно выбрать правильного бота, сохранить контакт в его области данных и ответить через его очередь. Построим минимальный работающий контур без глобального переключения токена.

Определите границу данных

В приложении есть внутренний 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 не требуется. Команды ниже создают отдельное учебное приложение. Для проверки используйте два своих тестовых бота и отдельную БД.

Bash · новое учебное приложение
composer create-project laravel/laravel multi-bot "^13.0"
cd multi-bot
ENV · настройки учебного приложения
APP_URL=https://bots.example.com
APP_DEBUG=false
QUEUE_CONNECTION=database
CACHE_STORE=database

Сохраните штатный APP_KEY нового приложения; для уже существующего проекта его не перевыпускают. Crypt использует этот ключ для токенов. Выберите БД и проверьте наличие стандартных миграций jobs, failed_jobs и cache. Миграция ниже добавляет только таблицы сценария; не создавайте вторые таблицы очереди с теми же именами.

PHP · database/migrations/2026_11_19_000001_create_tenant_bot_tables.php
<?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 · app/GuideBots/BotRecord.php
<?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 · app/Console/Commands/AddTenantBot.php
<?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 · app/Console/Commands/ConfigureBotWebhook.php
<?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 · app/GuideBots/BotWebhook.php
<?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 · routes/api.php
<?php
use App\GuideBots\BotWebhook;
use Illuminate\Support\Facades\Route;
Route::post('/telegram/{key}',BotWebhook::class)->where('key','[a-f0-9]{32}');
PHP · дополнение существующего withRouting в bootstrap/app.php
->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 · app/GuideBots/ProcessBotUpdate.php
<?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 · app/GuideBots/BotTransport.php
<?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 · app/GuideBots/SendBotMessage.php
<?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 · app/Console/Commands/DrainBots.php
<?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;
    }
}
Два бота используют разные секреты, bot_id и очереди, даже когда update_id и chat_id совпадают.
Два бота используют разные секреты, bot_id и очереди, даже когда update_id и chat_id совпадают.
Архитектурная схема учебного примера. Очереди обрабатываются отдельными процессами; общая БД и инфраструктура не означают физическую изоляцию клиентов.
PHP · добавить в routes/console.php
use Illuminate\Support\Facades\Schedule;
Schedule::command('bots:drain')->everyMinute()->withoutOverlapping();

Команда берёт ограниченное число входящих и исходящих операций каждого активного бота. Возможные повторные dispatch допустимы: бизнес-уникальность обеспечивают БД и проверка состояния, а не надежда на одну копию job. Нужен постоянно работающий Scheduler; withoutOverlapping требует подходящего cache backend, общего для нескольких серверов.

Bash · четыре отдельных процесса для ботов с внутренними ID 1 и 2
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 все состояния без фильтра.

Проверьте два бота на одном пользователе

Bash · настройка учебной установки
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. Токен одного не должен попадать в запрос другого.

SQL · проверить разделение
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-процесс приложения и изоляцию операций по боту. Он не обещает физическую изоляцию хранилища клиентов или автоматическую защиту любого будущего запроса. Каждая новая сущность — заказ, файл, разговор, подписка — должна получить ту же явную область и проверку доступа.