WP Telegram Pro - Плагин WordPress

Руководство по настройке и применению WP Telegram Pro

WP Telegram Pro полезен не просто как мост между WordPress и Telegram. В реальной работе он закрывает сразу несколько задач: автоматическую отправку записей в каналы, разную маршрутизацию материалов по рубрикам и авторам, сообщения с кнопками, личные уведомления из почтовых событий WordPress, отдельные боты для разных сценариев и резервный прокси-режим, если хостинг не может напрямую обратиться к Telegram.

Это руководство не повторяет короткое описание продукта. Ниже разобраны подготовка, установка, первая проверка бота, настройка правил отправки, шаблоны сообщений, practical-сценарий для контентного сайта, диагностика ошибок и выбор похожих решений. Акцент сделан на том, как пользоваться WP Telegram Pro без хаотичной отправки дублей и без лишнего шума в каналах.

Часть интерфейса и названия модулей у продукта англоязычные, поэтому в руководстве точные пункты меню и системные термины оформлены через code. Если в вашей версии названия немного отличаются, ориентируйтесь на смысл раздела: модуль публикации записей, настройки бота, настройки шаблона, правила фильтрации, личные уведомления и расширенные журналы.

Какую задачу закрывает плагин и где он особенно полезен

Главная ценность плагина в том, что Telegram становится не отдельной ручной площадкой, а частью редакционного и административного процесса WordPress. Когда запись публикуется, обновляется или создаётся через поддерживаемый сценарий, плагин может отправить сообщение в канал, группу, супергруппу или приватный чат. Когда WordPress или другой плагин отправляет письмо, модуль личных уведомлений может переслать это событие в Telegram, если адрес получателя совпадает с заданной связкой.

В бесплатной линейке WP Telegram уже есть важные базовые функции: автопубликация записей, шаблон сообщения, отправка изображения, поддержка нескольких чатов, правила фильтрации и модуль уведомлений. Pro-версия расширяет именно управляемость: несколько ботов, несколько независимых экземпляров Post to Telegram, отдельные шаблоны под рубрику, автора, тип записи или канал, кнопки реакций и ссылок, расширенную клавиатуру, задержку отправки, поддержку WooCommerce и ACF-полей, отправку мультимедиа и отдельные сценарии для личных уведомлений.

Такой набор особенно нужен сайтам, где Telegram-канал не один. Например, у издания может быть общий канал, канал для новостей региона и канал для платных анонсов. У магазина может быть публичный канал с новыми товарами и приватный чат команды с заказами. У образовательного проекта могут быть разные группы для учеников, преподавателей и администраторов. В этих ситуациях важна не сама возможность отправить пост, а правило: какой материал, каким ботом, в какой чат, с каким текстом и какими кнопками уйдёт.

Плагин также полезен, если команда привыкла реагировать на Telegram быстрее, чем на почту. Private Notifications может пересылать письма WordPress, WooCommerce, Contact Form 7 и других системных источников в нужный чат. Это не отменяет почтовые уведомления, но помогает не потерять заказ, заявку или системное письмо, когда почта задерживается, попадает в спам или проверяется не всеми участниками команды.

Кому WP Telegram Pro подойдёт, а кому лучше выбрать другой путь

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

Если ваш сайт публикует одну заметку в месяц и отправляет её в один канал, возможно, базового WP Telegram будет достаточно. Pro-версия раскрывается там, где важны несколько маршрутов, несколько шаблонов, разные кнопки, отдельные боты, уведомления по почтовым событиям и более точная логика фильтрации. Покупать или подключать сложный режим ради одного канала без правил обычно нет смысла.

WP Telegram Pro может не подойти в нескольких случаях:

• Если нужен полноценный планировщик публикаций во множество социальных сетей, а Telegram только одна из площадок. Тогда удобнее смотреть на сервисы и плагины класса social media scheduler.
• Если требуется двусторонний бот с меню, поиском по сайту, оплатами, заявками и сложной логикой диалога. WP Telegram Pro работает прежде всего как интеграция WordPress-событий и Telegram-сообщений, а не как конструктор чат-ботов.
• Если сайт находится на хостинге, который блокирует исходящие запросы к Telegram, но вы не готовы настраивать прокси или обсуждать ограничения с провайдером.
• Если редакторы не готовы соблюдать правила отправки: например, вручную включают Send to Telegram при каждом обновлении уже опубликованной записи и тем самым провоцируют дубли.

