Интеграция WPForms с Zendesk Support

Zendesk for WPForms

Интеграция WPForms с Zendesk Support: создание тикетов после успешной отправки формы, глобальные учётные данные Zendesk, выбор всех форм или отдельных, проверка подключения к API.

Описание

Плагин Zendesk for WPForms подключает сайт на WordPress к Zendesk Support. После успешной отправки формы WPForms на стороне Zendesk создаётся новый тикет: тема собирается из префикса (если задан), названия формы и номера записи (entry); в теле тикета перечислены поля отправки; заявитель (requester) определяется по email из формы (обязательно наличие валидного поля типа Email или значения, похожего на email).

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

– Подключение к Zendesk по поддомену, email пользователя Zendesk и API-токену.
– Режим форм: все текущие и будущие формы WPForms или только отмеченные в списке.
– Включение и выключение интеграции одним переключателем.
– Префикс темы тикета, приоритет по умолчанию (low, normal, high, urgent), дополнительные теги через запятую; к тегам автоматически добавляются wpforms и wpforms-form-ID.
– Кнопка «Test connection» на странице настроек (запрос к API users/me).
– Лицензия PluginHub: ключ вводится в блоке «PluginHub license» на странице «Настройки → Zendesk WPForms» (опция pluginhub_license_key в базе; совпадает с ключом других плагинов PluginHub на сайте). Без активной лицензии для данного товара тикеты не создаются и тест подключения недоступен (остальные настройки сохранять можно).
– Локализация: каталог languages с файлами .po (для загрузки переводов нужны скомпилированные .mo).

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

– Событие WPForms: wpforms_process_complete, приоритет 50.
– Создание тикета: POST /api/v2/tickets.json.
– Проверка связи: GET /api/v2/users/me.json.
– HTTP-запросы к Zendesk выполняются с проверкой SSL-сертификата.
– Фильтры для разработчиков: zdwf_ticket_subject, zdwf_ticket_body, zdwf_ticket; действие zdwf_ticket_created после успешного создания тикета.

Требования

– WordPress 6.0 или новее (по заголовку плагина).
– PHP 7.4 или новее.
– Установленный и активный WPForms.
– Учётная запись Zendesk с правом использовать API token для выбранного email.
– Активная лицензия PluginHub для продукта с идентификатором pluginId (см. ниже).

Идентификатор товара PluginHub (pluginId)

В коде плагина задана константа ZDWF_PLUGINHUB_PLUGIN_ID (значение по умолчанию можно переопределить в wp-config.php строкой define( 'ZDWF_PLUGINHUB_PLUGIN_ID', 'ваш-uuid-из-каталога' ); или фильтром WordPress zdwf_pluginhub_plugin_id). Ключ лицензии в настройках сайта должен соответствовать этому товару и домену сайта согласно правилам PluginHub.

Установка

1. Установите и активируйте WPForms.
2. Установите плагин Zendesk for WPForms и активируйте его.
3. Убедитесь, что версии WordPress и PHP соответствуют требованиям плагина.

Пошаговая инструкция

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

1. Откройте «Настройки → Zendesk WPForms».
2. В блоке «PluginHub license» введите ключ с https://pluginhub.pro для этого продукта.
3. Нажмите «Сохранить изменения» внизу страницы (одной кнопкой сохраняются лицензия и все поля Zendesk).

Без активной лицензии на этой же странице показывается предупреждение; создание тикетов и кнопка проверки подключения к Zendesk не работают до активации. Если другой плагин PluginHub уже добавил поле ключа в «Настройки → Общие», это та же опция в базе — можно править в любом месте.

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

1. В Zendesk создайте API token для пользователя-агента (раздел администрирования API, актуальный путь смотрите в документации Zendesk).
2. На странице «Настройки → Zendesk WPForms» в блоке подключения к Zendesk укажите поддомен (как в адресе yourcompany.zendesk.com, лишнее .zendesk.com можно не вводить).
3. Укажите email входа в Zendesk того же пользователя, для которого выпущен токен.
4. Вставьте API token (если токен уже сохранён, поле можно оставить пустым при смене других настроек).
5. Нажмите «Test connection». При успехе появится сообщение об успешном входе. После смены лицензионного ключа при необходимости обновите страницу, чтобы предупреждения обновились.

Шаг 3. Интеграция и формы

1. Включите переключатель создания тикетов в Zendesk (Create Zendesk tickets for successful submissions).
2. При необходимости задайте префикс темы, приоритет и дополнительные теги.
3. Выберите «все формы» или «только выбранные»; во втором случае отметьте хотя бы одну форму в списке.
4. Сохраните изменения (Save changes).

Шаг 4. Форма WPForms

1. В форме должен быть способ получить email заявителя: желательно поле типа Email. Без валидного email тикет не создаётся, ошибка может писаться в PHP error log при включённом WP_DEBUG.
2. Имя заявителя подставляется из поля типа name или text, если в названии поля есть «name» (логика плагина).

Шаг 5. Проверка

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

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

Нужен ли отдельный сервис между сайтом и Zendesk?

Нет, запросы идут с сервера WordPress напрямую в API Zendesk.

Сохраняются ли записи WPForms?

Да, плагин не отменяет стандартное поведение WPForms; тикет создаётся дополнительно после успешной обработки отправки.

Где хранится API token?

В опции zdwf_settings в базе WordPress. При удалении плагина через админку данные настроек удаляются согласно uninstall.php.

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

– Активна ли лицензия PluginHub для правильного pluginId.
– Включена ли интеграция и выбраны ли формы в режиме «только выбранные».
– Заполнены ли поддомен, email и токен; проходит ли тест подключения.
– Есть ли в форме валидный email для заявителя.

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

– Фильтр zdwf_pluginhub_plugin_id — смена UUID товара без правки файлов.
– Константа ZDWF_PLUGINHUB_PLUGIN_ID в wp-config.php — то же назначение.
– Фильтр pluginhub_license_check_url задаётся в общем файле pluginhub-license.php при необходимости другого URL проверки лицензии.

Журнал изменений (кратко)

1.0.2 — поле ключа PluginHub на странице настроек плагина; сохранение одной кнопкой с остальными настройками.

1.0.1 — лицензирование PluginHub, блокировка тикетов и теста API без лицензии, предупреждение на странице настроек, sslverify для Zendesk.

1.0.0 — первый выпуск.