Message Bridge for Contact Form 7 and Telegram

Описание

Этот плагин позволяет отправлять сообщения из Contact Form 7 в чаты Telegram через бота. Настройка занимает всего несколько шагов:

  1. Создайте Telegram-бота (как это сделать, англ.).
  2. Создайте бота в пользовательском интерфейсе плагина.
  3. Вставьте токен бота в форму бота (также доступны PHP-константы).
  4. Создайте мост в интерфейсе плагина. Мост связывает формы Contact Form 7, бота Telegram и одного или нескольких получателей в Telegram.
  5. Добавьте пользователей в список подписчиков, отправив боту команду /cf7tg_start. Чтобы добавить группу, сначала добавьте туда бота, а затем отправьте в этой группе команду /cf7tg_start.
  6. Одобрите или отклоните запросы на подписку на странице настроек в Contact Form 7 CF7 Telegram.
  7. Настройте мост: выберите, какие формы он обрабатывает и какие получатели Telegram должны получать эти сообщения. Создайте как минимум один мост, чтобы запустить интеграцию, и добавьте больше, если разные формы должны отправлять сообщения разным наборам получателей Telegram.

Интеграция настроена правильно, когда панель бота выделена синим цветом, а панель моста — зеленым.

Хуки и константы

Фильтр wpcf7tg_skip_tg
Используйте его, чтобы пропустить отправку сообщения в Telegram.

Фильтр wpcf7tg_markdown
Используйте его, чтобы настроить разрешённые метки Markdown.

Фильтр wpcf7tg_sendMessage( $args, $chat_id, $mode )
Используйте его, чтобы настроить аргументы Telegram sendMessage для каждого получателя и фрагмента сообщения.

Действие wpcf7tg_message_sent( $args, $submission )
Выполняется после каждой попытки доставки в Telegram. Сбой отправки в Telegram не прерывает отправку формы Contact Form 7.

Действие wpcf7tg_messages_sent( $list, $output, $mode, $submission )
Выполняется после попытки отправки всем настроенным получателям.

Константа WPCF7TG_LOG_RETENTION_DAYS и фильтр cf7tg/logRetentionDays
Устанавливают срок хранения журнала в днях. По умолчанию — 30; установите 0, чтобы отключить удаление по сроку давности.

Константа WPCF7TG_LOG_MAX_ROWS и фильтр cf7tg/logMaxRows
Установите максимальное количество самых новых строк журнала для хранения. Значение по умолчанию — 10000.

Константы WPCF7TG_PING_INTERVAL и WPCF7TG_UPDATES_INTERVAL
Задают интервал повторной попытки отклика при офлайн-статусе бота и интервал опроса обновлений Telegram при онлайн-статусе в миллисекундах. Значения по умолчанию — 5000 и 12000 соответственно.

Плагин использует API Telegram для отправки HTTP-запросов серверам Telegram.

Скриншоты

Отзывы

07.09.2026 2 ответа
Отже вирішив оновити з 0.8.1 до 1.1.0, довелося все підправити (не підхопилися налаштування), і був здивований, коли на одній і тій же формі різних мов, зв'язаних через WPML форма не працювала на іншій мові… Відкачую до 0.8.1 і буду очікувати на фікс. Дякую розробнику все одно, за працю і старання випустити найліпший продукт. Успіхів.
24.03.2026 2 ответа
Плагин полезный. Не сложный. Был рабочий. Но зачем-то его кардинально переделали и он перестал работать. То есть просто нет связи с ботом по api и всё. Так что ставьте ту версию 0.11 которая еще называлась Contact Form 7 + Telegram, она работает стабильно на разных сайтах.
03.02.2026 2 ответа
Проходиш міграцію чи встановлюєш нові налаштування і нічого не працює, підключився після перезагрузки сторінки налаштування злітають. Форми не працюють — в тг не відправляє
02.02.2026 3 ответа
После обновления плагин посыпался. Боты сбрасываются, сначала работают , через минуту настройки ломаются, боты и чаты пропадают из интерфейса. Верните прежнюю версию, плиз!Внимание! Проверено на двух темах — Вудмарт и на самописной теме "чистой"! Проблема именно в плагине!
31.01.2026 1 ответ
After the plugin update, the shortcode used in CF7 forms was removed. As a result, it is now displayed as plain text inside the form. When releasing such updates, it is important to provide migrations and maintain backward compatibility. If functionality is removed, a fallback or automatic replacement mechanism should be left in place to avoid breaking existing forms.
28.01.2026 1 ответ
Крутой плагин, пару лет работал, обновился и отпал на всех сайта, любые махинации не поднимают, пишет все активно, все подключено и заявки не идут, новая версия с багом
Посмотреть все 22 отзыва

