Интеграция Contact Form 7 с Zendesk Support

Zendesk for Contact Form 7

Интеграция Contact Form 7 с Zendesk Support: автоматическое создание тикетов при отправке формы, настройка полей для каждой формы отдельно, проверка подключения к API.

Описание

Zendesk for Contact Form 7 связывает ваш сайт на WordPress с Zendesk Support: при успешной отправке формы Contact Form 7 в Zendesk создаётся новый тикет с темой, текстом, email и именем заявителя (requester), приоритетом и тегами по вашим правилам.

Основные возможности

– Глобальные настройки Zendesk: поддомен, email входа в Zendesk, API-токен, теги по умолчанию для всех тикетов.
– Настройка для каждой формы CF7 отдельно: включение/выключение, соответствие полей формы полям тикета, приоритет, дополнительные теги, опция добавления URL страницы отправки в тело тикета.
– Тело сообщения можно брать из одного поля или отправить все поля формы одним текстом (режим __all__).
– Кнопка «Проверить подключение» на странице настроек (лёгкий запрос к API Zendesk).
– Лицензирование PluginHub: общий ключ в «Настройки → Общие», проверка домена и продукта на стороне PluginHub.
– Переводимый интерфейс (text domain zendesk-cf7, каталог languages).

Технические детали

– Используется Zendesk REST API v2 (создание тикетов POST /api/v2/tickets.json).
– Событие WordPress: wpcf7_before_send_mail (приоритет 20). Письмо CF7 и стандартное поведение формы не отменяются; при ошибке Zendesk тикет может не создаться, но отправка формы для посетителя обычно остаётся успешной — проверяйте настройки и логи при необходимости.
– Идентификатор тикета или текст ошибки при поддержке CF7 может быть добавлен в свойства результата отправки (add_result_props), если ваша версия CF7 это поддерживает.

Требования

– WordPress 5.8 или новее.
– PHP 7.4 или новее.
– Активный плагин Contact Form 7.
– Аккаунт Zendesk Support с возможностью создать API token для пользователя, под которым выполняются запросы.
– Действующая лицензия PluginHub для этого продукта (ключ задаётся один раз на сайт для всех плагинов PluginHub).

Установка и инструкция

Установка плагина

1. Загрузите папку плагина в wp-content/plugins/ (или установите ZIP через «Плагины → Добавить новый»).
2. Активируйте плагин Zendesk for Contact Form 7 в админке WordPress.
3. Убедитесь, что установлен и активирован Contact Form 7.

Шаг 1. Лицензия PluginHub

1. В админке откройте «Настройки → Общие».
2. Найдите поле Pluginhub License Key (или аналогичное, если оно добавлено другим плагином PluginHub).
3. Вставьте ключ лицензии, выданный для этого продукта на https://pluginhub.pro, и сохраните настройки.
4. Домен сайта для проверки берётся из адреса сайта (home URL); при смене ключа или домена проверка обновится автоматически в пределах кеша API.

Без активной лицензии: в консоли отображаются предупреждения, создание тикетов в Zendesk отключено, кнопка проверки подключения к Zendesk возвращает ошибку. Настройки форм и глобальные поля при этом можно сохранять.

Шаг 2. Данные Zendesk

