Отправка форм в MAX

Описание

В английской версии каталога плагин называется LeadSender for MAX.

«Отправка форм в MAX» доставляет каждую новую заявку с вашего сайта на WordPress в один или несколько чатов или групп мессенджера MAX — команда видит новые заявки через несколько секунд.

Плагин не связан с мессенджером MAX и его владельцами и не одобрен ими. «MAX» упоминается только как название сервиса, с которым работает плагин.

Сайт плагина: wp-addon.ru/leadsender-for-max

Возможности

• Fluent Forms — заявка берётся сразу после сохранения записи, даже если email-уведомления выключены.
• Contact Form 7 — заявка дойдёт до MAX, даже если сайт не смог отправить письмо.
• Любые другие формы (Elementor, WPForms, формы темы) — через перехват wp_mail с фильтрами по адресу получателя и теме письма. Системные письма WordPress и WooCommerce пропускаются.
• Любое число чатов — каждая заявка уходит во все включённые чаты.
• Мгновенная доставка — каждая заявка уходит отдельным сообщением сразу после отправки формы. Посетитель не ждёт: отправка идёт уже после ответа страницы.
• Содержимое сообщения — название формы, сайт, все заполненные поля и время отправки.
• Надёжность — очередь с автоматическими повторами и письмо администратору, если доставка не удалась.
• Мастер настройки — проверка токена бота, автоматический поиск ID чата, тестовое сообщение.
• Российские доверенные корневые сертификаты — если хостинг не доверяет сертификату API MAX, загрузите файлы сертификатов в настройках, и плагин будет использовать их для запросов к MAX.
• В конце каждого сообщения — короткая подпись со ссылкой на сайт плагина.

Интерфейс плагина на русском языке.

Pro-дополнение

Отдельное платное дополнение доступно на wp-addon.ru/leadsender-for-max. Оно ставится как отдельный плагин и добавляет:

• Источник заявки: реклама, UTM-метки, yclid, реферер, страница входа, ClientID Яндекс Метрики.
• Страница формы, устройство, IP-адрес, ссылка на заявку в админке.
• Кнопки под сообщением: скопировать телефон, скопировать e-mail, открыть заявку.
• Заказы WooCommerce.
• Антиспам.
• Распределение заявок по разным чатам в зависимости от формы.
• Настройки сообщения: заголовок, блоки, скрытие полей, тихие уведомления, сообщение без подписи.
• Журнал доставки с повторной отправкой вручную.

Внешние сервисы

Плагин подключается к одному стороннему сервису. Без него плагин не может доставлять заявки.

MAX Bot API (platform-api2.max.ru) — API мессенджера MAX, предоставляется сервисом MAX (legal.max.ru).

• Зачем: отправка заявок в чаты MAX, проверка токена бота, поиск ID чата.
• Какие данные передаются: токен бота; значения полей отправленной формы (например, имя, телефон, e-mail, сообщение); название сайта и формы; время отправки.
• Когда: при каждой новой заявке, а также когда администратор нажимает «Проверить соединение», «Найти мой чат» или «Отправить тестовое сообщение».
• Условия использования: https://legal.max.ru/ps
• Политика конфиденциальности: https://legal.max.ru/pp
• Документация API: https://dev.max.ru/docs-api

Сам плагин ничего не скачивает. Российские доверенные корневые сертификаты, если они нужны вашему хостингу, администратор загружает вручную (они опубликованы на https://www.gosuslugi.ru/crt).

Пересылка заявок в MAX означает передачу персональных данных посетителей оператору мессенджера. Укажите это в политике конфиденциальности сайта.

Для разработчиков

Фильтры: lsfm/sources, lsfm/lead (верните false, чтобы пропустить заявку), lsfm/lead_context, lsfm/recipients, lsfm/send_at, lsfm/format_group, lsfm/message_attachments, lsfm/send_args, lsfm/wpmail/should_capture, lsfm/http_args, lsfm/settings_defaults, lsfm/save_settings.
Действия: lsfm/queued, lsfm/sent, lsfm/failed.

Добавьте свою форму:

add_action( 'my_form_submitted', function ( $data ) {
    LSFM_Collector::add( array(
        'source'     => 'my-form',
        'form_title' => 'Calculator',
        'fields'     => array(
            array( 'label' => 'Phone', 'value' => $data['phone'] ),
        ),
    ) );
} );