Перейти к содержанию
32 минут чтения
Тема: Практика Telegram Business · Bot API · Поддержка · PHP

Как подключить бота к бизнес-аккаунту Telegram и отвечать клиентам

Для примера подключим бота к рабочему аккаунту компании. На сообщение «Часы работы» он ответит от имени этого аккаунта. По слову «оператор» и после ручного ответа сотрудника автоматические ответы в диалоге остановятся. Разберём подключение, актуальные права, входящие обновления и безопасное возвращение автоматизации.

Что подключаем и какие права нужны

Бизнес-бот обрабатывает разрешённые владельцем диалоги его аккаунта. Это отличается от обычного общения клиента с @ботом: сообщение отправляется от имени подключённого аккаунта с business_connection_id. Одного chat_id недостаточно — тот же числовой ID в обычном боте и в бизнес-подключении относится к разным контекстам.

В актуальной документации настройка BotFather называется Secretary Mode. Включите её для бота, затем в клиенте Telegram подключите этого бота к рабочему аккаунту через раздел управления подключёнными ботами/бизнес-функциями. Названия пунктов могут отличаться в клиентах; нужный результат — разрешённые чаты и BusinessConnection с is_enabled=true. Сначала ограничьте доступ одним тестовым диалогом.

  • Для отправки нужен rights.can_reply в текущем подключении.

  • Отправка и редактирование ограничены подходящими личными чатами со входящими сообщениями за последние 24 часа.

  • can_read_messages относится к отметке прочтения; простое получение business_message не заменяет и не требует вызов readBusinessMessage.

  • Права на удаление переписки, подарки, Stars и изменение профиля для нашего FAQ-ответа не нужны.

Владелец выбирает доступные чаты и может отключить бота. Не обещайте доступ ко всей прошлой переписке или возможность первым писать любому пользователю. Итоговую допустимость конкретной отправки определяет Telegram даже после нашей предварительной проверки.

Создадим приложение и таблицы

Для примера нужны PHP 8.3+ на 64-битной системе, cURL, PDO SQLite и mbstring. Один бот использует одну SQLite-базу на локальном диске. Публичный корень сайта — только public/; common.php, telegram.php, runtime.php, bot.php, worker.php, init.php и schema.sql находятся уровнем выше. Создайте закрытую папку private с правом записи для приложения. Обычный PHP не читает .env автоматически: задайте переменные окружения и для PHP-FPM, и для CLI.

Окружение процесса · пример
BOT_TOKEN=TOKEN_FROM_BOTFATHER
BOT_DB_PATH=/srv/demo/private/bot.sqlite
WEBHOOK_SECRET=RANDOM_SECRET_FROM_PASSWORD_MANAGER
WEBHOOK_URL=https://example.com/webhook.php
SQL · schema.sql
CREATE TABLE inbox (
    seq INTEGER PRIMARY KEY, update_id INTEGER NOT NULL UNIQUE,
    payload TEXT NOT NULL, state TEXT NOT NULL DEFAULT 'pending', received_at INTEGER NOT NULL
);
CREATE TABLE actions (
    action_key TEXT PRIMARY KEY, method TEXT NOT NULL,
    state TEXT NOT NULL, result TEXT, created_at INTEGER NOT NULL
);

CREATE TABLE connections (
    id TEXT PRIMARY KEY, owner_id INTEGER NOT NULL, enabled INTEGER NOT NULL,
    can_reply INTEGER NOT NULL, checked_at INTEGER NOT NULL
);
CREATE TABLE conversations (
    connection_id TEXT NOT NULL, chat_id INTEGER NOT NULL,
    mode TEXT NOT NULL DEFAULT 'auto', last_incoming INTEGER,
    PRIMARY KEY(connection_id,chat_id)
);
CREATE TABLE business_log (
    id INTEGER PRIMARY KEY, connection_id TEXT NOT NULL, chat_id INTEGER,
    message_id INTEGER, event TEXT NOT NULL, created_at INTEGER NOT NULL
);
PHP · common.php
<?php
declare(strict_types=1);

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

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

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

