Отправка битриксовых почтовых событий в Телеграм.

Author: ProklUng

install/version.php

@@ -1,6 +1,6 @@
 <?php
 
 $arModuleVersion = [
-    'VERSION' 		=> '1.0.6',
+    'VERSION' 		=> '1.1.0',
     'VERSION_DATE' 	=> '2021-07-28'
 ];

lib/Bitrix/BitrixTelegramEventSender.php

@@ -0,0 +1,118 @@
+<?php
+
+namespace Proklung\Notifier\Bitrix;
+
+use Bitrix\Main\ArgumentException;
+use Bitrix\Main\Mail\Internal\EventTable;
+use Bitrix\Main\ObjectPropertyException;
+use Bitrix\Main\SystemException;
+use Exception;
+use RuntimeException;
+use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
+use Symfony\Component\Notifier\Bridge\Telegram\TelegramTransport;
+use Symfony\Component\Notifier\ChatterInterface;
+use Symfony\Component\Notifier\Exception\TransportExceptionInterface;
+use Symfony\Component\Notifier\Message\ChatMessage;
+
+/**
+ * Class BitrixTelegramEventSender
+ * @package Proklung\Notifier\Bitrix
+ *
+ * @since 28.07.2021
+ */
+class BitrixTelegramEventSender
+{
+    /**
+     * @var EventBridge $eventBridge Обработка битриксовых данных события.
+     */
+    private $eventBridge;
+
+    /**
+     * @var ChatterInterface $notifier Notifier.
+     */
+    private $notifier;
+
+    /**
+     * BitrixChatEventSender constructor.
+     *
+     * @param EventBridge      $eventBridge Обработка битриксовых данных события.
+     * @param ChatterInterface $notifier    Notifier.
+     */
+    public function __construct(EventBridge $eventBridge, ChatterInterface $notifier)
+    {
+        $this->eventBridge = $eventBridge;
+        $this->notifier = $notifier;
+    }
+
+    /**
+     * Статический фасад.
+     *
+     * @param ChatterInterface $notifier Notifier.
+     *
+     * @return static
+     * @throws RuntimeException Когда пакет symfony/telegram-notifier не установлен.
+     */
+    public static function getInstance(ChatterInterface $notifier) : self
+    {
+        if (!class_exists(TelegramTransport::class)) {
+            throw new RuntimeException(
+                sprintf(
+                    'Unable to send notification via "%s" as the bridge is not installed; try running "composer require %s".',
+                    'telegram',
+                    'symfony/telegram-notifier'
+                )
+            );
+        }
+
+        return new static(new EventBridge(), $notifier);
+    }
+
+    /**
+     * Отправить сообщение.
+     *
+     * @param string $codeEvent Код события.
+     * @param array  $arFields  Параметры события.
+     *
+     * @return void
+     * @throws ArgumentException | ObjectPropertyException | SystemException Битриксовые ошибки.
+     * @throws TransportExceptionInterface                                   Ошибки транспорта.
+     */
+    public function send(string $codeEvent, array $arFields) : void
+    {
+        $eventsInfo = $this->eventBridge->getMessageTemplate($codeEvent);
+        foreach ($eventsInfo as $eventInfo) {
+            $compileData = $this->eventBridge->compileMessage($eventInfo, $arFields, ['s1']);
+
+            $notification = (new ChatMessage($compileData['subject'] . ' ' . $compileData['body']))
+                            ->transport('telegram');
+
+            $telegramOptions = (new TelegramOptions())
+                ->parseMode('Markdown')
+                ->disableWebPagePreview(true)
+                ->disableNotification(false);
+
+            $notification->options($telegramOptions);
+
+            $this->notifier->send($notification);
+
+            // Эмуляция поведения Битрикса при обработке событий.
+            try {
+                EventTable::add(
+                    [
+                        'EVENT_NAME' => $eventInfo->getEventCode(),
+                        'SUCCESS_EXEC' => 'Y',
+                        'MESSAGE_ID' => 99999, // Признак, что отправлено через Notifier
+                        'DUPLICATE' => 'N',
+                        'LID' => SITE_ID,
+                        'LANGUAGE_ID' => LANGUAGE_ID,
+                        'DATE_INSERT' => new \Bitrix\Main\Type\DateTime,
+                        'DATE_EXEC' => new \Bitrix\Main\Type\DateTime,
+                        'C_FIELDS' => $eventInfo->getMessageData(),
+                    ]
+                );
+            } catch (Exception $e) {
+                // Silence. Не самый важный момент.
+            }
+        }
+    }
+}

readme.MD

@@ -225,4 +225,26 @@ return [
 ```
 
 Ошибки отправки глушатся. Если что-то с доставкой SMS пойдет не так, то будет тихо, но в таблице `b_event`
-появится запись с признаком неудачи и текстом ошибки.
+появится запись с признаком неудачи и текстом ошибки.
+
+### Отправка битриксовых почтовых шаблонов в Телеграм
+
+```php
+        use Proklung\Notifier\Bitrix\BitrixTelegramEventSender;
+
+        $bitrixEventHandler = BitrixTelegramEventSender::getInstance(
+            \Proklung\Notifier\DI\Services::getInstance()->get('chatter')
+        );
+
+        $arFields = ['CODE' => '2222', 'LINK' => 'http://site.loc/'];
+
+        $bitrixEventHandler->send('TEST_EVENT', $arFields);
+```
+
+Должен быть установлен `symfony/telegram-notifier` и зарегистрирован транспорт `telegram` в секции `chatter_transports`
+файла `/bitrix/.settings.php`.
+
+Нюанс:
+
+- Telegram плохо переваривает html (даже в режиме `parse_mode = html`). Посему рекомендуется оформлять шаблоны 
+в `markdown` разметке.