Практический ориентир: если у вас есть разные типы контента, разные каналы или важные уведомления из WordPress, Pro-версия даёт контроль. Если нужен один простой автопостинг, начните с базового сценария и проверьте, где именно не хватает гибкости.

Что проверить перед установкой и первым запуском

Перед установкой важно подготовить не только ZIP-файл плагина, но и окружение. Telegram-интеграции часто ломаются не из-за самого WordPress, а из-за неверного токена, отсутствия бота в канале, неправильного идентификатора чата, блокировки Telegram на хостинге или конфликтной логики публикации записи.

Бот, токен и доступ к каналу

Для отправки сообщений нужен Telegram-бот. Его создают через @BotFather, после чего Telegram выдаёт токен. Токен нужно хранить как пароль: не публиковать в статье, не пересылать в общий чат команды и не вставлять в скриншоты. Если токен был раскрыт, его лучше перевыпустить в @BotFather и заменить в настройках.

Если сообщения должны идти в канал или группу, добавьте бота туда заранее. Для каналов бот должен иметь права, достаточные для публикации сообщений. Если бот не добавлен или ID чата указан неверно, типичный симптом - ошибка вида Chat ID not found или отсутствие сообщений при успешной установке плагина.

Права WordPress и редакционный процесс

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

Особое внимание нужно уделить записям, созданным импортом, автогенерацией или сторонними формами. В базовой документации WP Telegram указано, что отправка при массовом импорте по умолчанию ограничивается, чтобы не залить канал случайным потоком старых материалов. Это разумное поведение, и включать такой сценарий стоит только после теста на копии сайта или на непубличном канале.

Хостинг, кеш и исходящие запросы

Telegram Bot API работает через HTTPS-запросы. Если хостинг блокирует Telegram, тест токена может завершаться сетевой ошибкой. В таком случае смотрите не на кеш страницы, а на сетевой путь: может потребоваться модуль Proxy, настройка Cloudflare Worker, Google Script или другой поддерживаемый прокси-тип. Кеш-плагины обычно не мешают самому отправлению сообщения, но могут косвенно влиять на URL изображений и на момент публикации записи.

Установка и первичная проверка после активации

Для действующего сайта лучше начинать с безопасного сценария: установить плагин, включить только нужный модуль, проверить токен и отправить тестовое сообщение в закрытый чат. Не стоит сразу подключать публичный канал, все рубрики и все типы записей. Ошибки в правилах отправки становятся заметны слишком поздно, когда канал уже получил лишние сообщения.

Базовый порядок установки

1. Сделайте резервную копию сайта или хотя бы базы данных, если установка идёт на рабочем проекте.
2. Установите плагин через Plugins - Add New - Upload Plugin, если у вас ZIP-архив, или через стандартный поиск для базовой версии WP Telegram.
3. Активируйте плагин кнопкой Activate.
4. Откройте страницу настроек WP Telegram в админ-панели WordPress.
5. Включите только тот модуль, который будете проверять первым: обычно Post to Telegram или Private Notifications.
6. Введите токен бота и выполните тест, если такой тест доступен в вашей панели.
7. Сохраните настройки через Save Changes и отправьте пробное сообщение в непубличный чат.

После установки важно убедиться, что работает именно соединение WordPress -> Telegram. Если тест токена не проходит, дальнейшая настройка шаблонов и правил не имеет смысла: сначала нужно исправить токен, права бота, ID чата или сетевой доступ.

Первая проверочная публикация

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

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

Подробная настройка: боты, каналы, правила и шаблоны

