Модуль Telegram Notifier для OkayCMS v1.0

Модуль позволяет получать уведомления в Telegram о новых заказах, оплаченных заказах, комментариях, обратной связи, заявках на звонок, а также ежемесячную статистику заказов из вашего интернет-магазина.

Возможности​

Мгновенные уведомления​

• Новый заказ — автоматическая отправка при оформлении заказа на сайте.
• Оплаченный заказ — уведомление, когда заказ помечен как оплаченный (удобно при онлайн-оплате: колбэк платежной системы вызывает обновление paid, модуль отправляет подтверждение в Telegram).
• Новый комментарий — уведомление о комментариях к товарам и блогам.
• Обратная связь — уведомление о новых сообщениях через форму обратной связи.
• Заявка на звонок — уведомление о новых заявках на обратный звонок.

Ежемесячная статистика (крон)​

• Статистика заказов — ежемесячный отчет за предыдущий месяц:
  • количество заказов;
  • общая сумма;
  • разбивка по статусам (все статусы, в которых есть заказы за период);
  • топ-3 товара по количеству проданных единиц;
  • хештег #order_stats для быстрого поиска в Telegram.
• Отправка 1-го числа каждого месяца в 9:00 (при условии настроенного планировщика крон-задач).

Общие возможности​

• Отдельное включение/выключение каждого типа уведомлений.
• Формат отображения товара для уведомлений о заказах и оплаченных заказах: название, название (вариант), название + артикул, название (вариант) + артикул.
• Форматирование сообщений в HTML с детальной информацией.
• Автоматическая обрезка сообщений при превышении лимита Telegram API (4096 символов).

Требования​

• OkayCMS v4.5.2
• Telegram Bot Token (можно получить через @BotFather)
• Chat ID Telegram-чата или пользователя, куда будут отправляться уведомления
• Для ежемесячной статистики — настроенный планировщик крон-задач (например, php console.php scheduler:run ежеминутно)

Установка​

Вариант 1: Скачивание с GitHub

1. Скачайте последнюю версию модуля из последнего релиза на GitHub.
2. Распакуйте архив на сервере в каталог: {OkayCMS_root}/Okay/Modules/

Вариант 2: Установка через Git. Выполните команду в директории {OkayCMS_root}/Okay/Modules/Sviat/:git clone [

Для просмотра ссылки Вы должны войти или зарегистрироваться.

TelegramNotifier

Результат установки. Путь к модулю должен быть таким:{OkayCMS_root}/Okay/Modules/Sviat/TelegramNotifier/

После установки перейдите в админ-панель → Модули → Найдите «Telegram сповіщення» → Нажмите «Встановити» (Установить).

Настройка​

Получение Bot Token

1. Откройте Telegram и найдите бота @BotFather.
2. Отправьте команду /newbot и следуйте инструкциям.
3. После создания бота вы получите токен в формате: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz.
4. Скопируйте этот токен.

Получение Chat ID

1. Добавьте вашего бота в группу.
2. Найдите бота @getidsbot и добавьте его в эту же группу.
3. Бот покажет Chat ID группы (например: -1001234567890).

Настройка модуля в админ-панели

1. После установки перейдите в админ-панель → Модули → Telegram сповіщення.
2. Заполните обязательные поля:
   
   • Bot Token — токен вашего Telegram-бота.
   • Chat ID — ID чата или пользователя.
3. Включите нужные типы уведомлений:
   
   • Новый заказ
   • Оплаченный заказ
   • Уведомления о новых комментариях
   • Уведомления об обратной связи
   • Уведомления о заявках на звонок
   • Статистика заказов (ежемесячный отчет 1-го числа в 9:00)
4. Выберите формат отображения товара для заказов.
5. Нажмите «Зберегти» (Сохранить).

Использование​

Мгновенные уведомления. Модуль автоматически отправляет сообщения в Telegram при наступлении событий (новый заказ, оплата, комментарий, обратная связь, заявка на звонок). Уведомление об оплате отправляется только один раз при смене статуса на «оплачен».

Ежемесячная статистика. Если включена опция «Статистика заказов», 1-го числа каждого месяца в 9:00 (по расписанию крона) в Telegram отправляется отчет за прошлый месяц. Для работы отчета необходимо, чтобы на сервере выполнялся планировщик крон-задач OkayCMS.

Важно​

• Если сообщение превышает 4096 символов, оно автоматически обрезается.
• Убедитесь, что Bot Token и Chat ID введены правильно.
• Уведомление об оплате отправляется только при реальном изменении статуса оплаты на «оплачен» (не при повторной отметке уже оплаченного заказа).