Перейти к содержимому

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.
  • Событие: запись опубликована или обновлена; срабатывает хук 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 публикации для исходящих; повтор с тем же ключом пропускается.