Отправка сообщений в телеграм на PHP с использованием бота при создании обращения в модуле технической поддержки битрикс24 по событию onBeforeTicketAdd

Эта статья так же подойдёт для тех кому не требуется использовать функционал битрикс, а просто требуется с использованием PHP отправлять сообщения в телеграм через бота.

Ниже приведено содержание массива, который может быть получен обработчиком события(срабатывает перед созданием обращения в модуле технической поддержки битрикс24). В файле этот массив при открытии отображался в одну строку, отступы и переносы строк в листинге ниже я расставил сам и не в том виде в котором возвращает var_dump, возможно такой вариант вывода информации о массиве тоже имеет смысл реализовать.

Получить массив приведённый выше можно например разместив в файле код из следующего листинга.

Массив же приведённый ниже можно получить при использовании события (после создания обращения).

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

Для обработки события после добавления нового обращения в модуле технической поддержки и отправки соответствующего сообщения в телеграм можно в файле /bitrix/php_interface/init.php разместить код приведённый в листинге ниже. Используется именно событие onAfterTicketAdd(после добавления обращения), а не OnBeforeTicketAdd(до добавления обращение) поскольку второе ещё не содержит ID(идентификатора обращения), поскольку в первом событии возможно подавить создание обращения таким образом до конца выполнения обработчика события обращение в системе ещё не зарегистрировано и Id у него ещё нет, а ID обращения используется в отправляемом в телеграм сообщении, поэтому используется именно обработчик события onAfterTicketAdd.

<?php
use Bitrix\Main\EventManager;
      
$eventManager = EventManager::getInstance();//Объект менеджера регистрации событий
      
$eventManager->addEventHandler('support', 'onAfterTicketAdd', function (&$ticket) {//Отправка сообщения в телеграм после добавления нового обращения в модуле технической поддержки
  require '/home/bitrix/www/nikolaevevge/lib/telegrambot/vendor/autoload.php';//Подключение библиотеки для взаимодействия с ботом телеграм
      
  //use Telegram\Bot\Api;//Так в этом месте сделать не получится, поэтому ниже обращение к классу идёт с учётом NameSpace
      
  $telegram = new \Telegram\Bot\Api('YourAPITelegramBotKey');//Установка API-ключа бота
      
  $response = $telegram->sendMessage([
    "chat_id" => "-123XXXXXXX",//Идентификатор чата(число), для групп начинается с минус(-), id моего личного аккаунта 6060711637
    "text" => "Создано обращение. Название: " . $ticket["TITLE"] . " Описание: " . $ticket["MESSAGE"] . " Идентификатор: " . $ticket["ID"] . " Ссылка: https://domen/bitrix/admin/ticket_edit.php?ID=" . $ticket["ID"] . "&lang=ru"//Вместо domen можно было подставить информацию из массива $_SERVER ну мало ли по какой то причине домен у отправителя обращения и получателя отличается
  ]);
});

Касаемо библиотеки для взаимодействия с телеграм ботом на PHP обычно её устанавливают с использованием composer следующей командой: composer require irazasyed/telegram-bot-sdk, при этом если у Вас composer не установлен и более того если Вам предпочтительнее воспользоваться библиотекой без использования composer, Вы можете скачать ZIP-архив с всеми файлами данной библиотеки и распаковать на Вашем сервере, папка будет включать все необходимые зависимости, работоспособность проверена на сервере без composer и с версией PHP 8.2, вот ссылка на файл: telegramBotPHPLib.zip.

Комментарии