/** @return array<string, int|string|null>|null */
function row(PDOStatement $statement): ?array
{
    $result = $statement->fetch(PDO::FETCH_ASSOC);
    if ($result === false) {
        return null;
    }
    if (!is_array($result)) {
        throw new RuntimeException('Invalid database row');
    }
    foreach ($result as $key => $value) {
        if (!is_string($key) || !(is_int($value) || is_string($value) || $value === null)) {
            throw new RuntimeException('Invalid database field');
        }
    }
    return $result;
}

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

/** @return array<string, mixed> */
function jsonBody(): array
{
    $raw = file_get_contents('php://input', length: 65537);
    if ($raw === false || strlen($raw) > 65536) {
        throw new InvalidArgumentException('Request too large');
    }
    $data = json_decode($raw, true, 32, JSON_THROW_ON_ERROR);
    if (!is_array($data) || array_is_list($data)) {
        throw new InvalidArgumentException('Expected JSON object');
    }
    $result = [];
    foreach ($data as $key => $value) {
        if (!is_string($key)) {
            throw new InvalidArgumentException('Invalid JSON key');
        }
        $result[$key] = $value;
    }
    return $result;
}

/** @param array<string, mixed> $data */
function reply(array $data, int $status = 200): never
{
    http_response_code($status);
    header('Content-Type: application/json; charset=utf-8');
    header('Cache-Control: no-store');
    echo json_encode($data, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
    exit;
}
PHP · init.php
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
if (PHP_SAPI !== 'cli') {
    exit(1);
}
$path = setting('BOT_DB_PATH');
if (file_exists($path)) {
    throw new RuntimeException('Database already exists');
}
$schema = file_get_contents(__DIR__.'/schema.sql');
if ($schema === false) {
    throw new RuntimeException('Missing schema.sql');
}
$db = new PDO('sqlite:'.$path, options: [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('PRAGMA foreign_keys=ON');
$db->exec($schema);
echo "Database created\n";

connections хранит последнее проверенное состояние подключения. conversations задаёт режим auto/human для пары connection_id + chat_id. Один клиент может писать двум сотрудникам, поэтому ключ только по chat_id смешал бы независимые разговоры. Журнал сохраняет техническое событие и идентификаторы, а не полный текст клиентского сообщения.

Обработаем подключение и сообщения

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

/** @return array{id:string,owner:int,enabled:bool,reply:bool} */
function connection(PDO $db, string $id): array
{
    $data = apiObject('getBusinessConnection', ['business_connection_id' => $id]);
    $user = $data['user'] ?? null;
    $rights = $data['rights'] ?? null;
    if (($data['id'] ?? null) !== $id || !is_array($user) || !is_int($user['id'] ?? null)) {
        throw new RuntimeException('Invalid business connection');
    }
    $value = ['id' => $id, 'owner' => $user['id'], 'enabled' => ($data['is_enabled'] ?? false) === true,
        'reply' => is_array($rights) && ($rights['can_reply'] ?? false) === true];
    sql($db, 'INSERT INTO connections VALUES(?,?,?,?,?) ON CONFLICT(id) DO UPDATE SET
        owner_id=excluded.owner_id,enabled=excluded.enabled,can_reply=excluded.can_reply,checked_at=excluded.checked_at',
        [$id, $value['owner'], (int) $value['enabled'], (int) $value['reply'], time()]);
    return $value;
}

function businessLog(PDO $db, string $id, ?int $chat, ?int $message, string $event): void
{
    sql($db, 'INSERT INTO business_log(connection_id,chat_id,message_id,event,created_at) VALUES(?,?,?,?,?)',
        [$id, $chat, $message, $event, time()]);
}

/** @param array<string,mixed> $update */
function handleUpdate(PDO $db, array $update): void
{
    if (!is_int($update['update_id'] ?? null)) {
        return;
    }
    $changed = $update['business_connection'] ?? null;
    if (is_array($changed) && is_string($changed['id'] ?? null)) {
        connection($db, $changed['id']); // Fetch current state; queued events may be old.
        businessLog($db, $changed['id'], null, null, 'connection_checked');
        return;
    }
    $private = $update['message'] ?? null;
    if (is_array($private) && is_array($private['chat'] ?? null) && is_array($private['from'] ?? null)
        && ($private['chat']['type'] ?? '') === 'private' && is_int($private['from']['id'] ?? null)
        && ($private['chat']['id'] ?? null) === $private['from']['id'] && is_string($private['text'] ?? null)
        && preg_match('/^\/(pause|resume) (\S{1,200}) ([0-9]{1,16})$/D', $private['text'], $parts)) {
        $current = connection($db, $parts[2]);
        if ($current['owner'] !== $private['from']['id']) {
            return;
        }
        $mode = $parts[1] === 'pause' ? 'human' : 'auto';
        sql($db, 'INSERT INTO conversations(connection_id,chat_id,mode) VALUES(?,?,?)
            ON CONFLICT(connection_id,chat_id) DO UPDATE SET mode=excluded.mode', [$parts[2], (int) $parts[3], $mode]);
        businessLog($db, $parts[2], (int) $parts[3], null, 'owner_'.$mode);
        telegramOnce($db, 'control:'.$update['update_id'], 'sendMessage', [
            'chat_id' => $current['owner'], 'text' => 'Режим диалога: '.$mode]);
        return;
    }
    $deleted = $update['deleted_business_messages'] ?? null;
    if (is_array($deleted) && is_string($deleted['business_connection_id'] ?? null)
        && is_array($deleted['chat'] ?? null) && is_int($deleted['chat']['id'] ?? null)) {
        businessLog($db, $deleted['business_connection_id'], $deleted['chat']['id'], null, 'messages_deleted');
        return;
    }
    $edited = isset($update['edited_business_message']);
    $message = $update[$edited ? 'edited_business_message' : 'business_message'] ?? null;
    if (!is_array($message) || !is_string($message['business_connection_id'] ?? null)
        || !is_array($message['chat'] ?? null) || ($message['chat']['type'] ?? '') !== 'private'
        || !is_int($message['chat']['id'] ?? null) || !is_int($message['message_id'] ?? null)
        || !is_array($message['from'] ?? null) || !is_int($message['from']['id'] ?? null)) {
        return;
    }
    $id = $message['business_connection_id']; $chat = $message['chat']['id'];
    $current = connection($db, $id);
    sql($db, 'INSERT INTO conversations(connection_id,chat_id) VALUES(?,?) ON CONFLICT DO NOTHING', [$id, $chat]);
    if (isset($message['sender_business_bot'])) {
        return; // Never answer our own automated outgoing messages.
    }
    if ($message['from']['id'] === $current['owner']) {
        sql($db, "UPDATE conversations SET mode='human' WHERE connection_id=? AND chat_id=?", [$id, $chat]);
        businessLog($db, $id, $chat, $message['message_id'], 'human_reply');
        return;
    }
    if ($edited || !is_int($message['date'] ?? null) || $message['from']['id'] !== $chat) {
        businessLog($db, $id, $chat, $message['message_id'], 'edited_no_reply');
        return;
    }
    sql($db, 'UPDATE conversations SET last_incoming=MAX(COALESCE(last_incoming,0),?) WHERE connection_id=? AND chat_id=?',
        [$message['date'], $id, $chat]);
    $text = is_string($message['text'] ?? null) ? mb_strtolower(trim($message['text'])) : '';
    if ($text === 'оператор') {
        sql($db, "UPDATE conversations SET mode='human' WHERE connection_id=? AND chat_id=?", [$id, $chat]);
        businessLog($db, $id, $chat, $message['message_id'], 'handoff_requested');
        return; // The owner sees the request in the original Telegram conversation.
    }
    $conversation = row(sql($db, 'SELECT mode FROM conversations WHERE connection_id=? AND chat_id=?', [$id, $chat]));
    if (!$current['enabled'] || !$current['reply'] || ($conversation['mode'] ?? null) !== 'auto'
        || $message['date'] < time() - 300 || $message['date'] > time() + 30 || $text !== 'часы работы') {
        return;
    }
    $result = telegramOnce($db, 'business:'.$id.':'.$chat.':'.$message['message_id'], 'sendMessage', [
        'business_connection_id' => $id, 'chat_id' => $chat,
        'text' => 'Работаем по будням с 10:00 до 19:00, время московское. Для сотрудника напишите «оператор».',
    ]);
    businessLog($db, $id, $chat, $message['message_id'], 'reply_'.$result['state']);
}

Событие business_connection сообщает о создании, изменении или отключении подключения. Перед использованием код запрашивает getBusinessConnection и сохраняет актуальные права. Это помогает при задержке очереди: старое событие не должно снова включить давно отключённую связь. Если проверка недоступна, автоматический ответ не отправляется.

Для business_message сначала отделяем сообщения бота и владельца аккаунта от входящих сообщений клиента. sender_business_bot предотвращает цикл ответов на собственные сообщения. Ручной ответ владельца переводит диалог в human; обычное входящее сообщение не возвращает его в auto.

edited_business_message и deleted_business_messages здесь попадают в журнал без повторного FAQ-ответа. Если строите полноценную CRM-копию переписки, обновляйте и удаляйте сохранённые сообщения по составному ключу подключения, чата и message_id. Не считайте редактуру новым обращением и не используйте message_id как глобально уникальное значение.

В примере автоматизация отвечает только на точную фразу «Часы работы», без анализа произвольной переписки. Даже для разрешённого Telegram окна в 24 часа мы выбрали более короткий предел свежести — пять минут: поздний ответ на вчерашний вопрос часто уже не нужен. Этот предел относится к нашей бизнес-логике, а не к Bot API.

Подключим API и надёжно примем обновление

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

/**
 * @param array<string, mixed> $params
 * @return array{state: string, result?: mixed, code?: int, retry_after?: int}
 */
function telegram(string $method, array $params, bool $multipart = false): array
{
    $curl = curl_init('https://api.telegram.org/bot'.setting('BOT_TOKEN').'/'.$method);
    curl_setopt_array($curl, [
        CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 3, CURLOPT_TIMEOUT => 8,
        CURLOPT_POSTFIELDS => $multipart ? $params : json_encode($params, JSON_THROW_ON_ERROR),
        CURLOPT_HTTPHEADER => $multipart ? [] : ['Content-Type: application/json'],
    ]);
    $raw = curl_exec($curl);
    $status = (int) curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
    if (!is_string($raw) || $status >= 500) {
        return ['state' => 'unknown'];
    }
    $data = json_decode($raw, true);
    if (!is_array($data)) {
        return ['state' => 'unknown'];
    }
    if (($data['ok'] ?? null) === true) {
        return ['state' => 'ok', 'result' => $data['result'] ?? null];
    }
    if (($data['ok'] ?? null) !== false || !is_int($data['error_code'] ?? null)) {
        return ['state' => 'unknown'];
    }
    $parameters = $data['parameters'] ?? null;
    $delay = is_array($parameters) ? ($parameters['retry_after'] ?? null) : null;
    return ['state' => 'rejected', 'code' => $data['error_code'],
        'retry_after' => is_int($delay) && $delay > 0 ? $delay : 60];
}

/** @return array<string, mixed> */
function incomingUpdate(): array
{
    $secret = $_SERVER['HTTP_X_TELEGRAM_BOT_API_SECRET_TOKEN'] ?? '';
    if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST' || !is_string($secret)
        || !hash_equals(setting('WEBHOOK_SECRET'), $secret)) {
        reply(['error' => 'Forbidden'], 403);
    }
    return jsonBody();
}
PHP · runtime.php
<?php
declare(strict_types=1);

/**
 * @param array<string,mixed> $params
 * @return array<string,mixed>
 */
function apiObject(string $method, array $params): array
{
    $answer = telegram($method, $params);
    $object = $answer['result'] ?? null;
    if ($answer['state'] !== 'ok' || !is_array($object)) {
        throw new RuntimeException('Telegram check failed: '.$method);
    }
    $result = [];
    foreach ($object as $key => $value) {
        if (!is_string($key)) {
            throw new RuntimeException('Invalid API object');
        }
        $result[$key] = $value;
    }
    return $result;
}

/**
 * @param array<string,mixed> $params
 * @return array{state:string,result?:mixed}
 */
function telegramOnce(PDO $db, string $key, string $method, array $params): array
{
    $inserted = sql($db, "INSERT INTO actions(action_key,method,state,created_at) VALUES(?,?,'sending',?)
        ON CONFLICT(action_key) DO NOTHING", [$key, $method, time()])->rowCount();
    if ($inserted === 0) {
        $old = row(sql($db, 'SELECT state,result FROM actions WHERE action_key=?', [$key]));
        return ['state' => (string) ($old['state'] ?? 'unknown'),
            'result' => json_decode((string) ($old['result'] ?? 'null'), true)];
    }
    $answer = telegram($method, $params);
    sql($db, 'UPDATE actions SET state=?,result=? WHERE action_key=?',
        [$answer['state'], json_encode($answer['result'] ?? null, JSON_THROW_ON_ERROR), $key]);
    return $answer;
}

/** @param array<string,mixed> $member */
function isAdmin(array $member): bool
{
    return in_array($member['status'] ?? '', ['creator', 'administrator'], true);
}
PHP · public/webhook.php
<?php
declare(strict_types=1);
require dirname(__DIR__).'/common.php';
require dirname(__DIR__).'/telegram.php';
$update = incomingUpdate();
if (!is_int($update['update_id'] ?? null)) {
    reply(['error' => 'Invalid update'], 422);
}
sql(database(), 'INSERT INTO inbox(update_id,payload,received_at) VALUES(?,?,?)
    ON CONFLICT(update_id) DO NOTHING',
    [$update['update_id'], json_encode($update, JSON_THROW_ON_ERROR), time()]);
reply(['ok' => true]);

Webhook сначала проверяет секретный заголовок Telegram и сохраняет update_id с исходными данными в inbox. Только после записи возвращается 200. Повтор update_id не создаёт вторую задачу. Это прямой webhook Telegram; проверка входящих сообщений BotGate имеет другой контракт.

telegramOnce фиксирует отдельную исходящую операцию по ключу. При повторном вызове возвращается записанный результат. Между внешним API и SQLite нет общей транзакции: при таймауте получается unknown, а при аварии процесса может остаться sending. Такие операции автоматически не повторяем. Эта небольшая реализация выбирает защиту от повторного действия ценой ручного восстановления неподтверждённых операций.

Ответ rejected также не повторяется автоматически, включая 429. В рабочей очереди можно добавить ограниченные повторы только подтверждённого отказа с учётом retry_after; не возвращайте все sending и unknown в pending. Подробности — в руководстве о дублях.

Запустим обработчик и проверим журнал

PHP · worker.php
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
require __DIR__.'/telegram.php';
require __DIR__.'/runtime.php';
require __DIR__.'/bot.php';
if (PHP_SAPI !== 'cli') {
    exit(1);
}
$lock = fopen(setting('BOT_DB_PATH').'.worker.lock', 'c');
if ($lock === false || !flock($lock, LOCK_EX | LOCK_NB)) {
    exit(0);
}
$db = database();
for ($i = 0; $i < 100; ++$i) {
    $entry = row(sql($db, "SELECT * FROM inbox WHERE state='pending' ORDER BY seq LIMIT 1"));
    if ($entry === null) {
        break;
    }
    sql($db, "UPDATE inbox SET state='processing' WHERE seq=?", [(int) $entry['seq']]);
    try {
        $update = json_decode((string) $entry['payload'], true, 32, JSON_THROW_ON_ERROR);
        if (!is_array($update)) {
            throw new RuntimeException('Invalid stored update');
        }
        handleUpdate($db, $update);
        sql($db, "UPDATE inbox SET state='done',payload='{}' WHERE seq=?", [(int) $entry['seq']]);
    } catch (Throwable) {
        sql($db, "UPDATE inbox SET state='failed' WHERE seq=?", [(int) $entry['seq']]);
        error_log('Update failed: '.(int) $entry['update_id']);
    }
}
flock($lock, LOCK_UN);
PHP · setup-webhook.php
<?php
declare(strict_types=1);
require __DIR__.'/common.php';
require __DIR__.'/telegram.php';
if (PHP_SAPI !== 'cli') exit(1);
$url = setting('WEBHOOK_URL');
if (!str_starts_with($url, 'https://')) throw new RuntimeException('HTTPS required');
$result = telegram('setWebhook', [
    'url' => $url, 'secret_token' => setting('WEBHOOK_SECRET'),
    'allowed_updates' => ['business_connection','business_message','edited_business_message','deleted_business_messages','message'],
]);
if ($result['state'] !== 'ok') throw new RuntimeException('Webhook not confirmed');
echo "Webhook configured\n";
Shell · запуск
php init.php
php setup-webhook.php
php worker.php

Во время разработки запускайте worker.php после тестового сообщения. На сервере настройте его регулярный запуск, например раз в минуту; для ответов без минутной задержки используйте управляемый постоянно работающий процесс. Один проход ограничен 100 обновлениями. Файловая блокировка не даёт двум worker обрабатывать события параллельно; все процессы должны видеть один локальный файл базы и блокировки.

SQL · состояние обработки
SELECT update_id,state,received_at FROM inbox WHERE state <> 'done';
SELECT action_key,method,state,created_at FROM actions ORDER BY created_at DESC LIMIT 20;

После успешной обработки тело update удаляется из inbox, идентификатор остаётся для защиты от повтора. failed и processing требуют разбора; в них ещё могут быть данные переписки. Ограничьте доступ, установите срок хранения и очистку после расследования. Ответ 200 webhook подтверждает приём, а не успешную отправку или изменение прав. Не запускайте эти примеры на клиентском боте до проверки в отдельном тестовом окружении.

Передадим диалог сотруднику

Слово «оператор» ставит режим human; сотрудник видит запрос прямо в исходном диалоге своего аккаунта. Бот не обещает точное время ответа и не продолжает FAQ. После ответа сотрудника режим также остаётся human, пока владелец явно не вернёт автоматизацию.

Команды · владелец отправляет в личный чат с ботом
/pause BUSINESS_CONNECTION_ID CUSTOMER_CHAT_ID
/resume BUSINESS_CONNECTION_ID CUSTOMER_CHAT_ID

Замените значения на ID из своей таблицы conversations. В коде команды принимает только владелец соответствующего BusinessConnection: пользователь не получает права управлять чужим аккаунтом, просто узнав ID. Для удобства эти команды можно заменить кнопками закрытого кабинета с той же проверкой владельца.

После resume бот не отвечает на старые сообщения; новое входящее событие снова может вызвать FAQ. Встроенное управление ботом в интерфейсе Telegram остаётся основным способом немедленно прекратить его работу в чате. Наш режим human — дополнительное правило приложения, а не замена настройкам Telegram.

Важна граница гонки: сотрудник может начать писать, когда HTTP-запрос автоматического ответа уже ушёл. Проверка состояния перед отправкой не умеет отзывать такой запрос. Для чувствительных диалогов сотрудник сначала ставит паузу и ждёт подтверждения, затем отвечает; при больших очередях нужен отдельный приоритет для команд паузы.

Проверим права, повторы и отключение

  • Подключите отдельный тестовый аккаунт и убедитесь, что в connections записан именно его owner_id.

  • Из разрешённого клиентского диалога отправьте «Часы работы». Ответ должен появиться от имени подключённого аккаунта.

  • Отправьте тот же update повторно в тестовом обработчике: должна остаться одна исходящая операция.

  • Снимите can_reply или отключите подключение, затем пришлите новое сообщение: ответ не отправляется.

  • Напишите «оператор», затем «Часы работы»: второго автоматического ответа быть не должно.

  • Владелец вручную отвечает клиенту: режим становится human. Команда resume другого пользователя ничего не меняет.

  • Проверьте редактирование, удаление и исходящий ответ бота: они не запускают повторный FAQ.

  • Подставьте старое сообщение в тестовую очередь: оно не должно получить запоздалый ответ.

В журнале reply_ok означает подтверждённый ответ метода отправки. reply_unknown — неизвестный результат; проверьте диалог в Telegram перед ручным повтором. Для rejected выясните, изменились ли права или срок ответа. Не заменяйте business_connection_id обычным chat_id, пытаясь обойти отказ: это уже другой контекст сообщения.

Если используется BotGate

При переходе на BotGate сохраняйте business_connection_id в параметрах исходящего метода и в своём ключе диалога. Проверьте получение нужных типов обновлений и подпись webhook по документации. Сам режим auto/human, актуальность прав и журнал действий остаются в приложении; транспорт не принимает решение о передаче разговора сотруднику.

Источники: Business Bots, BusinessConnection, BusinessBotRights, getBusinessConnection. Для поддержки от имени обычного бота есть сценарий с группой операторов.