﻿---
title: "Telegram и WordPress: бот принимает сообщения и публикует записи"
description: Telegram-бот передаёт сообщения на WordPress, а сайт отвечает публикацией в канале и уведомлением в чат.
---

**Кратко:** В этой связке Telegram — вход для сообщений и канал доставки, а WordPress принимает данные и публикует записи.

## Кратко

- **Задача:** доставлять события сайта в Telegram и принимать сообщения бота на стороне WordPress без
  отдельного сервиса.
- **Что проверено:** хуки WordPress, HTTP API для исходящих запросов, методы `sendMessage` и `setWebhook`,
  ограничения длины сообщений и необходимость `chat_id`.
- **Уровень:** documented.
- **Что не проверено:** поведение конкретных плагинов форм и тем на вашей версии WordPress.

## Когда нужна интеграция

Интеграция нужна, когда команда живёт в Telegram: заявки с сайта должны приходить в рабочий чат, а
публикации — автоматически попадать в канал. Второй сценарий — бот как вход: клиент пишет боту, а сайт
создаёт заявку или комментарий.

Обратные случаи:

- **Нужны только email-уведомления** — встроенной почты WordPress достаточно, Telegram не нужен.
- **Нужна переписка с клиентом в CRM** — это связка Telegram с Битрикс24:
  [Битрикс24 и Telegram](https://wpcraft.ru/integrations/bitrix24/telegram.md), а не сайт.
- **Нужен публичный канал без сайта** — бот и канал настраиваются без WordPress.

## Сценарии

### Новая публикация → пост в 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](https://wordpress.org/plugins/wptelegram/) умеет публиковать записи в канал и
  пересылать уведомления. Критерий выбора: поддержка вашей версии 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](https://wpcraft.ru/integrations/solutions/wp-telegram.md) — Бесплатный плагин, который публикует записи
  WordPress в Telegram-каналы и пересылает уведомления сайта в чат; Pro добавляет правила и реакции.

## Источники

- [WordPress Plugin Handbook: Hooks](https://developer.wordpress.org/plugins/hooks/)
- [WordPress HTTP API](https://developer.wordpress.org/plugins/http-api/)
- [Telegram Bot API](https://core.telegram.org/bots/api)