Перейти к основному содержимому

Плагин WordFex для WordPress

WordFex автоматически синхронизирует данные регистрации новых пользователей WordPress с вашей установкой Perfex CRM через Perfex REST API. Каждый раз, когда пользователь или клиент регистрируется на вашем сайте WordPress, его данные передаются в Perfex CRM как Customer или Lead.

Обзор​

  • Автор: Themesic
  • Цели синхронизации: Perfex CRM Customers или Leads
  • Метод интеграции: Perfex REST API

Требования​

Перед установкой WordFex убедитесь в наличии следующего:

  • Работающая установка WordPress (self-hosted)
  • Активная установка Perfex CRM
  • Установленный и активированный модуль Perfex REST API в Perfex CRM (приобретается отдельно)
warning

Модуль Perfex REST API необходим для работы WordFex. Он должен быть приобретён и установлен отдельно в вашем экземпляре Perfex CRM.

Установка​

  1. Распакуйте скачанный архив и найдите файл upload.zip.
  2. В панели администратора WordPress перейдите в Plugins → Add New.
  3. Нажмите Upload Plugin, выберите файл upload.zip и нажмите Install Now.
  4. Нажмите Activate для включения плагина.
  5. После активации новый пункт меню WordFex появится в разделе Settings боковой панели администратора WordPress.

Настройка​

Перейдите в Settings → WordFex в панели администратора WordPress. Вам необходимо настроить следующие параметры:

1. URL установки Perfex​

Введите базовый URL вашей установки Perfex CRM.

к сведению

Используйте URL установки Perfex — не URL панели администратора. Например, используйте https://crm.example.com, а не https://crm.example.com/admin.

2. API-ключ Perfex​

Сгенерируйте API-ключ в Perfex CRM:

  1. Войдите в панель администратора Perfex CRM.
  2. Перейдите в REST API Module → API → API Management.
  3. Нажмите Create new token.
  4. Скопируйте сгенерированный токен и вставьте его в поле Perfex API Key в настройках WordFex.

3. Метод синхронизации​

Выберите, как новые регистрации синхронизируются с Perfex CRM:

ЗначениеПоведение
customersНовые регистрации синхронизируются как Perfex Customers
leadsНовые регистрации синхронизируются как Perfex Leads

4. Название группы лидов​

Установите ID группы лидов для синхронизируемых лидов. В это поле вводится числовой ID целевой группы лидов в Perfex CRM.

  • Значение по умолчанию — 1 (основная группа лидов).
  • Для использования другой группы создайте новую группу в Perfex CRM (например, "Website") и введите её числовой ID здесь.
подсказка

Эта настройка используется только когда Метод синхронизации установлен на leads. Она игнорируется при синхронизации с Customers.

После настройки всех полей нажмите Save Changes. Данные будут автоматически синхронизироваться при каждой новой регистрации пользователя или клиента.

Устранение неполадок​

WordFex записывает вывод в следующий файл на сервере:

/wp-content/plugins/wordfex/lastoutput.txt

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

"Wrong number of segments"​

Причина: API-ключ недействителен или неправильно скопирован.

Решение: Убедитесь, что API-ключ в настройках WordFex соответствует токену, сгенерированному в Perfex CRM. Скопируйте токен заново без лишних пробелов.

"Malformed UTF-8 Characters"​

Причина: API-ключ содержит некорректные символы или был повреждён при копировании.

Решение: Сгенерируйте новый API-токен в Perfex CRM и вставьте его заново.

HTML-ответ с текстом "The action you have requested is not allowed."​

Причина: Защита CSRF в Perfex CRM блокирует API-запросы.

Решение: Есть два варианта:

  1. Замените файл /application/config/config.php в вашей установке Perfex CRM версией, предоставленной модулем REST API.
  2. Добавьте исключение для эндпоинтов /api/ в конфигурации защиты CSRF.
warning

Изменение настроек CSRF влияет на безопасность CRM. Применяйте только те изменения, которые рекомендованы документацией модуля REST API.

Кастомизация​

Нужно синхронизировать пользовательские поля WordPress или WooCommerce с Perfex CRM? Обратитесь в поддержку Themesic для решений по сопоставлению пользовательских полей.

Поддержка​

При возникновении проблем или необходимости помощи посетите портал поддержки Themesic:

https://themesic.com/support