Настройка WP Telegram Pro удобнее воспринимается не как одна большая форма, а как маршрут данных. Сначала WordPress создаёт событие: новая запись, обновление, письмо, заказ или форма. Затем плагин проверяет модуль и правила. После этого выбирает бота, чат, шаблон, кнопки, вложения и момент отправки. Если разложить конфигурацию по этой цепочке, ошибок становится меньше.

Выбор модулей без лишней нагрузки

Включайте только модули, которые реально нужны. Если сайт использует автопубликацию записей, но не пересылает письма WordPress в Telegram, начните с Post to Telegram. Если сайт получает заказы или формы и команде нужны быстрые служебные уведомления, отдельно настройте Private Notifications. Если хостинг не блокирует Telegram, модуль Proxy лучше оставить выключенным, пока нет причины.

Такой подход помогает диагностике. Когда включено сразу всё, сложнее понять, почему сообщение появилось в чате: оно пришло из публикации записи, почтового уведомления, пользовательской нотификации или ручного instant-сообщения. Сначала добейтесь устойчивой работы одного маршрута, затем добавляйте следующие.

Что включить в первый день

Для большинства сайтов безопасный старт - один бот, один тестовый chat ID, один экземпляр Post to Telegram и один короткий шаблон. Расширенные маршруты лучше добавлять после того, как первый маршрут стабильно проходит проверку результата.

Несколько ботов и несколько чатов

Pro-версия позволяет разделять ботов по задачам. Это полезно, когда публичные публикации и служебные уведомления должны выглядеть по-разному и не смешиваться в одном имени бота. Например, один бот публикует анонсы в канале, второй отправляет заказы в рабочий чат, третий используется для пользовательских уведомлений после входа через WP Telegram Login.

У каждого бота должен быть свой токен и свой проверенный доступ к нужным чатам. Если вы используете несколько каналов, не полагайтесь на память. Ведите простую внутреннюю таблицу: название канала, chat ID, бот, назначение, ответственный редактор. Это не техническая обязательность, но она снижает риск отправить коммерческий анонс в общий новостной канал или служебное уведомление в публичную группу.

Правила отправки записей

Ключевой раздел для контентного сайта - правила Post to Telegram. Они определяют, какие типы записей отправлять, при каком событии отправлять, какие рубрики, теги, авторы или таксономии учитывать и куда отправлять результат. Для типового сайта начните с узкого правила: один тип записи, одна рубрика, один тестовый канал. Когда оно работает, расширяйте условия.

Если WP Telegram Pro используется для разных каналов, создавайте отдельные экземпляры Post to Telegram под разные маршруты. Например, "Новости -> основной канал", "Обзоры -> канал с подборками", "WooCommerce товары -> канал магазина". Так проще задать отдельные шаблоны, кнопки и задержку. Главное - не создавать пересекающиеся правила, где одна и та же запись подходит сразу под два экземпляра без осознанной причины.

Как откатить спорное правило

Если маршрут отправляет лишние сообщения, не удаляйте всё сразу. Сначала отключите конкретный экземпляр или сузьте условие до тестовой рубрики. Так вы сохраните шаблон и историю настройки, но остановите нежелательную публикацию. Удаление экземпляра оправдано только после проверки, что он больше не связан с рабочими кнопками или реакциями.

Шаблон сообщения и форматирование

Шаблон сообщения отвечает за то, как публикация выглядит в Telegram. В нём обычно используют заголовок, ссылку, фрагмент текста, данные рубрики, изображение и дополнительные поля. Если включено HTML-форматирование, Telegram поддерживает ограниченный набор тегов, поэтому не переносите в шаблон весь HTML записи. Лучше сделать короткий, предсказуемый текст.

Для заголовка можно использовать безопасное выделение через HTML-теги Telegram, например <b>{post_title}</b>, если в настройках форматирования выбран HTML. Не добавляйте в шаблон неподтверждённые переменные. Если нужно вывести ACF или WooCommerce-поле, сначала проверьте, что эта поддержка есть в вашей версии и что поле действительно заполнено у тестовой записи.

Кнопки, реакции и inline keyboard

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

