Создание чат-бота в портале Битрикс24 с помощью AI-агентов

• Пишем первое приложение с AI-стартером, чтобы видеть прибыли и убытки
  
• Добавляем в бизнес-портал Битрикс24 роботов для автоматизации
  
• Что даёт воспроизводимая среда разработки и как развернуть контейнеры на VPS.
  
• Анализ и модернизация коннектора баз данных с помощью AI-агентов

• Что нужно установить перед работой
  
• Что за боты и где они находятся
  
• Регистрируем приложение в портале
  
• Проверяем, что чат-бот появился в портале
  • Как работать с ошибками: смотреть логи и передавать их агенту
    
  • Ошибка 1: неверный формат install payload
    
  • Ошибка 2: не хватало прав приложения
    
  • Ошибка 3: записи в локальной базе данных
    
  • Ошибка 4: новый метод регистрации бота не работал на портале
    
  • Ошибка 5: разные состояния локальной базы данных и портала
    
  • PS Откуда в проекте фронтенд
• Учим чат-бота полезным функциям
  
• Запрос статуса задач
  
• Запрос во внешние API
  
• Что будем делать дальше
  
• Содержание цикла статей про создание приложений с AI-агентами

• Docker и Docker Compose для контейнеризации.
  
• Git для контроля версий и пуша в удалённый репозиторий.
  
• make для коротких команд.
  
• Публичный HTTPS-туннель через CloudPub. Получить можно через десктопный клиент или инструмент командной строки clo.

• Копируем и настраиваем проект — для чат-бота при выборе бэкенда на этапе настройки проекта нужно выбрать php.
  
• Регистрируем приложение на портале Битрикс24 — кроме этапа регистрации в портале, это разбираем отдельно ниже.

https://...cloudpub.ru/install

https://example.com/chatapi/bot.php

tail -f logs/php/symfony/dev.log

• tail показывает конец файла.
  
• -f означает «следить дальше в реальном времени», то есть команду можно запустить в одном терминале и просто копировать вывод терминала после каждой новой ошибки.
  
• logs/php/symfony/dev.log — файл, куда PHP/Symfony пишет dev-логи.

• Входящие запросы от портала Битрикс24.
  
• Какой Symfony route сработал.
  
• payload, который прислал портал.
  
• Наши debug-сообщения.
  
• Ошибки PHP/Symfony.
  
• Запросы нашего бэкенда к Битрикс24 REST API.
  
• Ответы портала на эти API-запросы.

DOMAIN
AUTH_ID
REFRESH_ID

auth.domain
auth.access_token
auth.refresh_token
auth.member_id

SCOPE='im,imbot,task,tasks_extended,imconnector'

insufficient_scope

duplicate key value violates unique constraint

ERROR_METHOD_NOT_FOUND
Method not found

imbot.register

#[Route('/api/app-events/', name: 'b24_events', methods: ['POST'])]:

Application installation not found

Если пришел ONAPPINSTALL:
  обязательно найди установку в базе
  если не нашел -- ошибка 500

Если пришел ONAPPINSTALL:
  попробуй финализировать установку в базе
  если записи нет -- запиши warning, но не падай
  продолжай обработку

• auth.access_token
  
• auth.domain
  
• auth.member_id
  
• data.VERSION

Если регистрация бота не завершилась в /api/install:
  попробуй зарегистрировать его при обработке ONAPPINSTALL в /api/app-events/.

AppLifecycleEventController.process.chatbotRegistered
method: imbot.register
result: ["14"]

