Описание
Этот плагин позволяет отправлять сообщения из Contact Form 7 в чаты Telegram через бота. Настройка занимает всего несколько шагов:
- Создайте Telegram-бота (как это сделать, англ.).
- Создайте бота в пользовательском интерфейсе плагина.
- Вставьте токен бота в форму бота (также доступны PHP-константы).
- Создайте мост в интерфейсе плагина. Мост связывает формы Contact Form 7, бота Telegram и одного или нескольких получателей в Telegram.
- Добавьте пользователей в список подписчиков, отправив боту команду
/cf7tg_start. Чтобы добавить группу, сначала добавьте туда бота, а затем отправьте в этой группе команду/cf7tg_start. - Одобрите или отклоните запросы на подписку на странице настроек в Contact Form 7 CF7 Telegram.
- Настройте мост: выберите, какие формы он обрабатывает и какие получатели 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.
Скриншоты


Отзывы
Участники и разработчики
«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_mailhook insteadwpcf7_mail_sent. It is more reliable way. wpcf7tg_skip_tgadded.wpcf7tg_markdownadded.WPFC7TG_BOT_TOKENadded.- bugs fixed
0.5
- Markdown added