Если используете реакции, не удаляйте без необходимости экземпляры отправки, связанные с уже опубликованными кнопками. В публичных материалах разработчика отмечается, что счётчики реакций завязаны на экземпляр, из которого было отправлено сообщение. Если удалить этот экземпляр, обновление счётчика может перестать работать корректно. Безопаснее отключить правило или изменить условия, чем удалять рабочую структуру, которая уже использовалась в канале.

Задержка отправки и защита от дублей

Задержка отправки помогает, когда редакторы публикуют запись и сразу вносят мелкие правки. Если сообщение уходит мгновенно, Telegram может получить черновую формулировку или второй пост после обновления. Небольшая задержка даёт время исправить опечатку и уменьшает риск дублей, особенно в редакторе блоков и на сайтах с плагинами автосохранения.

Но задержка не должна превращаться в слепой буфер. После настройки проверьте, что старые записи не отправляются заново, что опубликованные материалы уходят в нужное время, а ручной флаг Send to Telegram в редакторе не включается там, где запись должна следовать общим правилам.

Маршрутизация по рубрикам, авторам и типам записей

Именно этот раздел отличает сложную настройку WP Telegram Pro от обычного автопостинга. Если у сайта один канал, одно правило и один текст, гибкость Pro-версии может казаться избыточной. Но если один и тот же WordPress-сайт обслуживает несколько Telegram-аудиторий, маршрутизация становится главным инструментом.

Один экземпляр на один понятный маршрут

Хорошее правило легко объяснить одной фразой. Например: "Все записи рубрики News отправлять в общий канал", "Товары WooCommerce с меткой Sale отправлять в канал магазина", "Материалы автора редакции отправлять в закрытый рабочий чат". Если правило нельзя описать без длинного списка исключений, его стоит разделить на несколько экземпляров.

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

Как избежать пересечения правил

Пересечение появляется, когда одна запись подходит под несколько маршрутов. Это не всегда ошибка. Иногда материал должен уйти сразу в общий канал и в тематическую группу. Но если дубли возникают случайно, проверьте условия: тип записи, рубрику, тег, автора, custom taxonomy, состояние записи и ручной флаг отправки.

Удобная проверка - временно добавить в шаблон каждого маршрута короткую служебную метку, например [News route] или [Shop route], отправить тестовую запись в закрытый канал и посмотреть, какие маршруты сработали. После проверки метку нужно убрать. В публичный канал такую диагностику лучше не отправлять.

Шаблоны для разных аудиторий

Разные каналы часто требуют разного текста. Для новостного канала важно показать заголовок, краткий фрагмент и ссылку. Для магазина - название товара, цену или ключевое поле, изображение и кнопку "Открыть товар", если такие данные доступны и подтверждены настройками. Для внутреннего чата команды - ссылка на запись в админ-панели может быть полезнее публичного описания.

Не делайте один универсальный шаблон для всех каналов. Он либо станет слишком длинным, либо будет терять важные детали. Лучше создать короткие отдельные шаблоны и протестировать их на реальных записях разных типов. Если в шаблоне используются пользовательские поля, проверьте запись, где поле пустое: сообщение не должно выглядеть сломанным.

Private Notifications: как пересылать важные письма WordPress в Telegram

Модуль Private Notifications работает вокруг почтовых событий WordPress. В публичной документации WP Telegram объясняется механика так: модуль отслеживает письма, отправляемые сайтом, и если адрес получателя совпадает с адресом, заданным в настройках, содержание уведомления пересылается в выбранный Telegram-чат. В Pro-версии доступны несколько связок email -> Telegram chat и поддержка вложений.

Это удобно для WooCommerce, Contact Form 7, bbPress и других плагинов, которые уже отправляют письма. Вместо того чтобы писать отдельную интеграцию для каждого источника, вы настраиваете соответствие почтового получателя и Telegram-чата. Такой подход прост, но требует дисциплины: адрес в настройках формы или магазина должен совпадать с адресом, который отслеживает модуль.

Типовой сценарий для заказов и заявок

