Documentation

Overview

Telegram & MAX Notifications is an OctoberCMS plugin that sends frontend form submissions to Telegram, MAX messenger, or both simultaneously. It also supports fallback routing, including an optional author-managed proxy setup for projects that require an alternative delivery route.

Requirements

• OctoberCMS 4.x
• PHP 8.0+

Installation

Install via OctoberCMS plugin installer

php artisan plugin:install Dmdev.Telegramnotice --from=https://github.com/mifasu/telegramnotice.git

Manual installation

cd plugins/dmdev
git clone https://github.com/mifasu/telegramnotice.git telegramnotice
php artisan october:up

Configuration

Open:

Backend → Settings → Telegram Notice

Telegram configuration

Fill in:

• bot_token — your Telegram bot token
• chat_id — your target Telegram chat or channel ID

MAX configuration

Fill in:

• max_bot_token — your MAX bot access token
• max_chat_id — your target MAX chat or channel ID

Important: MAX does not support HTML formatting in message text. The plugin automatically converts the outgoing message into plain text before sending.

Fallback configuration

• pechkin_secret — secret key for fallback delivery

If Telegram and MAX are not configured, the plugin can use fallback routing automatically.

Important: if you want to use the author's proxy-based delivery route, it must be configured individually. The site and token should be registered and linked to the destination chat or channel in advance.

Routing behavior

• Telegram only → send to Telegram
• MAX only → send to MAX
• Telegram + MAX → send to both
• Neither configured → send through fallback routing

Usage

Attach the component to a page or layout

title = "Contact"
url = "/contact"
layout = "default"

[telegramNotice]

Render the default form

{% component 'telegramNotice' %}

Render the modal form

{% component 'telegramNotice' template="TelegramNotice::order-modal-form" %}

Component properties

• btnName — submit button label
• sitename — legacy site hostname for fallback usage
• token — legacy fallback token override

Accepted form fields

The component accepts these common fields:

• ph, phone, phone_number, contact — phone number
• name, nm, fullname — customer name
• tag — optional tag appended to the message
• from — page or section label
• arr[] — additional values, one line per item

Logging

Send errors are logged through the standard Laravel / October logging system.

Migration

If an older config file was previously used, the plugin can migrate those values into Backend Settings automatically on first boot when the settings fields are still empty.

Repository

GitHub repository:

• https://github.com/mifasu/telegramnotice