Telegram Proxy Sender

На примере плагина — Интеграция Frontpad и WooCommrece

1. Прокси-туннель для frontpad-wc frontpad-wc не умеет ходить через прокси — у него в коде хардкод прямого HTTPS-запроса. Если ваш хостинг (например, в РФ) не имеет прямого выхода на api.telegram.org, уведомления просто теряются. С нашим перехватом в режиме Route его запросы автоматически идут через SOCKS5/HTTP-прокси, настроенный в нашем плагине. Никакого патча стороннего кода.

2. Retry при сбоях сети frontpad-wc шлёт один раз и, если сервер Telegram/прокси мигнул — уведомление теряется навсегда, оператор не узнает о заказе. Мы автоматически делаем 2–5 повторов (настраивается) с уважением заголовка retry_after от Telegram. Ни один заказ не потеряется из-за случайной сетевой ошибки.

3. Обработка лимитов Telegram (429 Too Many Requests) При наплыве заказов Telegram может вернуть 429. frontpad-wc этот случай не обрабатывает — уведомление теряется. Наш перехватчик читает retry_after, ждёт и повторяет. Плюс наш rate-limit сглаживает пиковые нагрузки в пределах ограничений Telegram (30 сообщ/сек глобально, 1/сек в один чат).

4. Единый лог всех отправок Логи frontpad-wc хранятся в его собственном формате и живут в сессии/файле. У нас — таблица wp_tps_logs с фильтрами по уровню/источнику/поиску, автоочисткой по возрасту. В логах видно строку вроде [warning][intercept:frontpad-wc] Ошибка проксирования sendMessage — сразу понятно, кто послал и что пошло не так. Один экран для отладки всех источников.

5. Диагностика в одном месте Когда что-то не работает у frontpad-wc, нужно лезть в его код. С перехватом всё видно в нашей странице «Диагностика»: проверка бота (getMe), проверка чата (getChat), тест всех типов прокси, полный отчёт для поддержки в JSON. Не нужно разбираться в чужом плагине.

6. Централизованная точка доставки (режим Takeover) Если вы хотите, чтобы все уведомления сайта — и от frontpad-wc, и от WooCommerce, и от контактной формы — прилетали в один канал под одним ботом, включите режим Takeover. Тогда мы полностью игнорируем настройки frontpad-wc (его токен/чат) и подставляем свои. Один бот, один чат, единая точка правды.

7. Фильтр контента перед отправкой С помощью хука tps_before_send_message можно, например, добавлять к каждому сообщению префикс с названием сайта, вырезать номера карт из логов, маскировать email — работает и для frontpad-wc, и для всех остальных источников одновременно, включая перехваченные.

8. Не нужно два бота frontpad-wc использует один токен, наш плагин — другой. С перехватом можно оставить в frontpad-wc любой токен (даже пустышку в режиме Takeover), а по факту всё пойдёт через ваш основной бот и в ваш основной чат. Экономия: один бот в BotFather на весь сайт.

Открыть Telegram → Настройки в WP-админке
Прокрутить до блока «Перехват сторонних отправок»
Включить toggle «Перехватывать отправки других плагинов»
Выбрать режим:

• Route — если хотите оставить свой бот у frontpad-wc, но получить прокси/retry/логи
• Takeover — если хотите один бот на весь сайт

WordPress action
do_action('tps_send', 'Привет!');
do_action('tps_send', 'В канал', '-1001234567890');
do_action('tps_send', 'Молча', null, ['silent' => true]);

Публичная функция
tps_send('Простое сообщение');
$result = tps_send('С опциями', null, [
'parse_mode' => 'HTML',
'silent' => false,
]);
if (!$result['ok']) {
error_log('TPS error: ' . $result['error']);
}

Шорткод
[tps_send message="Отправлено при рендере страницы"]

REST API
curl -X POST "https://xxxxxxx.com/wp-json/tps/v1/send" \
-H "X-TPS-API-Key: {ваш_ключ_из_настроек}" \
-d "message=Тест&chat_id=-xxxxxxxxxxxx"