Для WooCommerce проверьте, какой email получает уведомления о заказах. Затем добавьте этот адрес в связку Private Notifications и укажите чат команды. После тестового заказа убедитесь, что письмо WordPress отправляется и соответствующее сообщение появляется в Telegram. Если почта не отправилась вообще, проблема не в Telegram-интеграции, а в почтовой доставке WordPress.

Для Contact Form 7 логика похожая: в настройках формы откройте раздел Mail, проверьте поле To и используйте тот же адрес в Private Notifications. Если форма отправляет письма на несколько адресов, проверьте, какой из них должен попадать в Telegram. Не пересылайте все служебные письма в общий канал команды, если там есть персональные данные клиентов.

Пользовательские уведомления и WP Telegram Login

WP Telegram Pro может работать вместе с WP Telegram Login, чтобы пользователи связывали аккаунт сайта с Telegram. Это открывает сценарий пользовательских уведомлений: когда WordPress отправляет письмо конкретному пользователю, плагин может найти связанный Telegram-аккаунт и переслать уведомление туда. Такой сценарий подходит не всем сайтам, но полезен в закрытых сообществах, образовательных проектах и личных кабинетах.

Перед включением пользовательских уведомлений объясните пользователям, какие события они будут получать и как отключить лишние сообщения. Telegram-уведомления воспринимаются более лично, чем email, поэтому шум быстро раздражает. Начинайте с действительно важных событий: подтверждение заявки, изменение статуса заказа, сообщение администратора, новая тема в закрытом форуме.

Instant Messages и ручная отправка без публикации записи

В Pro-версии есть отдельный сценарий для instant-сообщений: можно отправлять текстовые и мультимедийные сообщения пользователям, каналам и группам без создания записи WordPress. Это не заменяет новостной раздел сайта, но хорошо подходит для коротких оперативных объявлений, служебных предупреждений, уведомлений о технических работах или сообщения группе пользователей, подключённых через Telegram Login.

Главное отличие от обычного Post to Telegram - отсутствие привязки к записи. Значит, у сообщения нет естественной страницы на сайте, рубрики, автора и шаблона публикации. Поэтому перед отправкой ручного сообщения стоит проверить текст, адресата и вложения дважды. Ошибка в канале для instant-сообщения не исправляется так же удобно, как ошибка в записи, которую можно обновить и повторно отправить по правилу.

Когда ручная отправка уместна

• Нужно быстро предупредить подписчиков о технической паузе, не создавая отдельную запись на сайте.
• Команда хочет отправить короткое объявление в закрытую группу администраторов.
• Пользователям, подключившим Telegram через связанный аккаунт, нужно отправить важное уведомление, если такая функция настроена и уместна для вашего проекта.
• Нужно проверить конкретного бота или канал без публикации тестовой записи.

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

Практический пример: разные каналы для новостей и товаров

Разберём предметный сценарий. Есть WordPress-сайт с блогом и WooCommerce. Команда хочет отправлять новости в один Telegram-канал, товары со скидкой - в другой, а уведомления о заказах - в закрытый чат менеджеров. Этот пример показывает, как использовать сильные стороны WP Telegram Pro: несколько экземпляров, разные шаблоны, отдельные чаты и Private Notifications.

Цель

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

Подготовка

Создайте или проверьте три адресата: канал новостей, канал магазина и закрытый чат менеджеров. Добавьте нужного бота или ботов в эти чаты. Для первого запуска лучше использовать тестовые копии каналов, чтобы не отправлять служебные сообщения публичной аудитории.

Шаги настройки

1. В настройках ботов добавьте токен основного бота и выполните тест отправки.
2. Создайте первый экземпляр Post to Telegram для записей типа post и рубрики новостей.
3. Назначьте этому экземпляру канал новостей и короткий шаблон: заголовок, фрагмент, ссылка на запись и одна кнопка открытия материала.
4. Создайте второй экземпляр для WooCommerce-товаров или нужного типа записи, ограничив его меткой, рубрикой или пользовательским условием, которое обозначает товар для Telegram.
5. Настройте отдельный шаблон товара: название, короткое описание, изображение и кнопку перехода на страницу товара, если эти данные корректно доступны.
6. Включите Private Notifications для email-адреса, на который WooCommerce отправляет уведомления о заказах, и свяжите его с закрытым чатом менеджеров.
7. Добавьте небольшую задержку отправки для записей, если редакторы часто правят материал сразу после публикации.

