Когда посетитель отправляет форму на сайте WordPress, стандартный способ уведомления — электронное письмо. Email надежен, но его легко пропустить, особенно если владелец сайта или служба поддержки проверяет почту всего несколько раз в день. Для команд, которые активно используют мессенджеры, отправка уведомлений о формах в Telegram позволяет быстрее получать новые заявки, обращения в поддержку или бронирования прямо в чат, который сотрудники регулярно просматривают.
В этой статье разберем, как связать WordPress и Telegram для получения уведомлений из форм, что потребуется для настройки, как настроить доставку через FormCourier Notifications Pro и как устранить проблемы, если уведомления не приходят.
Как WordPress и Telegram могут работать вместе
Плагины форм WordPress, такие как Contact Form 7, WPForms, Fluent Forms, Forminator, Ninja Forms и Gravity Forms, принимают отправленные данные и по умолчанию пересылают их по электронной почте. Интеграция WordPress с Telegram добавляет еще один канал доставки: вместо email или одновременно с ним отправленные данные передаются в виде сообщения в чат, группу или канал Telegram через Telegram Bot API — интерфейс Telegram для программной отправки и получения сообщений с помощью бота.
Чтобы это работало, между плагином формы и Telegram нужен связующий механизм: он должен определить новую отправку формы, получить нужные поля, сформировать из них понятное сообщение и отправить HTTP-запрос на серверы Telegram. FormCourier Notifications Pro создан именно для этой задачи. Он обрабатывает отправки из поддерживаемых плагинов форм, форматирует данные с помощью шаблона сообщения и доставляет их в одно или несколько настроенных направлений Telegram в зависимости от того, как для формы настроены Form Routes и Advanced Routing. Благодаря этому настройка уведомлений Telegram для WordPress не требует разработки собственной интеграции.
Как работает отправка уведомлений из WordPress в Telegram
На высоком уровне уведомление WordPress в Telegram проходит по одной последовательной схеме: посетитель отправляет форму, плагин получает переданные поля, проверяет, применяется ли к этой форме определенный Form Route или правило Advanced Routing, формирует сообщение по шаблону с фактическими данными заявки и отправляет результат в подходящее направление Telegram. Результат — успешная доставка, ошибка или повторная попытка — затем записывается в журнал доставки, который рассматривается далее в статье.
Что нужно для отправки форм WordPress в Telegram
Перед настройкой WordPress необходимо подготовить несколько компонентов со стороны Telegram и плагина:
- Поддерживаемый плагин форм WordPress. FormCourier Notifications Pro работает с Contact Form 7, WPForms, Fluent Forms, Forminator, Ninja Forms и Gravity Forms.
- Telegram-бот. Боты создаются вне WordPress с помощью BotFather в Telegram. FormCourier Notifications Pro не создает бота самостоятельно — это разовое действие, которое выполняется непосредственно в Telegram.
- Bot Token. Это учетные данные, которые BotFather выдает для бота. Токен используется для аутентификации запросов к Telegram Bot API.
- Chat ID. Он определяет конкретный чат, группу или канал, куда должны приходить сообщения. Бот должен иметь доступ к этому чату — его необходимо добавить в группу или канал либо начать с ним диалог, если используется личный чат, прежде чем он сможет отправлять туда сообщения.
- Установленный и активированный FormCourier Notifications Pro с хотя бы одним настроенным направлением Telegram, где указаны Bot Token и Chat ID.
Эта комбинация — Telegram-бот для WordPress, его токен и Chat ID — является минимальным набором для работы любого направления Telegram, независимо от того, используется ли оно как направление по умолчанию или назначено конкретной форме.
Как отправлять данные форм WordPress в Telegram
После создания бота и чата настройка передачи данных из WordPress в Telegram через FormCourier Notifications Pro выполняется в несколько шагов:
- Создайте Telegram-бота через BotFather и скопируйте созданный Bot Token.
- Добавьте бота в нужный чат — группу, канал или личный диалог, чтобы он мог отправлять туда сообщения.
- Получите Chat ID нужного направления — обычно для этого отправляют сообщение в чат и проверяют последние обновления бота.
- Добавьте новое направление Telegram в FormCourier Notifications Pro, указав Bot Token и Chat ID.
- Назначьте направление — установите его как направление Telegram по умолчанию для сайта или привяжите к определенной форме через Form Route.
- Отправьте тестовое сообщение из настроек направления, чтобы убедиться, что бот действительно может отправлять сообщения в этот чат, прежде чем использовать его для реальных заявок.
После этого подходящие отправки форм автоматически форматируются и передаются в Telegram, а результаты доставки фиксируются в журнале.
Настройка сообщений Telegram для отправок форм
Необработанные данные формы сложно быстро воспринимать, поэтому FormCourier Notifications Pro перед отправкой формирует каждое уведомление по шаблону сообщения. Для всех форм используется шаблон по умолчанию, а для отдельных форм можно задать собственный шаблон, который имеет приоритет. Если индивидуальный шаблон для формы не настроен, автоматически используется шаблон по умолчанию.
Шаблоны поддерживают плейсхолдеры, которые при отправке заменяются фактическими значениями:
- {form_provider} / {provider} — плагин формы, из которого поступила заявка
- {form_id} / {form_name} — какая форма была отправлена
- {destination} — направление, в которое было отправлено сообщение
- {submitted_at} — время отправки формы
- {all_fields} — отформатированный блок с подготовленными данными формы
- {page_url}, {site_name}, {site_url} — информация о странице и сайте, где была отправлена форма
- {date}, {time} — отдельные значения даты и времени
- {field:FIELD_NAME} — значение конкретного обнаруженного поля формы
{field:FIELD_NAME} полезен, когда в сообщении нужно отдельно показать конкретный ответ — например, номер телефона или выбранную услугу — вместо вывода всех полей. Точный идентификатор поля зависит от того, как конкретная форма и ее плагин называют это поле во внутренней структуре, поэтому перед использованием определенного плейсхолдера на рабочем сайте стоит проверить его с помощью тестовой отправки.
Сообщения Telegram также поддерживают собственное HTML-форматирование Telegram, поэтому в шаблонах можно использовать жирный текст, ссылки и переносы строк, чтобы длинные заявки было удобнее читать в чате.
Отправляйте данные форм WordPress напрямую в Telegram с FormCourier Notifications Pro
Отправка разных форм WordPress в разные чаты Telegram
На сайте редко используется только одна форма для одной задачи. Контактная форма, запрос стоимости и форма обращения в поддержку обычно предназначены для разных сотрудников или отделов — и FormCourier Notifications Pro поддерживает несколько направлений Telegram вместо одного фиксированного чата.
Куда будет отправлена заявка, определяют два механизма:
- Form Routes назначают конкретное направление или набор направлений для определенной формы. Если для формы маршрут не настроен, используется соответствующее направление по умолчанию.
- Advanced Routing добавляет условную логику, анализируя фактические значения отправленных полей. Правила могут требовать выполнения всех условий (ALL / AND) или только одного (ANY / OR). При совпадении правило может либо добавить направления к уже выбранным через Form Route, либо полностью заменить направления. Priority определяет порядок обработки правил, а Stop Processing позволяет после совпадения текущего правила прекратить выполнение последующих правил.
На практике это важное различие: Form Route определяет базовое направление для конкретной формы, а Advanced Routing учитывает фактически отправленные данные — например, заявки на крупные проекты можно направлять в один чат, а обычные обращения — в другой в зависимости от значения определенного поля.
| Параметр | Form Route | Advanced Routing |
|---|---|---|
| Что анализируется | Сама форма | Значения отправленных полей |
| Условная логика | Нет | Да (ALL/AND, ANY/OR) |
| Работа с направлениями | Назначает направления форме | Может добавлять или заменять направления |
| Порядок выполнения | Применяется для конкретной формы | Определяется через Priority, выполнение можно остановить с помощью Stop Processing |
| Типичный сценарий | «Эта форма отправляется в этот чат Telegram» | «Эта форма отправляется сюда, если значение поля не указывает другое направление» |
Проверка уведомлений Telegram и журнала доставки
Прежде чем использовать направление для реальных заявок, FormCourier Notifications Pro позволяет отправить тестовое сообщение непосредственно из его настроек. Это помогает проверить правильность Bot Token и Chat ID, а также убедиться, что бот действительно может отправлять сообщения в выбранный чат.
Для постоянного контроля используется журнал доставки, в котором фиксируется каждая попытка отправки уведомления. В нем отображаются канал уведомлений, направление, плагин формы, форма, статус, время, количество попыток, HTTP-статус, полученный от Telegram, ответ провайдера, последняя ошибка при ее наличии, состояние повторной отправки и время следующей запланированной попытки. Журнал можно фильтровать по каналу, плагину формы, статусу или направлению, выполнять текстовый поиск, ограничивать записи диапазоном дат, экспортировать данные в CSV и просматривать большие объемы записей постранично. Сводные счетчики позволяют быстро оценить состояние доставки без открытия отдельных записей. Старые записи журнала также могут удаляться автоматически, чтобы они не накапливались бесконечно.
Устранение ошибок при отправке уведомлений из WordPress в Telegram
Большинство проблем с доставкой связано с несколькими типичными причинами, а запись о неудачной попытке в журнале обычно помогает сразу определить источник ошибки:
- Бот не добавлен в чат — Chat ID указан правильно, но сам бот не был добавлен в качестве участника, поэтому Telegram отклоняет запрос.
- Неверный Chat ID или Bot Token — ошибка при копировании данных во время настройки. HTTP-статус и ответ провайдера в журнале обычно указывают на ошибку аутентификации или сообщение «chat not found».
- Ограничения частоты запросов — Telegram ограничивает частоту отправки сообщений ботом в чат, поэтому большое количество заявок за короткое время может вызвать временное ограничение.
- Удаленный или недоступный чат — если группа удалена или бот был исключен после настройки, доставка перестанет работать, пока не будет настроено новое направление.
- Временные сетевые или серверные ошибки — кратковременные проблемы с подключением на одной из сторон.
При временных проблемах — сетевых сбоях, ограничениях частоты запросов и некоторых кратковременных серверных ошибках — FormCourier Notifications Pro автоматически повторяет доставку через WP-Cron, увеличивая интервалы между попытками. Неудачное уведомление также можно повторно отправить вручную из журнала. Постоянные ошибки конфигурации, например недействительный токен или отсутствие у бота доступа к чату, невозможно исправить одной повторной попыткой — сначала необходимо изменить настройки направления. Чтобы повторная отправка была возможна без необходимости просить посетителя заново заполнять форму, при неудачной доставке может временно сохраняться минимальный набор данных, необходимый для следующей попытки. Эти данные предназначены для восстановления доставки, а не для создания полноценного архива заявок. Журнал доставки фиксирует процесс отправки уведомлений и не является CRM-базой.
FAQ
