WordPress и Telegram: публикации, заявки и бот
Кратко: WordPress вызывает Telegram Bot API по событию — новая публикация, отправленная форма или
смена статуса — и отправляет сообщение в канал, группу или личный чат. Обратное направление работает
через вебхук: бот принимает сообщение и передаёт его на сайт. Уровень проверки documented:
возможности подтверждены документацией WordPress и Telegram Bot API.
- Задача: доставлять события сайта в Telegram и принимать сообщения бота на стороне WordPress без отдельного сервиса.
- Что проверено: хуки WordPress, HTTP API для исходящих запросов, методы
sendMessageиsetWebhook, ограничения длины сообщений и необходимостьchat_id. - Уровень: documented.
- Что не проверено: поведение конкретных плагинов форм и тем на вашей версии WordPress.
Когда нужна интеграция
Заголовок раздела «Когда нужна интеграция»Интеграция нужна, когда команда живёт в Telegram: заявки с сайта должны приходить в рабочий чат, а публикации — автоматически попадать в канал. Второй сценарий — бот как вход: клиент пишет боту, а сайт создаёт заявку или комментарий.
Обратные случаи:
- Нужны только email-уведомления — встроенной почты WordPress достаточно, Telegram не нужен.
- Нужна переписка с клиентом в CRM — это связка Telegram с Битрикс24: Битрикс24 и Telegram, а не сайт.
- Нужен публичный канал без сайта — бот и канал настраиваются без WordPress.
Сценарии
Заголовок раздела «Сценарии»Новая публикация → пост в Telegram-канале
Заголовок раздела «Новая публикация → пост в Telegram-канале»- Событие: запись опубликована или обновлена; срабатывает хук
transition_post_statusилиsave_post. - Направление: WordPress → Telegram.
- Сущности: публикация, заголовок, ссылка, изображение, канал.
- Результат: в канале появляется сообщение с заголовком, ссылкой и обложкой; черновики и запланированные записи не отправляются раньше времени.
Отправка формы → уведомление в рабочем чате
Заголовок раздела «Отправка формы → уведомление в рабочем чате»- Событие: посетитель отправляет форму; срабатывает хук плагина форм.
- Направление: WordPress → Telegram.
- Сущности: заявка, поля формы, страница-источник,
chat_id. - Результат: менеджер получает сообщение в группе или личном чате с данными заявки; сайт не ждёт ответа Telegram и не показывает посетителю ошибку при сбое доставки.
Сообщение боту → заявка на сайте
Заголовок раздела «Сообщение боту → заявка на сайте»- Событие: клиент пишет боту; Telegram вызывает HTTPS-endpoint сайта.
- Направление: Telegram → WordPress.
- Сущности: сообщение,
update_id, пользователь, заявка. - Результат: сайт проверяет секрет вебхука, создаёт заявку или комментарий и отвечает клиенту через
sendMessage; повторная доставка того жеupdate_idне создаёт дубль.
Отложенная публикация → сообщение по расписанию
Заголовок раздела «Отложенная публикация → сообщение по расписанию»- Событие: запись запланирована на будущее.
- Направление: WordPress → Telegram.
- Сущности: расписание, публикация, сообщение.
- Результат: сообщение уходит в момент публикации через WP-Cron; при выключенном планировщике отправка задерживается до первого запроса к сайту.
Триггеры и действия
Заголовок раздела «Триггеры и действия»| Событие в WordPress | Действие в Telegram | Примечание |
|---|---|---|
transition_post_status |
sendMessage в канал или группу |
Отправлять только publish |
Хук формы (wpcf7_mail_sent, wpforms_process_complete) |
sendMessage с полями заявки |
Не блокировать ответ посетителю |
| Регистрация или комментарий | Уведомление администратору | Не отправлять персональные данные без необходимости |
| Запланированная запись | Сообщение через WP-Cron | Зависит от трафика сайта |
| Событие в Telegram | Действие в WordPress | Примечание |
|---|---|---|
| Сообщение боту | POST на endpoint сайта |
Проверять секрет и update_id |
| Команда бота | Создание заявки или ответ | Команды описываются в setMyCommands |
| Ошибка доставки | Повтор из очереди | Учитывать код 429 и таймауты |
Варианты реализации
Заголовок раздела «Варианты реализации»- Плагин — готовое решение с настройкой шаблона сообщения и получателей; например, WP Telegram умеет публиковать записи в канал и пересылать уведомления. Критерий выбора: поддержка вашей версии WordPress и вашего плагина форм.
- Небольшой MU-плагин — обработчик хука вызывает
wp_remote_post()кapi.telegram.orgс токеном бота иchat_id. Даёт контроль над повторами, журналом и форматом; требует сопровождения. - iPaaS — связывает сайт и Telegram без кода, но добавляет внешний сервис и его тарифы.
- Серверный воркер — забирает события из очереди и отправляет их в Telegram; нужен при большом потоке заявок и гарантированной доставке.
Если правил больше двух — фильтр по рубрикам, разный чат для разных форм, повтор при сбое — небольшой собственный плагин обычно проще, чем настройка чужого.
Данные и соответствие полей
Заголовок раздела «Данные и соответствие полей»| Данные в WordPress | Куда попадают в Telegram | Ключ соответствия | Примечание |
|---|---|---|---|
| Заголовок и ссылка записи | Текст сообщения и inline-кнопка | ID записи | Ссылка обязана быть абсолютной |
| Обложка записи | Фото или превью ссылки | ID вложения | Не все форматы принимаются |
| Поля формы | Текст сообщения | chat_id получателя |
Длинный текст сокращается |
chat_id канала или группы |
Адрес получателя | — | Бот должен быть добавлен в чат |
| Токен бота | Заголовок запроса | — | Хранится только на сервере |
update_id |
Идентификатор входящего обновления | Ключ идемпотентности | Защищает от дублей |
Владелец данных: WordPress владеет контентом, заявками и согласиями; Telegram — доставкой сообщений и идентификаторами чатов. Переписка в Telegram не заменяет журнал заявок на сайте.
Перед запуском
Заголовок раздела «Перед запуском»- Создать бота у
@BotFatherи сохранить токен в серверной конфигурации. - Добавить бота в канал или группу и получить
chat_id. - Определить, какие события отправляются: публикации, формы, регистрации.
- Для входящих сообщений поднять HTTPS-endpoint и вызвать
setWebhookс секретом. - Настроить журнал: событие, получатель, код ответа,
update_id. - Прогнать на staging: публикация, заявка, сообщение боту, повторная доставка, недоступный Telegram.
Ограничения и надёжность
Заголовок раздела «Ограничения и надёжность»- Длина сообщения. У Telegram есть лимит на текст сообщения; длинные заявки и описания делятся на части или сокращаются.
chat_idобязателен. Бот не может написать в чат, куда его не добавили; для канала бот должен быть администратором.- Вебхук. Telegram вызывает только HTTPS-адрес; endpoint проверяет секрет и отвечает быстро, иначе доставка повторяется.
- Повторы. Одинаковые обновления и повторные публикации создают дубли: нужен ключ идемпотентности
(
update_id, ID записи и тип события). - Лимиты и 429. При частых запросах Bot API отвечает ошибкой лимита; отправка идёт порциями и с задержкой.
- Блокировка Telegram. На части хостингов исходящие запросы к Telegram блокируются; тогда нужен прокси или другой канал доставки.
- WP-Cron. Отложенные задачи выполняются только при запросах к сайту: на слабом трафике сообщение может задержаться.
Вопросы и ответы
Заголовок раздела «Вопросы и ответы»Нужен ли сервер для приёма сообщений бота? Да, для обратного направления нужен публичный HTTPS-endpoint. Только исходящие уведомления работают без него.
Можно ли отправлять в несколько каналов?
Да, если интеграция хранит несколько chat_id и правил маршрутизации. Готовые плагины часто ограничивают
это платной версией.
Почему сообщение не пришло?
Проверьте токен, chat_id, права бота в чате, журнал HTTP-ответов и не блокирует ли хостинг Telegram.
Как не задублировать заявки?
Сохраняйте update_id входящих обновлений и ID публикации для исходящих; повтор с тем же ключом
пропускается.
Решения
Заголовок раздела «Решения»- WP Telegram: автопост и уведомления между WordPress и Telegram — Бесплатный плагин, который публикует записи WordPress в Telegram-каналы и пересылает уведомления сайта в чат; Pro добавляет правила и реакции.