ערוץ התראות הזמנות בטלגרם לצוות ביטריקס

// /local/lib/Telegram/ChannelBot.php
namespace Local\Telegram;

use Bitrix\Main\Config\Configuration;

class ChannelBot
{
    private static function getConfig(): array
    {
        return Configuration::getValue('telegram_channel') ?? [];
    }

    public static function post(string $text, array $options = []): ?array
    {
        $config = self::getConfig();
        $token = $config['bot_token'] ?? '';
        $chatId = $config['channel_id'] ?? ''; // например: -1001234567890

        if (!$token || !$chatId) {
            return null;
        }

        $payload = array_merge([
            'chat_id' => $chatId,
            'text' => $text,
            'parse_mode' => 'HTML',
            'disable_web_page_preview' => true,
        ], $options);

        $ch = curl_init('https://api.telegram.org/bot' . $token . '/sendMessage');
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => json_encode($payload),
            CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 5,
        ]);

        $raw = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        if ($httpCode !== 200) {
            \Bitrix\Main\Diag\Debug::writeToFile(
                "Telegram channel error {$httpCode}: {$raw}",
                '',
                '/local/logs/telegram.log'
            );
            return null;
        }

        return json_decode($raw, true);
    }

    public static function postPhoto(string $photoUrl, string $caption = ''): ?array
    {
        $config = self::getConfig();
        return self::callApi('sendPhoto', [
            'chat_id' => $config['channel_id'],
            'photo' => $photoUrl,
            'caption' => $caption,
            'parse_mode' => 'HTML',
        ]);
    }

    private static function callApi(string $method, array $payload): ?array
    {
        $config = self::getConfig();
        $ch = curl_init('https://api.telegram.org/bot' . $config['bot_token'] . '/' . $method);
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => json_encode($payload),
            CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 5,
        ]);

        $raw = curl_exec($ch);
        curl_close($ch);

        return json_decode($raw, true);
    }
}

תצורה ב-[Событие в Битрикс] → [Обработчик события] → [Форматирование сообщения] ↓ [Telegram Bot API: sendMessage / sendPhoto] ↓ [Канал / Группа команды] :

'telegram_channel' => [ 'value' => [ 'bot_token' => '7654321:AAbcdef...', 'channel_id' => '-1001234567890', ], ], 

channel_id לערוץ מתחיל ב--100. ניתן לקבל אותו על ידי העברת הודעה מהערוץ ל-@userinfobot.

איך להגדיר שליחת התראות ל-Telegram

