Лицензирование и активация Pro

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

Лицензия Pro открывает всё остальное. На этой странице рассказывается, как её купить, активировать, проверить и удалить.

Что открывает Pro

Открывается в Pro	Что это даёт в повседневной работе
🔁 Двусторонняя синхронизация клиентов и контактов	Адрес, исправленный в Perfex, возвращается в WHMCS в соответствии с выбранной вами политикой разрешения конфликтов
📄 Зеркалирование счетов	Счета WHMCS появляются у клиента Perfex вместе с позициями, налоговой строкой и статусом
💳 Синхронизация платежей и транзакций	Оплаченный счёт WHMCS переводит своё зеркало в Perfex в статус Paid с записью шлюза и идентификатора транзакции
🛒 Синхронизация заказов	Заказ WHMCS становится лидом Perfex, либо заметкой у клиента, либо ничем - как вам удобнее
🎫 Синхронизация тикетов поддержки	Тикеты, ответы и изменения статуса передаются в обе стороны, с опциональными задачами Perfex на каждый тикет для учёта времени
🌐 Панель услуг и доменов	Вкладка WHMCS в профиле каждого клиента Perfex со списком услуг и доменов этого клиента
⏬ Мастер переноса данных	Импорт существующих клиентов, счетов, услуг и доменов, а не только новой активности
🗂️ Выпадающие списки сопоставления отделов	Сопоставление отделов тикетов WHMCS с отделами Perfex выбором из списка вместо ввода идентификаторов

Полное сравнение бок о бок приведено в таблице Free и Pro.

Лицензия хранится только на стороне WHMCS

Компаньон для Perfex бесплатен и никогда не хранит ключ. Тариф определяет аддон WHMCS, он же сообщает о нём Perfex, чтобы страница настроек Perfex могла объяснить, почему двусторонняя синхронизация работает или не работает. Сам лицензионный ключ никогда не передаётся в Perfex.

Покупка Pro: оверлей оформления заказа

Это быстрый путь, и он вообще не требует копирования и вставки.

1. На любой из админ-страниц нажмите ссылку обновления:
   • WHMCS: Addons > Perfex CRM Bridge. Ссылка отображается как Buy a Pro licence рядом с полем Pro License Key и как Upgrade to Pro в строке контрольного списка с лицензией и в информационных блоках о Pro.
   • Perfex: Setup > WHMCS Bridge, панель WHMCS plan, кнопка Upgrade to Pro.
2. Прямо поверх страницы, на которой вы уже находитесь, открывается защищённый оверлей оформления заказа.
3. Завершите покупку.
4. Активация происходит автоматически:
   • Начали из WHMCS: лицензионный ключ из ответа системы оплаты записывается в поле Pro License Key самой формы настроек, и эта форма отправляется за вас. Сохранение проверяет ключ по сети, переводит тариф в Pro и сообщает об этом стороне Perfex - всё в рамках одного запроса.
   • Начали из Perfex: ключ передаётся в вашу установку WHMCS по подписанному каналу моста. WHMCS проверяет его по сети до того, как что-либо сохранить, активирует Pro и сразу же отправляет обратно актуальное состояние тарифа, поэтому панель тарифа в Perfex меняется на Pro на месте, без перезагрузки страницы. Perfex никогда не хранит ключ.
5. Pro работает немедленно. Ждать такта cron не нужно, вводить ничего не требуется.

Оверлей - это удобство, а не обязательное условие

Если скрипт оверлея заблокирован расширением браузера, строгой политикой безопасности контента или медленной сетью, ссылка просто ведёт себя как раньше и открывает страницу оформления заказа в новой вкладке. Ничего не ломается; вы просто завершаете процесс ручной вставкой ключа, описанной ниже.

Если браузер закрылся до завершения активации

Ваш ключ никуда не делся. Есть две подстраховки, в таком порядке:

1. На странице. Если покупка прошла успешно, но автоматическая активация не сработала, ключ показывается на странице в выделяемом поле, с кнопкой копирования на стороне Perfex и точной инструкцией, куда его вставить. Оплаченный ключ никогда не остаётся только внутри закрытого оверлея.
2. В вашей почте. Ключ всегда отправляется вам по электронной почте при покупке, а также доступен в вашем личном кабинете у платёжного провайдера. Если браузер аварийно закрылся в неподходящий момент, проверьте почту.

Затем воспользуйтесь ручным способом ниже.

Ручная активация ключа

Используйте этот способ всякий раз, когда ключ у вас уже есть: из письма о покупке, из личного кабинета или при переносе лицензии на другую установку WHMCS.