Участники и разработчики

«Message Bridge for Contact Form 7 and Telegram» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

«Message Bridge for Contact Form 7 and Telegram» переведён на 8 языков. Благодарим переводчиков за их работу.

Перевести «Message Bridge for Contact Form 7 and Telegram» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

1.1.0

  • Add fake Telegram browser E2E coverage for form delivery, admin setup, partial delivery failures, and CI evidence collection.
  • Rename user-facing Channel terminology to Bridge across the admin UI and guide, with bridge and bot setup guidance.
  • Добавить элементы управления отображаемыми именами в чате, чтобы администраторы могли задавать произвольные имена и восстанавливать имена, предоставленные Telegram.

1.0.13

  • Make Telegram bot actions POST-first and harden the administration interface against partial loading, pagination, and retry failures.
  • Restore the full-page administration background, hide unrelated WordPress notices on the plugin screen, and improve diagnostics without exposing bot tokens or contact details.
  • Ignore transient Telegram polling timeouts in the interface and use a 12-second default update polling interval.
  • Add automatic 30-day and 10,000-row log retention with configurable limits.
  • Verify the release ZIP across supported WordPress, PHP, and Contact Form 7 versions, including install, upgrade, uninstall, and rollback workflows.
  • Add reproducible build, Plugin Check, dependency audit, artifact hygiene, browser canary, and manually approved WordPress.org promotion gates.

1.0.12

  • Replace the Telegram SDK with a smaller WordPress HTTP integration and safer error handling.
  • Validate bot tokens before saving them and preserve existing chat connections when the bot identity is unchanged.
  • Make update polling webhook-aware and prevent failed updates from being skipped.
  • Load every page of Telegram chats in the administration interface.
  • Improve Unicode message chunking, plaintext fallback, multi-recipient delivery, and legacy hook compatibility.

1.0.11

  • Make legacy migrations self-healing, retryable, and safe to run repeatedly.
  • Preserve Contact Form 7 content while migrating bots, chats, channels, and form connections without duplicates.
  • Keep bot tokens defined through PHP constants out of stored plugin data.
  • Replace destructive load-time cleanup with conservative repair and recovery controls.

1.0.10

  • Add maintenance cleanup for orphan chats and broken relations.
  • Fix fatal error on CF7 submission when a channel has chats but no connected bot (#56).

1.0.9

  • Remove external update controls.

1.0.8

  • Harden Telegram chat sanitization and update polling.

1.0.7

  • Prevent duplicate chat subscriptions when bot updates are fetched concurrently.

1.0.6

  • Fix truncated bot name copy.

1.0.5

  • Race condition in chats loading fixed.

1.0.4

  • Minor fixes.

1.0.3

  • Fix translation loading issue.

1.0.2

  • Manual migration button added.
  • Migration process improved.

1.0.1

  • Fix react template.

1.0.0

  • New UI for managing channels and bot token.
  • New plugin name was chosen to comply with new WordPress guidelines.

0.10.0

  • Beta testing is available for everyone.

0.9.3

  • Preparing for beta testing.

0.9.2

  • Loading textdomain fixed — moved to init hook.
  • Array undefined key fixed.

0.9.1

  • Version never released.

0.9

  • Preparing to v1.0 seamless transition.

0.8.7

  • API Telegram errors logging added.

0.8.6

  • Security issue CVE-2024-9629 got fixed.

0.8.5

  • PHP 7.2 compatibility fixed.

0.8.4

  • Markdown symbols escaping got added in order to fix an issue.

0.8.3

  • Blueprint got added.

0.8.2

  • Donation link got changed.
  • tested up to WP 6.5

0.8.1

  • Actualize add-on sale date.

0.8

  • Доступны дополнения

0.7.10

  • Preparing for attachment sending
  • Немного исправлений

0.7.9

  • Markdown for HTML-format issue

0.7.7

  • Support WP 5.3 functions for WP before 5.3

0.7

  • New interface recipient management
  • Groups are supported
  • WPCF7_ContactForm::prop( ‘mail’ ) instead WPCF7_ContactForm::$mail
  • FIXED Dependence parse_mode by use_html property

0.6.2

  • Trim for CHAT_ID field elements added

0.6.1

  • Markdown bug fixed

0.6

  • Message to telegram now sends on wpcf7_before_send_mail hook instead wpcf7_mail_sent. It is more reliable way.
  • wpcf7tg_skip_tg added.
  • wpcf7tg_markdown added.
  • WPFC7TG_BOT_TOKEN added.
  • bugs fixed

0.5

  • Markdown added