Perfex CRM Integration for WHMCS

Perfex CRM Integration for WHMCS связывает вашу биллинговую платформу WHMCS с установкой Perfex CRM и автоматически поддерживает обе системы в согласованном состоянии. Клиенты, контакты, счета, платежи, заказы, услуги, домены и тикеты поддержки передаются между системами практически в реальном времени, поэтому CRM всегда отражает реальную картину биллинга, а биллинг всегда отражает то, что сделали ваши отделы продаж и поддержки в CRM.

Бесплатный тариф даёт надёжную одностороннюю синхронизацию клиентов и контактов из WHMCS в Perfex CRM. Лицензия Pro открывает двустороннюю синхронизацию (изменения, внесённые в Perfex, возвращаются в WHMCS), а также счета, платежи, заказы, тикеты поддержки, панель услуг и доменов внутри Perfex и мастер переноса существующих исторических данных.

Какую задачу это решает

WHMCS - это ваша система биллинга и предоставления услуг. Perfex CRM - это место, где вы ведёте лиды, проекты, задачи и отношения с клиентами. Без моста между ними один и тот же клиент существует дважды, в двух базах данных, и эти две копии расходятся уже через несколько недель. Кто-то обновил адрес в WHMCS, кто-то другой записал номер телефона в Perfex - и ни одной из систем больше нельзя доверять.

Этот продукт избавляет от ручного копирования. Каждое значимое изменение порождает событие, событие помещается в очередь, а очередь доставляется в другую систему по подписанному HTTPS-каналу.

Два модуля, оба обязательны

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

Компонент	Устанавливается в	Что делает	Лицензирование
⚙️ perfexbridge (аддон для WHMCS)	WHMCS, в modules/addons/perfexbridge	Платный модуль. Слушает события WHMCS, ставит их в очередь, подписывает и отправляет в Perfex. Хранит все настройки синхронизации и лицензионный ключ Pro. В админке WHMCS отображается как Perfex CRM Bridge.	По умолчанию бесплатный тариф. Лицензионный ключ Pro открывает возможности Pro.
🧩 whmcs_bridge (модуль-компаньон для Perfex CRM)	Perfex CRM, в modules/whmcs_bridge	Бесплатный компаньон. Принимает подписанные события и записывает клиентов, контакты, счета, платежи, лиды и тикеты в Perfex. Отображает вкладку WHMCS в профиле клиента. В админке Perfex находится в разделе Setup > WHMCS Bridge.	Всегда бесплатен. Никаких лицензионных ключей.

Обе половины обязательны

Установите только аддон для WHMCS - и события будут накапливаться в очереди, которой некуда доставляться. Установите только компаньон для Perfex - и ему никто ничего не отправит. Тариф (Free или Pro) полностью определяется лицензионным ключом на стороне WHMCS. Компаньон для Perfex в обоих случаях одинаков.

Оба компонента имеют одинаковый номер версии, сейчас это 1.3.4, и их всегда следует обновлять вместе.

Названия, которые вы увидите на экране

Продукт называется Perfex CRM Integration for WHMCS. Внутри самих приложений модули представляются короче: аддон для WHMCS указан как Perfex CRM Bridge в разделе Addon Modules, а компаньон для Perfex - как WHMCS Bridge в разделе Setup > Modules. Именно эти названия следует искать при установке.

Free и Pro

Возможность	Free	Pro
👥 Односторонняя синхронизация клиентов, из WHMCS в Perfex CRM	✅	✅
👤 Односторонняя синхронизация контактов, из WHMCS в Perfex CRM	✅	✅
⚡ Захват событий в реальном времени через хуки WHMCS с доставкой по cron WHMCS	✅	✅
🔗 Сопряжение одной вставкой с помощью кода подключения	✅	✅
✅ Контрольный список настройки и Test Connection	✅	✅
📝 Журналы активности на обеих сторонах	✅	✅
🔁 Двусторонняя синхронизация клиентов и контактов, изменения из Perfex возвращаются в WHMCS *	➖	✅
📄 Зеркалирование счетов, счета WHMCS становятся счетами Perfex *	➖	✅
💳 Синхронизация платежей и транзакций, зеркальные счета закрываются оплатой в Perfex *	➖	✅
🛒 Синхронизация заказов, заказ WHMCS становится лидом Perfex или заметкой у клиента *	➖	✅
🎫 Синхронизация тикетов поддержки, тикеты, ответы и статусы в обе стороны *	➖	✅
🌐 Панель услуг и доменов в профиле клиента Perfex *	➖	✅
⏬ Мастер переноса существующих исторических данных *	➖	✅
🗂️ Выпадающие списки сопоставления отделов тикетов в Perfex *	➖	✅
⏱️ Отдельная задача Perfex на каждый тикет для учёта времени в нативных таймшитах *	➖	✅