Проверка результата

Опубликуйте тестовую новость, тестовый товар и оформите тестовый заказ. Проверьте, что новость не ушла в магазинный канал, товар не ушёл в новостной канал, а заказ появился только в закрытом чате. Если одно событие попало в два канала, значит правила пересекаются. Если заказ не пришёл, проверьте сначала, отправилось ли email-уведомление WordPress.

Что считать успешным тестом

Успешный тест - это не одно сообщение в Telegram, а три совпадения: правильный адресат, правильный шаблон и отсутствие лишнего повтора после редактирования. Если хотя бы один пункт не совпал, настройку лучше считать незавершённой.

Нюанс, который часто мешает

Ручной флаг Send to Telegram на странице редактирования может переопределить ожидания. Если редактор включает его при обновлении уже опубликованной записи, сообщение может уйти повторно. Объясните редакторам, когда этот флаг нужен, а когда следует оставить запись на общих правилах.

Как проверять результат без догадок

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

Чек-лист после настройки маршрута

• Сообщение пришло в тот чат, который указан в конкретном экземпляре отправки.
• Текст соответствует нужному шаблону, а не шаблону другого маршрута.
• Ссылка открывает правильную публичную страницу.
• Изображение отправилось только там, где оно нужно, и не ломает сообщение.
• Кнопки ведут на ожидаемые адреса и не выглядят как лишний набор действий.
• При обновлении записи сообщение не дублируется без причины.
• Журналы включены только на время диагностики или используются осознанно, чтобы не хранить лишние технические данные без необходимости.

Проверка на разных ролях и типах записей

Если сайт использует авторов, редакторов, импорт или пользовательские формы, тестируйте не только запись администратора. Создайте или попросите создать тестовую запись от роли, которая реально будет публиковать контент. Для фронтенд-публикации проверьте права пользователя: в FAQ WP Telegram указано, что записи, созданные через сторонние формы, могут не отправляться, если у пользователя недостаточно прав для публикации или редактирования.

Для WooCommerce проверьте не только карточку товара, но и заказ. У товара одно событие - публикация или обновление записи. У заказа другое - email-уведомление. Поэтому магазинный канал и служебный чат менеджеров должны тестироваться разными действиями.

Безопасные улучшения и аккуратная техническая доработка

Для WP Telegram Pro не стоит придумывать скрытые хуки или править файлы плагина. Но один документированный пример из FAQ WP Telegram полезен для сайтов, которые осознанно хотят отправлять записи, созданные массовым импортом. По умолчанию такая отправка ограничивается, чтобы не затопить канал большим количеством старых или технических материалов.

Если вам действительно нужно разрешить отправку при импорте, добавьте фильтр в дочернюю тему или через безопасный менеджер фрагментов кода. Сначала протестируйте это на закрытом канале и убедитесь, что правила отправки не захватывают старые записи.

add_filter( 'wptelegram_p2tg_send_if_importing', '__return_true' );

После добавления опубликуйте небольшой тестовый импорт из 1-2 записей и проверьте журналы. Если канал получил больше сообщений, чем ожидалось, удалите фрагмент кода или отключите его в менеджере snippets, затем пересмотрите правила Post to Telegram. Не используйте этот фильтр на крупном импорте, пока не проверили ограничивающие условия.

Для внешнего вида сообщений безопаснее работать через шаблон сообщения и настройки кнопок, а не через правку PHP. Для доставки изображений сначала пробуйте настройки отправки файлов, URL и прокси, а не изменения ядра WordPress или файлов плагина.

Если сообщения не уходят, дублируются или приходят не туда

Диагностику лучше начинать с маршрута, а не с общих догадок. У Telegram-интеграции есть несколько точек отказа: бот, chat ID, права в канале, сеть хостинга, правила отправки, шаблон, изображение, ручной флаг в редакторе и почтовый источник для Private Notifications.

