Модуль позволяет отправлять оповещения в Telergam при определенных событиях на сайте.
Есть список стандартных событий для интернет-магазина, связанных с оформлением заказа. Но даже если у вас версия битрикса без магазина, вы можете использовать события, связанные с инфоблоками. Например, у вас есть инфоблок для сбора заявок с сайта. Вы можете при создании элемента в этом инфоблоке (по сути при новой заявке с сайта) отправлять оповещение в Telegram.
События:- Добавление / изменение элемента инфоблока;
- Новый заказ;
- Заказ оплачен;
- Изменение статуса заказа;
- Отмена заказа;
- Добавление / изменение результата заполнения веб-формы;
- Добавление комментария в блог;
- Регистрация пользователя.
Особенности:- Возможность отправлять оповещения нескольким получателям. Оповещать можно конкретных пользователей, или отправлять оповещения в чат.
- Для каждого события можно настроить своих получателей. Например, один менеджер отвечает за новые заказы, а другой за оплату заказов.
- В настройках шаблонов можно выбрать, на какой сайт действует шаблон. Можно выбрать все сайты, либо какой-то конкретный.
- Широкие возможности настройки шаблонов. Используется шаблонизатор Twig.
- В настройках модуля есть обширные инструкции по настройке шаблонов и примеры к ним.
- Возможность работы с модулем через внутреннее API. Можно отправлять любое текстовое сообщение из своего кода в нужный момент времени.
Технические ограничения:- Для работы с событиями заказов необходим стандартный модуль Sale.
- Для работы с событиями веб-форм необходим стандартный модуль Form.
- Для работы с событиями блога необходим стандартный модуль Blog.
- Для работы модуля необходим PHP >= 7.0, а также установленные PHP расширения curl, json, mbstring. Данные требования проверяются при установке.
- Модуль не работает при установленном PHP параметре mbstring.func_overload 2. Данное требование проверяются при установке.
Используемые события битрикса:- Добавление элемента инфоблока. Используется событие OnAfterIBlockElementAdd;
- Изменение элемента инфоблока. Используется событие OnAfterIBlockElementUpdate;
- Новый заказ. Используется событие OnSaleOrderSaved;
- Заказ оплачен. Используется событие OnSalePayOrder;
- Изменение статуса заказа. Используется событие OnSaleStatusOrder;
- Отмена заказа. Используется событие OnSaleCancelOrder;
- Добавление результата заполнения веб-формы. Используется событие OnAfterResultAdd;
- Изменение результата заполнения веб-формы. Используется событие OnAfterResultUpdate.
- Добавление комментария в блог. Используется событие OnCommentAdd.
- Регистрация пользователя. Используются события: OnAfterUserRegister и OnAfterUserSimpleRegister. Событие не сработает при ручном добавлении пользователя из админки и при автоматической регистрации после оформления заказа.
Для корректной работы ваш сайт должен использовать эти же стандартные события.
Технические ограничения:- Для работы с событиями заказов необходим стандартный модуль Sale.
- Для работы с событиями веб-форм необходим стандартный модуль Form.
- Для работы с событиями блога необходим стандартный модуль Blog.
- Для работы модуля необходим PHP >= 7.0, а также установленные PHP расширения curl, json, mbstring. Данные требования проверяются при установке.
- Модуль не работает при установленном PHP параметре mbstring.func_overload 2. Данное требование проверяется при установке.
После установки модуля необходимо перейти в его настройки: "Настройки - Настройки модулей" и в списке выбрать установленный модуль.
Далее нужно ввести токен Telegram бота, id получателей и настроить шаблоны. Инструкции по каждому пункту настроек, а также примеры даны в блоках с подсказками.
Перед обращением выполните следующие пункты:- Проверьте систему на наличие ошибок. В случае обнаружения ошибок, их необходимо исправить. Чтобы проверить систему, перейдите в "Настройки - Инструменты - Проверка системы" и нажмите кнопку "Начать тестирование".
- Перейдите в настройки этого модуля и убедитесь, что сверху нет предупреждений об ошибках. Они будут выделены красным предупреждающим блоком, вы точно его заметите.
- Убедитесь, что токен и id получателей введены верно. Токен должен иметь формат "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw". Если получатель - чат, а не пользователь, то его id идет со знаком минус вначале, например, "-1234567890".
- Если не работают оповещения о событиях заказа, то перейдите в настройки модуля "Интернет-магазин" и убедитесь, что у вас включен параметр "Включить обработку устаревших событий".
- Проверьте, что нужный шаблон включен.
Если вы проверили все пункты, но оповещения все равно не приходят, напишите письмо на почту:
alexby8@yandex.ru. В письме укажите следующие данные:
- Редакцию вашей системы (старт, малый бизнес и т.д.).
- Какое событие не работает.
- Приложите скриншот страницы настроек с токеном и получателями.
- Приложите скриншот страницы настроек шаблонов с нужным шаблоном.
- Скопируйте в письмо сам настроенный шаблон текстом.
- У модуля имеются логи ошибок, которые лежат в папке /bitrix/modules/aby.telegram/logs. По возможности прикрепите оттуда последний файл логов (если он там будет). Он будет с текущей датой.
Эта информация позволит максимально быстро решить вашу проблему, не удлиняя нашу с вами переписку запросами нужной нам информации.