1. В Zendesk: «Администрирование → Приложения и интеграции → API → Zendesk API» — создайте токен API для пользователя-агента.
2. Используйте тот же email, с которым этот пользователь входит в Zendesk (обычно email агента).
3. В WordPress откройте «Контакты → Zendesk» (подменю Contact Form 7).
4. Заполните:
   – Поддомен — только имя поддомена (например, mycompany для https://mycompany.zendesk.com), без https:// и без .zendesk.com (лишнее плагин обрежет).
   – Email входа в Zendesk — email пользователя, для которого создан токен.
   – API token — вставьте токен; он хранится в базе данных сайта. Рекомендуется отдельный токен для интеграции и периодическая ротация.
   – Теги по умолчанию — через запятую, например wordpress, contact_form_7. Они добавляются к каждому тикету.
5. Нажмите «Сохранить изменения».
6. Нажмите «Проверить подключение» — при успехе отобразится сообщение об успешном соединении.

Шаг 3. Настройка формы CF7

1. Откройте «Контакты → Контактные формы» и отредактируйте нужную форму.
2. В метабоксе «Zendesk ticket»:
   – Включите «Создавать тикет в Zendesk для этой формы».
   – Поле темы — имя поля CF7 для subject тикета (часто your-subject или своё).
   – Сообщение / тело — имя одного поля с текстом письма или значение __all__, чтобы в тикет попали все поля формы списком «ключ: значение».
   – Поле email заявителя — обычно your-email (должен быть валидный email).
   – Поле имени заявителя — обычно your-name.
   – Приоритет — low / normal / high / urgent.
   – Дополнительные теги — через запятую; добавляются к глобальным тегам.
   – При необходимости включите «Добавить URL страницы отправки в тело тикета».
3. Сохраните форму.

Шаг 4. Проверка на сайте

Отправьте тестовую заявку с фронтенда. В Zendesk должен появиться новый тикет с указанными полями и тегами.

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

– Фильтр возможности доступа к настройкам и метабоксу: zendesk_cf7_capability (по умолчанию manage_options или константа WPCF7_ADMIN_READ_WRITE_CAPABILITY, если задана).
– Идентификатор продукта в PluginHub: константа ZENDESK_CF7_PLUGINHUB_PLUGIN_ID в wp-config.php или фильтр zendesk_cf7_pluginhub_plugin_id.
– URL проверки лицензии (если нужен прокси/стенд): фильтр pluginhub_license_check_url в общем модуле pluginhub-license.php.

Частые вопросы

Нужен ли отдельный плагин Zendesk?

Нет. Плагин сам выполняет HTTPS-запросы к API Zendesk с вашего сервера WordPress.

Письмо Contact Form 7 всё ещё отправляется?

Да. Интеграция не отменяет стандартную отправку почты CF7 (если она настроена в форме). Создание тикета выполняется дополнительно.

Тикет не создаётся, что проверить?

– Активна ли лицензия PluginHub для этого продукта.
– Заполнены ли поддомен, email и токен; проходит ли «Проверить подключение».
– Включена ли галочка у конкретной формы и совпадают ли имена полей в метабоксе с именами полей в разметке формы CF7.
– Указано ли валидное поле email заявителя (без него тикет не создаётся).

Где хранится API-токен?

В опции zendesk_cf7_settings в таблице опций WordPress. При деинсталляции плагина опция удаляется (см. uninstall.php).

Удаляются ли настройки форм при удалении плагина?

Да: при удалении плагина через админку выполняется uninstall.php — удаляется глобальная опция и мета _zendesk_cf7 у всех контактных форм CF7.

Скриншоты

1. Страница «Контакты → Zendesk»: учётные данные, теги по умолчанию, проверка подключения.
2. Метабокс «Zendesk ticket» в редакторе формы CF7.

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

1.0.3
– Ограничение создания тикетов и теста API при неактивной лицензии PluginHub; предупреждения в админке и в метабоксе формы.
– Явная проверка SSL для запросов к Zendesk (sslverify).

1.0.2
– Подключение лицензирования PluginHub, общий pluginhub-license.php, класс Zendesk_CF7_License.

1.0.1
– Исправление: использование add_result_props вместо несуществующего в CF7 метода add_meta для передачи результата в submission.

1.0.0
– Первый публичный релиз: глобальные настройки, метабокс на форме, создание тикетов через API v2.

Рекомендация при обновлении

1.0.3 — рекомендуется обновление: корректная работа с лицензией PluginHub и безопасные HTTPS-запросы к Zendesk.