1. В WHMCS откройте Addons > Perfex CRM Bridge.
2. Прокрутите до Settings > Pro licence.
3. Вставьте ключ в поле Pro License Key. Ключи начинаются с sk_.
4. Нажмите Save Settings.

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

Баннер сообщает ровно одно из трёх:

Баннер	Значение	Что делать
🟢 Зелёный - "Settings saved. Licence verified - your Pro plan is active..."	Лицензионный сервер подтвердил ключ. Заголовок страницы и строка контрольного списка License / plan уже показывают Pro, информационные блоки о Pro исчезли, а мастер переноса данных разблокирован.	Ничего. Всё готово.
🔴 Красный - "Settings saved. The licence server rejected this key..."	Ключ отклонён, и сообщение называет причину, указанную самим сервером: неизвестный ключ, истёкшая подписка, отменённая лицензия или израсходованная квота активаций.	Проверьте, что ключ вставлен ровно так, как он выглядит в письме о покупке, без пропущенных или лишних символов, и сохраните ещё раз.
🟠 Жёлтый - "Settings saved. Could not reach the licence server..."	Ни подтверждения, ни отказа: ваш сервер сейчас не смог связаться со службой лицензирования.	Ключ сохранён, и повторные попытки продолжаются автоматически. Убедитесь, что ваш сервер может обращаться к api.freemius.com по HTTPS, затем нажмите Check licence now. Тем временем вас защищает льготный период.

"Settings saved." - всегда правда, какого бы цвета ни был баннер

Настройки записываются в базу данных до любой проверки лицензии, поэтому красный баннер никогда не означает "сохранение не удалось". Он означает "сохранено, а ваш ключ отклонён". Заново заполнять форму не придётся никогда.

Сохранение прочих настроек ничего не стоит

Проверку запускает только действительно изменившийся лицензионный ключ. Приостановка синхронизации, изменение цели для заказов или правка администратора для ответов на тикеты не выполняют ни одного сетевого запроса, и баннер остаётся обычным "Settings saved."

Check licence now

Кнопка Check licence now находится вверху страницы модуля в WHMCS, рядом с Test Connection и Run Sync Now.

Она принудительно запускает немедленную повторную проверку уже сохранённого ключа, игнорируя ограничение "раз в сутки". Используйте её, когда:

• вы только что продлили или расширили лицензию и хотите сразу вернуть Pro;
• сохранение вернуло жёлтый баннер, а вы с тех пор устранили проблему с сетью или межсетевым экраном;
• вы хотите убедиться в текущем состоянии перед обращением в поддержку.

У кнопки есть короткая защита от двойного нажатия в несколько секунд. Нажмите её дважды подряд, и второе нажатие ответит "проверено только что", не отправляя повторный запрос. Подождите несколько секунд, и проверка выполнится как обычно.

Если ключ вообще не сохранён, кнопка отвечает красным баннером о том, что ключ пуст и установка работает на бесплатном тарифе. Ни один запрос не покидает ваш сервер.

Поддержание активации: ежедневная перепроверка и льготный период в 14 дней

Когда ключ сохранён, cron WHMCS перепроверяет его раз в сутки. От вас ничего не требуется.

Если служба лицензирования недоступна, модуль не отключает вас. Такой случай трактуется как "мы не знаем", а не как "отказано", и льготный период в 14 дней сохраняет полную работоспособность Pro, пока идут повторные попытки.

Три детали, которые стоит знать:

• Отсчёт льготного периода идёт от последней успешной проверки, а не от последней попытки. Показываемый на странице обратный отсчёт отражает реальное количество оставшихся дней и не сбрасывается при каждой неудачной попытке.
• Настоящий отказ немедленно прекращает льготный период. Если сервер лицензирования явно сообщает, что лицензия истекла, отменена или недействительна, это ответ, и льготный период не применяется. Блокировка точки входа лицензирования на межсетевом экране не поможет сохранить отозванную лицензию.
• Льготный период продлевает, но не запускает работу с нуля. У ключа, который ни разу не был подтверждён, нет льготного периода, на который можно было бы опереться. Если вы вставите совершенно новый ключ, пока служба лицензирования недоступна, ключ будет сохранён и попытки продолжатся, но Pro не включится, пока проверка действительно не пройдёт успешно.

Состояния тарифа, которые вы можете увидеть в заголовке страницы