#[Route('/api/chatbot/events', name: 'chatbot_events', methods: ['POST'])]
public function process(Request $request): JsonResponse
{
    // 1. Получаем событие от Битрикс24: сообщение, вход в чат и т.д.
    $payload = $this->getPayload($request);
    // 2. Нас интересуют только события чат-бота.
    if (!in_array($payload['event'] ?? '', ['ONIMBOTJOINCHAT', 'ONIMBOTMESSAGEADD'], true)) {
        return new JsonResponse(['status' => 'ignored'], 200);
    }
    // 3. Достаем текст сообщения пользователя.
    // 4. Определяем команду.
    // 5. Строим ответ.
    $reply = 'ONIMBOTJOINCHAT' === ($payload['event'] ?? '')
        ? $this->buildHelpReply()
        : $this->buildReply($this->extractUserMessage($payload), $payload);
    // 6. Отправляем ответ обратно в Битрикс24.
    $this->sendReply($payload, $reply);
    return new JsonResponse(['status' => 'ok'], 200);p

$tokens = $this->extractTokens($message);
$command = mb_strtolower($tokens[0] ?? '');
$arguments = array_slice($tokens, 1);
// Если команда /fx -- идем в валютный функционал.
if (in_array($command, ['/fx', 'fx', 'валюта', 'курс'], true)) {
    return $this->buildFxReply($arguments);
}
// Если команда /stock -- идем в функционал акций.
if (in_array($command, ['/stock', 'stock', 'акция', 'тикер'], true)) {
    return $this->buildStockReply($arguments);
}
// Если команда /market -- собираем акции + валюты.
if (in_array($command, ['/market', 'market', 'рынок', 'инвестиции'], true)) {
    return $this->buildMarketReply($arguments);
}
// Если команда /утро -- идем в Битрикс24 за задачами.
if (in_array($command, ['/morning', 'morning', '/утро', 'утро', 'дайджест'], true)) {
    return $this->buildMorningReply($payload);
}

if (in_array($command, ['/morning', 'morning', '/утро', 'утро', 'дайджест'], true)) {
    return $this->buildMorningReply($payload);
}

private function buildMorningReply(array $payload): string
{
    // Достаем из события Битрикс24 домен, access token и ID пользователя.
    $context = $this->extractBitrixContext($payload);
    // Передаем эти данные в сервис, который умеет читать задачи.
    return $this->taskDigestService->buildMorningDigest(
        $context['domain'],
        $context['accessToken'],
        $context['userId'],
    );
}

  private function extractBitrixContext(array $payload): array
   {
       $bots = (array) ($payload['data']['BOT'] ?? []);
       $botAuth = [] !== $bots ? reset($bots) : [];
       $botAuth = is_array($botAuth) ? $botAuth : [];
       $domain = (string) ($payload['auth']['domain'] ?? $botAuth['domain'] ?? '');
       $accessToken = (string) ($payload['auth']['access_token'] ?? $botAuth['access_token'] ?? '');
       $userId = (int) ($payload['data']['USER']['ID'] ?? $payload['auth']['user_id'] ?? 0);
       if ('' === $domain  '' === $accessToken  0 === $userId) {
           throw new \RuntimeException('Не хватает данных Битрикс24 для чтения задач.');
       }
       return [
           'domain' => $domain,
           'accessToken' => $accessToken,
           'userId' => $userId,
       ];
   }

public function buildMorningDigest(string $domain, string $accessToken, int $userId): string
{
    // Загружаем активные задачи пользователя из Битрикс24.
    $tasks = $this->loadActiveTasks($domain, $accessToken, $userId);
    // Готовим группы задач.
    $overdue = [];
    $todayTasks = [];
    $important = [];
    $withoutDeadline = [];
    $future = [];
    // Раскладываем задачи по категориям.
    foreach ($tasks as $task) {
        if ($this->isCompleted($task)) {
            continue;
        }
        if (($task['priority'] ?? '') === '2') {
            $important[] = $task;
        }
        $deadline = $this->parseDeadline($task['deadline'] ?? null);
        if (null === $deadline) {
            $withoutDeadline[] = $task;
            continue;
        }
        // Сравниваем дедлайн с сегодняшним днем.
    }
    // Собираем текст ответа.
    return implode("\n", $lines);
}

$this->httpClient->request('POST', sprintf('https://%s/rest/tasks.task.list', $domain), [
    'json' => [
        // Берем задачи, где текущий пользователь ответственный.
        'filter' => [
            'RESPONSIBLE_ID' => $userId,
            '!REAL_STATUS' => 5,
        ],
        // Запрашиваем только нужные поля.
        'select' => [
            'ID',
            'TITLE',
            'STATUS',
            'REAL_STATUS',
            'DEADLINE',
            'PRIORITY',
        ],
        // Токен Битрикс24 из входящего события бота.
        'auth' => $accessToken,
    ],
]);

// Валюты: /fx USD EUR
if (in_array($command, ['/fx', 'fx', 'валюта', 'курс'], true)) {
    return $this->buildFxReply($arguments);
}
// Акции: /stock AAPL MSFT
if (in_array($command, ['/stock', 'stock', 'акция', 'тикер'], true)) {
    return $this->buildStockReply($arguments);
}
// Общая сводка: /market AAPL MSFT USD EUR
if (in_array($command, ['/market', 'market', 'рынок', 'инвестиции'], true)) {
    return $this->buildMarketReply($arguments);
}Ъ

foreach (array_slice($arguments, 0, 5) as $symbol) {
    // Пропускаем валюты, оставляем только тикеры акций.
    if ($this->marketDataService->isCurrency($symbol)) {
        continue;
    }
    // Получаем котировку акции.
    $quotes[] = $this->marketDataService->getStockQuote($symbol);
}

foreach ($arguments as $argument) {
    // Если это валюта -- кладем в currencySymbols.
    if ($this->marketDataService->isCurrency($argument)) {
        $currencySymbols[] = $argument;
    // Если похоже на тикер -- кладем в stockSymbols.
    } elseif (preg_match('/^[A-Z]{1,6}(?:\.[A-Z]{1,4})?$/', $argument)) {
        $stockSymbols[] = $argument;
    }
}

$payload = $this->httpClient
    ->request('GET', 'https://api.frankfurter.app/latest', [
        'query' => [
            'from' => $base,
            'to' => $target,
        ],
    ])
    ->toArray();

ALPHA_VANTAGE_API_KEY='твой_ключ'

$apiKey = (string) ($_ENV['ALPHA_VANTAGE_API_KEY'] ?? $_SERVER['ALPHA_VANTAGE_API_KEY'] ?? '');
if ('' !== $apiKey) {
    return $this->getAlphaVantageQuote($symbol, $apiKey);
}
return $this->getStooqQuote($symbol);

'/market', 'market', 'рынок', 'инвестиции'

• Пишем первое приложение с AI-стартером, чтобы видеть прибыли и убытки
  
• Добавляем в бизнес-портал Битрикс24 роботов для автоматизации
  
• Что даёт воспроизводимая среда разработки и как развернуть контейнеры на VPS.
  
• Анализ и модернизация коннектора баз данных с помощью AI-агентов
  
• Создание чат-бота в портал Битрикс24 с помощью AI-агентов