Настройка

После установки и активации модуля интеграции с WHMCS необходимо настроить подключение к экземпляру WHMCS и определить, как данные поступают в Perfex CRM. На этой странице рассматриваются настройка API, параметры синхронизации, сопоставление полей и автоматическое расписание.

Подключение к WHMCS

Модуль взаимодействует с WHMCS через официальный API. Перед продолжением вам потребуются действующие API-учётные данные.

Генерация API-учётных данных WHMCS

1. Войдите в Панель администратора WHMCS.
2. Перейдите в Setup > Staff Management > Manage API Credentials.
3. Нажмите Generate New API Credential.
4. Введите описание (например, "Perfex CRM Integration").
5. Скопируйте API Identifier и API Secret — они понадобятся на следующем шаге.

warning

Храните API-учётные данные в безопасном месте. API Secret отображается только один раз при создании. В случае утери необходимо сгенерировать новые учётные данные.

Ввод учётных данных в Perfex CRM

1. В Perfex CRM перейдите к настройкам модуля WHMCS Integration.
2. Введите следующие данные:
   • WHMCS URL — полный URL вашей установки WHMCS (например, https://billing.example.com)
   • API Identifier — идентификатор, сгенерированный на предыдущем шаге
   • API Secret — секретный ключ, сгенерированный на предыдущем шаге
3. Нажмите Test Connection для проверки успешного соединения Perfex CRM с экземпляром WHMCS.
4. Нажмите Save Settings после успешного прохождения теста подключения.

подсказка

Если тест подключения не прошёл, убедитесь, что IP-адрес сервера Perfex CRM добавлен в белый список в WHMCS в разделе Setup > General Settings > Security > API IP Access Restriction. Также проверьте, что HTTPS настроен и URL WHMCS указан правильно.

Параметры синхронизации

Панель параметров синхронизации позволяет управлять, какие данные импортируются и как они обрабатываются в Perfex CRM.

Типы данных

Тип данных	Описание
Clients	Синхронизация профилей клиентов, включая имя, email, телефон, адрес и данные компании
Invoices	Синхронизация счетов с позициями, итогами, налогами, статусом оплаты и сроками
Contacts	Синхронизация дополнительных контактов, связанных с каждой учётной записью клиента WHMCS

Включайте или отключайте каждый тип данных в зависимости от потребностей. Как минимум должны быть включены Clients, поскольку счета и контакты привязаны к записям клиентов.

Обработка дубликатов

Когда синхронизируемая запись совпадает с существующим клиентом Perfex CRM (по email-адресу), вы можете выбрать способ обработки конфликта:

• Skip — не импортировать запись, если совпадение уже существует
• Update — перезаписать существующую запись Perfex CRM данными из WHMCS
• Create New — создать отдельную запись независимо от дубликатов

к сведению

Рекомендуемая настройка — Update, которая поддерживает синхронизацию данных Perfex CRM с WHMCS, избегая дублирования записей клиентов.

Сопоставление полей

Раздел сопоставления полей позволяет определить соответствие полей WHMCS полям Perfex CRM. Модуль поставляется с разумными настройками по умолчанию, но вы можете настроить сопоставление для:

• Стандартные поля — имя, email, телефон, адрес, компания, город, область, индекс, страна
• Пользовательские поля — сопоставьте пользовательские поля WHMCS с пользовательскими полями Perfex CRM

Для редактирования сопоставления полей:

1. Перейдите в WHMCS Integration > Settings > Field Mapping.
2. Для каждого поля WHMCS выберите соответствующее поле Perfex CRM из выпадающего списка.
3. Нажмите Save Mapping.

Автоматическое расписание синхронизации

Вместо ручного запуска синхронизации вы можете настроить автоматическое расписание с помощью серверного cron-задания.

Настройка cron-задания

Добавьте следующую запись в crontab вашего сервера для запуска синхронизации с желаемым интервалом:

# Run WHMCS sync every 6 hours
0 */6 * * * php /path/to/perfex/index.php whmcs_integration sync >/dev/null 2>&1

Настройте время cron в зависимости от частоты изменения данных WHMCS. Распространённые интервалы:

Интервал	Выражение Cron	Случай использования
Каждый час	0 * * * *	Среды с высоким объёмом биллинга
Каждые 6 часов	0 */6 * * *	Стандартное использование (рекомендуется)
Раз в день	0 2 * * *	Среды с низким объёмом

warning

Слишком частый запуск синхронизации на больших наборах данных может увеличить нагрузку на сервер. Мониторьте ресурсы сервера после включения автоматической синхронизации и при необходимости скорректируйте интервал.

Что дальше?

• Руководство по использованию — узнайте, как запускать ручную синхронизацию, управлять импортированными клиентами и счетами, а также использовать ботов, шаблоны и массовые контакты