Ошибка Chat ID not found или сообщение не приходит в канал

Симптом: тест или публикация не доходят до канала, в журнале видна проблема с идентификатором чата. Причина: указан неверный chat ID, бот не добавлен в канал или у него нет нужных прав. Проверьте ID через рекомендованный способ, убедитесь, что бот находится в канале, и выполните тест в закрытом чате. Если канал приватный, не заменяйте ID на красивое имя канала без проверки.

Дубли сообщений после редактирования записи

Симптом: запись публикуется в Telegram, затем после правки появляется ещё одно сообщение. Причина: обновление записи, ручной флаг Send to Telegram, пересекающиеся правила или несколько запросов публикации. Проверьте, какие условия включены в Send When, есть ли задержка отправки, не подходит ли запись под два экземпляра Post to Telegram. Если проблема повторяется, включите журналы и сопоставьте время публикации, обновления и отправки.

Изображение или файл не отправляется

Симптом: текст уходит, но картинка отсутствует, либо в журнале появляется ошибка по URL или файлу. Причина: Telegram не может получить файл по URL, хостинг блокирует внешний доступ, изображение имеет неподходящие параметры или включён неудачный режим отправки. Проверьте публичный доступ к изображению, попробуйте отключить отправку файлов по URL в расширенных настройках, если такая опция есть, и протестируйте другой файл небольшого размера.

Private Notifications не пересылает заказ или форму

Симптом: заказ или форма есть в WordPress, но Telegram-сообщения нет. Причина: WordPress не отправил письмо, адрес получателя не совпадает со связкой в Private Notifications, форма отправляет письмо на другой email или почтовое событие создаётся нестандартно. Сначала проверьте почтовый лог или тестовую доставку письма, затем сверяйте адреса. Если письмо не создаётся, модуль Telegram не сможет его переслать.

Хостинг не подключается к Telegram

Симптом: тест токена даёт сетевую ошибку, а настройки чата выглядят правильными. Причина: хостинг блокирует Telegram или исходящие HTTPS-запросы. Включайте Proxy только после такой проверки. Если прокси решает проблему, зафиксируйте это в документации проекта, чтобы следующий администратор не отключил модуль как "лишний".

Записи, созданные импортом или фронтенд-формой, не отправляются

Симптом: обычные записи администратора уходят, а импортированные или пользовательские записи нет. Причина: защита от массовой отправки при импорте, недостаточные права пользователя, нестандартный процесс создания записи или правило, которое не захватывает нужный тип записи. Проверьте тип записи, автора, статус публикации и права. Фильтр для импорта используйте только после теста и только если вы понимаете риск массового потока сообщений.

Видео по продукту: что полезно посмотреть после базовой настройки

Для WP Telegram Pro найден точный ролик разработчика WP Telegram Pro - Introduction. Он полезен как визуальное дополнение к разделам про возможности Pro-версии: несколько экземпляров отправки, шаблоны, кнопки и общую логику продукта. Используйте его не вместо настройки, а как короткую проверку, что вы правильно поняли основные модули.

Если вам важен именно модуль Private Notifications, у WP Telegram также есть отдельный ролик о его работе. Встраивать второй ролик в руководство не обязательно: для большинства пользователей достаточно одного общего видео, а детали пересылки почтовых уведомлений лучше проверять на собственном тестовом заказе или форме.

Когда WP Telegram Pro будет удачным выбором

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

Перед рабочим запуском проверьте три вещи: тестовый бот отправляет сообщение, правила не пересекаются случайно, а редакторы понимают, когда использовать ручной флаг Send to Telegram. Если эти проверки пройдены, можно скачать ZIP-архив и переходить к настройке на своём сайте с тестового канала, а не сразу с публичной аудитории.

Самый безопасный путь - не включать всё за один вечер. Настройте один маршрут, проверьте результат, включите журналы только для диагностики, затем добавьте второй маршрут или Private Notifications. Так плагин станет управляемой частью редакционного процесса, а не источником случайных сообщений и лишней тревоги в Telegram.