Фильтры и хуки
// Модифицировать сообщение перед отправкой
add_filter('tps_before_send_message', function($msg, $chat_id, $opts) {
return '[' . get_bloginfo('name') . "]\n" . $msg;
}, 10, 3);

Используйте этот ключ для отправки сообщений извне (n8n, Zapier, Postman).
WD03HaI6XykeTC0w17CSfFtNp8fxxxxxxxxxx

Пример вызова
url -X POST «https://xxxxxxxxxxx.com/wp-json/tps/v1/send» \
-H «X-TPS-API-Key: WD03HaI6XykeTC0w17CSfFtNp8fxxxxxxxxxx» \
-H «Content-Type: application/x-www-form-urlencoded» \
-d «message=Hello from external»

Единый центр отправки уведомлений
Все компоненты сайта — плагины, темы, кастомные скрипты — могут инициировать отправку через единый интерфейс: хуки do_action('tps_send', ...), функция tps_send(), REST API или встраиваемый шорткод. Никакой путаницы в точках интеграции.

Гибкая работа с Telegram Bot API
Полная поддержка прокси-серверов любого типа: SOCKS5, SOCKS4, HTTP/HTTPS с авторизацией. Встроенная система повторных попыток с интеллектуальной обработкой ошибок Telegram — автоматическое ожидание при получении retry_after, чтобы не нарушать лимиты API.

Готовые решения для популярных плагинов
Без единой строки кода подключите уведомления для:

• WooCommerce — новые заказы и смена их статусов,

• Contact Form 7 и WPForms — каждое отправленное письмо,

• комментарии, регистрации новых пользователей, публикация записей.

Динамические шаблоны сообщений
Создавайте любые сценарии уведомлений, используя переменные-плейсхолдеры: {order_id}, {fields}, {user_login}, {post_title} и десятки других — сообщение соберётся автоматически с подстановкой актуальных данных.

Интерактивный мастер настройки
Пошаговый помощник для новичков: создание бота через BotFather, получение Chat ID, настройка прокси-сервера и проверка работоспособности — всё в понятном интерфейсе без технических сложностей.

Мощная встроенная диагностика
Полный «чек-ап» системы: проверка окружения (версии PHP, наличие cURL/OpenSSL, работа DNS), валидация токена бота через метод getMe, проверка доступа к чату через getChat, тестирование всех четырёх типов прокси с детальным отчётом. Результаты можно экспортировать в JSON для технической поддержки.

Система логирования с хранением в БД
Все отправки сохраняются с возможностью фильтрации по дате, статусу, типу события, поиском по содержимому и пагинацией. Настраиваемое автоудаление старых записей — база данных всегда под контролем.

Защита от превышения лимитов Telegram
Встроенный механизм rate limiting автоматически регулирует частоту запросов, предотвращая блокировки со стороны Telegram.

Открытое REST API с авторизацией
Интегрируйте плагин с внешними сервисами (n8n, Zapier, собственные скрипты) через защищённое API с индивидуальным ключом доступа — отправляйте уведомления из любых систем.

Современный интерфейс в фирменном стиле Telegram
Административная панель выполнена в лаконичном дизайне с акцентным цветом #229ED9 — удобно, понятно, эстетично.

• Загрузка — скопируйте папку telegram-proxy-sender в директорию /wp-content/plugins/ вашего WordPress-сайта (через FTP или файловый менеджер хостинга).
• Активация — перейдите в административную панель WordPress, откройте раздел «Плагины» и найдите «Telegram Proxy Sender» в списке — нажмите кнопку Активировать.
• Настройка — в боковом меню админки появится новый пункт Telegram. Зайдите в подраздел Мастер настройки и пройдите пошаговый сценарий: создание бота, получение Chat ID, проверка соединения и тестовый запуск — всё это займёт не более 5 минут.