* Требуется лицензия Pro.

Все поля Pro видны и сохраняются и в бесплатном тарифе. Они просто не действуют, пока не активна действующая лицензия, и страница администрирования сообщает об этом рядом с каждым из них. О покупке и активации читайте в разделе Лицензирование и активация Pro.

Требования

Требование	Подробности
🖥️ WHMCS	8.x или 9.x. Протестировано начиная с 8.1.3.
🐘 PHP	С 7.2 по 8.5. Одна сборка работает на всех версиях. Оба модуля содержат собственные слои совместимости, поэтому отдельной загрузки под каждую версию PHP не требуется.
📇 Perfex CRM	3.x, проверено на 3.4.0.
🔒 HTTPS с обеих сторон	Обязательно. Транспорт жёстко привязан к HTTPS и проверяет TLS-сертификат. Обычный адрес вида http:// по замыслу приводит к сбою любой отправки, а поле WHMCS URL на стороне Perfex не сохраняется, если значение не начинается с https://.
⏰ Системный cron WHMCS	Должен быть запущен. Мост доставляет события из очереди и повторно проверяет лицензию на каждом такте cron. Нет cron - нет доставки.
🌐 Сеть, для двусторонней синхронизации Pro	Ваша установка WHMCS также должна быть доступна с сервера Perfex по HTTPS.
🔌 Расширения PHP	cURL, на обоих серверах.

HTTPS не является опциональным

Это самая частая причина жалоб "ничего не отправляется". HTTP-транспорт ограничен протоколом https и проверяет сертификат с обеих сторон. Самоподписанный сертификат допустим только в том случае, если он действительно проходит проверку на вызывающем сервере. Отключить это невозможно, и так задумано специально: по этому каналу передаются общий секрет и данные ваших клиентов.

Как работает синхронизация, в одном абзаце

Ничего не отправляется в тот момент, когда администратор ждёт ответа страницы. Срабатывает хук WHMCS, событие записывается в таблицу outbox, а системный cron WHMCS разбирает эту очередь и отправляет каждое событие в Perfex методом POST по HTTPS. Каждый запрос подписывается по алгоритму HMAC-SHA256 общим секретом, который есть у обеих сторон, в пределах окна защиты от повторов длительностью 300 секунд. Неудачные отправки повторяются с нарастающей задержкой и после 15 попыток переходят в состояние dead-letter, чтобы оператор мог их изучить. Направление из Perfex в WHMCS в тарифе Pro использует тот же подписанный канал в обратную сторону и запускается по cron Perfex. Многоуровневое подавление эха не даёт одному изменению бесконечно курсировать между системами. Полное объяснение приведено в разделе Как это работает и повседневная эксплуатация.

Перед началом

Подготовьте следующее, и вся настройка займёт около десяти минут:

• Доступ администратора к обеим системам, WHMCS и Perfex CRM.
• Доступ к Файловому менеджеру вашей хостинг-панели или к FTP сервера WHMCS. В админке WHMCS нет установщика модулей.
• Обе установки доступны по HTTPS с действительными сертификатами.
• Подтверждение того, что системный cron WHMCS запущен. WHMCS показывает время последнего запуска cron в разделе Utilities > System > System Health Status.
• Скачанный файл upload.zip (themesic.com/marketplace/whmcs-perfex.zip), распакованный так, чтобы у вас были whmcs-addon/addon.zip и perfex-module/module.zip.

Что дальше

• Установка - сначала установите компаньон для Perfex, затем аддон для WHMCS, и не попадитесь на подвох с Access Control.
• Настройка - свяжите обе стороны одним кодом подключения, затем настройте все параметры.
• Лицензирование и активация Pro - покупка, активация, проверка и удаление лицензии Pro.
• Как это работает и повседневная эксплуатация - движок синхронизации, что и куда синхронизируется, где находятся журналы и мастер переноса данных.
• Устранение неполадок - все распространённые сбои с их причинами и способами устранения.

---

WHMCS является товарным знаком WHMCS Ltd. Perfex CRM является товарным знаком MSTdev. Themesic Interactive - независимый разработчик, не связанный ни с одной из этих компаний, не одобренный и не спонсируемый ими.