Текст в заголовке	Значение
Free plan - no licence key set.	Ключа нет. Это бесплатный тариф, работает нормально.
Pro license set - awaiting first verification.	Ключ сохранён, но ещё ни разу не подтверждён. Нажмите Check licence now.
Pro active until YYYY-MM-DD (UTC)	Всё в порядке.
Pro active - lifetime licence	Лицензия без даты окончания.
Pro (grace) - could not reach the licence server, retrying daily. Pro keeps working for N more day(s).	Временный сбой связи. Для вас пока ничего не сломано.
Free plan - this licence has expired.	Продлите лицензию, затем нажмите Check licence now.
Free plan - this licence was cancelled.	Лицензия отменена или возвращена. Если это ошибка, обратитесь в поддержку.
Free plan - the licence key was rejected.	Неверный ключ или исчерпана квота активаций. В сообщении приводится формулировка самого сервера.
Free plan - the licence server could not be reached and the grace period has run out.	Восстановите связь с точкой входа лицензирования, затем нажмите Check licence now.

Та же фраза выводится в строке License / plan контрольного списка настройки, поэтому искать её не придётся.

Слоты активации

Одна установка WHMCS занимает один слот активации вашей лицензии. Модуль один раз генерирует устойчивый идентификатор и использует его всегда, поэтому повторная проверка, повторное сохранение или перенос сайта на другой домен никогда не расходуют второй слот.

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

Удаление ключа и возврат к бесплатному тарифу

1. В WHMCS откройте Addons > Perfex CRM Bridge > Settings > Pro licence.
2. Отметьте Remove the stored key (revert to Free).
3. Нажмите Save Settings.

Что происходит:

• Установка немедленно возвращается на бесплатный тариф, независимо от того, что ещё осталось в кеше. Возможности Pro прекращают работать.
• Слот активации освобождается, поэтому лицензию можно активировать на другой установке.
• Стороне Perfex сообщается о понижении тарифа, чтобы её панель WHMCS plan не продолжала весь оставшийся день показывать Pro.

Удаляйте ключ до переноса или вывода сайта из эксплуатации

Если вы удалите установку WHMCS, не удалив предварительно ключ, её слот активации останется занятым. Удаление ключа занимает пять секунд и избавляет от лишнего обращения в поддержку в будущем.

Что происходит с вашими данными, когда Pro заканчивается

Ничего не удаляется. На бесплатной установке:

• Синхронизация клиентов и контактов продолжает работать в одну сторону, ровно как раньше.
• WHMCS перестаёт ставить в очередь события по счетам, платежам, заказам, услугам, доменам и тикетам. Ограничение действует у источника, поэтому ничего не накапливается и ничего не повторяется впустую.
• Изменения на стороне Perfex, уже поставленные в очередь для WHMCS, отклоняются с понятным сообщением "Two-way sync requires Pro on the WHMCS side" на панели Outbound queue, повторяются и в итоге переходят в состояние dead-letter.
• Всё уже синхронизированное остаётся в Perfex. Вкладка WHMCS в профилях клиентов по-прежнему показывает последние сохранённые снимки данных, просто перестаёт обновляться.

Активируйте действующий ключ снова, и всё возобновится на следующем же событии.

Устранение неполадок с лицензией

Симптом	Причина	Решение
Сохранение ключа не даёт видимого результата	Вы вставили тот же ключ, который уже был сохранён. Проверку запускает только изменившийся ключ.	Нажмите Check licence now.
Баннер каждый раз жёлтый	Ваш сервер не может обратиться к точке входа лицензирования по HTTPS.	Разрешите исходящие HTTPS-соединения к api.freemius.com во всех межсетевых экранах и прокси на сервере WHMCS. Затем нажмите Check licence now.
"The licence key was rejected" при внешне корректном ключе	Обрезанная вставка либо исчерпана квота активаций.	Скопируйте ключ из письма о покупке заново и целиком. Ключи состоят из 32 символов и могут содержать знаки препинания, поэтому ничего не обрезайте. Если в сообщении говорится об установках, освободите слот.
Perfex по-прежнему показывает Free, хотя в WHMCS уже Pro	Состояние тарифа ещё не дошло до Perfex.	Нажмите Check licence now или Test Connection в WHMCS; обе кнопки немедленно передают состояние тарифа в Perfex. Перезагрузите страницу настроек Perfex.
Панель тарифа в Perfex показывает Unknown	Сторона WHMCS никогда не отчитывалась или не отчитывалась давно.	Нажмите Test Connection в WHMCS, затем перезагрузите страницу Perfex. Если состояние остаётся Unknown, возможно, cron WHMCS остановился или стороны больше не сопряжены.

Больше информации в разделе Устранение неполадок.