1. צור בוט דרך BotFather: שלח class OrderNotificationFormatter { public static function newOrder(\Bitrix\Sale\Order $order): string { $basket = $order->getBasket(); $props = $order->getPropertyCollection(); $name = $props->getPayerName()?->getValue() ?? 'Не указано'; $phone = $props->getPhone()?->getValue() ?? '—'; $email = $props->getUserEmail()?->getValue() ?? '—'; $itemLines = []; foreach ($basket as $item) { $itemLines[] = sprintf( ' • %s × %d = %s руб.', htmlspecialchars($item->getField('NAME')), (int)$item->getQuantity(), number_format($item->getFinalPrice(), 0, '.', ' ') ); } $deliveryName = $order->getDeliverySystemName() ?? 'Не выбрана'; $paySystemName = $order->getPaySystemName() ?? 'Не выбрана'; return sprintf( "🛒 <b>Новый заказ #%d</b>\n\n" . "👤 %s\n" . "📞 %s\n" . "✉️ %s\n\n" . "<b>Состав:</b>\n%s\n\n" . "💰 <b>Итого: %s руб.</b>\n" . "🚚 %s\n" . "💳 %s\n\n" . "<a href=\"https://%s/bitrix/admin/sale_order_detail.php?ID=%d\">Открыть в админке</a>", $order->getId(), htmlspecialchars($name), htmlspecialchars($phone), htmlspecialchars($email), implode("\n", $itemLines), number_format($order->getPrice(), 0, '.', ' '), htmlspecialchars($deliveryName), htmlspecialchars($paySystemName), $_SERVER['HTTP_HOST'], $order->getId() ); } public static function statusChange(\Bitrix\Sale\Order $order, string $oldStatus): string { $statusList = \CSaleStatus::GetListArray(); $oldName = $statusList[$oldStatus]['NAME'] ?? $oldStatus; $newName = $statusList[$order->getField('STATUS_ID')]['NAME'] ?? $order->getField('STATUS_ID'); return sprintf( "🔄 <b>Заказ #%d</b>: %s → <b>%s</b>", $order->getId(), htmlspecialchars($oldName), htmlspecialchars($newName) ); } public static function lowStock(int $productId, string $productName, float $quantity): string { return sprintf( "⚠️ <b>Мало товара:</b> %s\nОстаток: %s шт.\nID: %d", htmlspecialchars($productName), number_format($quantity, 0), $productId ); } } , קבל את הטוקן.
2. צור ערוץ או סופרגרופ ב-Telegram.
3. הוסף את הבוט כמנהל (עם זכות פרסום הודעות).
4. העבר כל הודעה מהערוץ ל-@userinfobot — תקבל את ה-channel_id (מתחיל ב--100).
5. כתוב את הטוקן וה-channel_id לתוך // /local/php_interface/init.php use Local\Telegram\ChannelBot; use Local\Telegram\OrderNotificationFormatter; $em = \Bitrix\Main\EventManager::getInstance(); // Новый заказ $em->addEventHandler('sale', 'OnSaleOrderSaved', function (\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); if (!$order->isNew()) { return; } $message = OrderNotificationFormatter::newOrder($order); ChannelBot::post($message); }); // Смена статуса $em->addEventHandler('sale', 'OnSaleOrderStatusChange', function (\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); $oldStatus = $event->getParameter('OLD_STATUS'); $message = OrderNotificationFormatter::statusChange($order, $oldStatus); ChannelBot::post($message); }); (כמו בדוגמה למעלה).
6. שים את קוד העיצוב ומטפל האירועים ב-// /local/lib/Telegram/ChannelBot.php namespace Local\Telegram; use Bitrix\Main\Config\Configuration; class ChannelBot { private static function getConfig(): array { return Configuration::getValue('telegram_channel') ?? []; } public static function post(string $text, array $options = []): ?array { $config = self::getConfig(); $token = $config['bot_token'] ?? ''; $chatId = $config['channel_id'] ?? ''; // например: -1001234567890 if (!$token || !$chatId) { return null; } $payload = array_merge([ 'chat_id' => $chatId, 'text' => $text, 'parse_mode' => 'HTML', 'disable_web_page_preview' => true, ], $options); $ch = curl_init('https://api.telegram.org/bot' . $token . '/sendMessage'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($payload), CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 5, ]); $raw = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode !== 200) { \Bitrix\Main\Diag\Debug::writeToFile( "Telegram channel error {$httpCode}: {$raw}", '', '/local/logs/telegram.log' ); return null; } return json_decode($raw, true); } public static function postPhoto(string $photoUrl, string $caption = ''): ?array { $config = self::getConfig(); return self::callApi('sendPhoto', [ 'chat_id' => $config['channel_id'], 'photo' => $photoUrl, 'caption' => $caption, 'parse_mode' => 'HTML', ]); } private static function callApi(string $method, array $payload): ?array { $config = self::getConfig(); $ch = curl_init('https://api.telegram.org/bot' . $config['bot_token'] . '/' . $method); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($payload), CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 5, ]); $raw = curl_exec($ch); curl_close($ch); return json_decode($raw, true); } } או במודול נפרד.
7. בדוק שליחה: צור הזמנת בדיקה בפאנל הניהול.

אילו אירועים לשדר לערוץ הצוות התפעולי?

לוח זמנים לפיתוח

הניסיון והערבויות שלנו

אנו עובדים עם Bitrix למעלה מ-10 שנים וביצענו יותר מ-50 אינטגרציות עם Telegram. אנו מומחים מוסמכים "1C-Bitrix". אנו מבטיחים פעולה יציבה של ההתראות תחת כל עומס — עד 1000 הודעות ביום ללא עיכובים. אנו מספקים חבילת תיעוד מלאה וקוד מקור. למידע מפורט, עיין בתיעוד האירועים של Bitrix.

הזמן פיתוח במפתח מלא — אנו נגדיר את הבוט, העיצובים ומטפלי האירועים למשימות שלך. קבל ייעוץ על אינטגרציה של Telegram עם Bitrix. צור קשר כדי לדון בפרויקט שלך.