設定

WHMCS統合モジュールをインストール・アクティベートした後、WHMCSインスタンスへの接続を構成し、Perfex CRMへのデータフローを定義する必要があります。このページでは、APIセットアップ、同期設定、フィールドマッピング、自動スケジューリングについて説明します。

WHMCSへの接続

モジュールは公式APIを通じてWHMCSと通信します。続行する前に有効なAPI認証情報が必要です。

WHMCS API認証情報の生成

1. WHMCS管理エリアにログインします。
2. Setup > スタッフ管理 > API認証情報の管理に移動します。
3. 新しいAPI認証情報を生成をクリックします。
4. 説明を入力します（例：「Perfex CRM Integration」）。
5. API IdentifierとAPI Secretをコピーします — 次のステップで両方必要です。

警告

API認証情報は安全に保管してください。API Secretは作成時に一度だけ表示されます。紛失した場合は、新しい認証情報を生成する必要があります。

Perfex CRMへの認証情報入力

1. Perfex CRMで、WHMCS統合モジュールの設定に移動します。
2. 以下の詳細を入力します：
   • WHMCS URL — WHMCSインストールの完全なURL（例：https://billing.example.com）
   • API Identifier — 前のステップで生成された識別子
   • API Secret — 前のステップで生成されたシークレットキー
3. 接続テストをクリックして、Perfex CRMがWHMCSインスタンスと正常に通信できることを確認します。
4. 接続テストに合格したら設定を保存をクリックします。

ヒント

接続テストが失敗した場合は、Perfex CRMサーバーのIPアドレスがWHMCSのSetup > 一般設定 > セキュリティ > API IPアクセス制限でホワイトリストに登録されていることを確認してください。HTTPSが構成されWHMCS URLが正しいことも確認してください。

同期設定

同期設定パネルでは、インポートするデータとPerfex CRM内での処理方法を制御できます。

データタイプ

データタイプ	説明
クライアント	名前、メール、電話、住所、会社詳細を含むクライアントプロファイルを同期
請求書	明細アイテム、合計、税、支払いステータス、期限日を含む請求書を同期
コンタクト	各WHMCSクライアントアカウントに関連する追加コンタクトを同期

必要に応じて各データタイプをオン・オフに切り替えます。最低限、請求書とコンタクトはクライアントレコードにリンクされているため、クライアントを有効にする必要があります。

重複処理

同期されたレコードが既存のPerfex CRM顧客（メールアドレスで照合）と一致した場合の処理方法を選択できます：

• スキップ — 一致するレコードが既に存在する場合はインポートしない
• 更新 — WHMCSデータで既存のPerfex CRMレコードを上書き
• 新規作成 — 重複に関係なく別のレコードを作成

備考

推奨設定は更新で、重複する顧客エントリを避けながらPerfex CRMデータをWHMCSと同期します。

フィールドマッピング

フィールドマッピングセクションでは、WHMCSフィールドがPerfex CRMフィールドにどのように対応するかを定義します。モジュールにはデフォルトの設定が含まれていますが、以下のマッピングをカスタマイズできます：

• 標準フィールド — 名前、メール、電話、住所、会社、市区町村、都道府県、郵便番号、国
• カスタムフィールド — WHMCSカスタムフィールドをPerfex CRMカスタムフィールドにマッピング

フィールドマッピングを編集するには：

1. WHMCS統合 > 設定 > フィールドマッピングに移動します。
2. 各WHMCSフィールドについて、ドロップダウンから対応するPerfex CRMフィールドを選択します。
3. マッピングを保存をクリックします。

自動同期スケジュール

手動で同期を実行する代わりに、サーバーサイドのcronジョブを使用して自動スケジュールを構成できます。

cronジョブの設定

希望する間隔で同期を実行するために、サーバーのcrontabに以下のエントリを追加します：

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

WHMCSデータの変更頻度に基づいてcronのタイミングを調整します。一般的な間隔：

間隔	cron式	用途
毎時	0 * * * *	高ボリュームの課金環境
6時間ごと	0 */6 * * *	標準使用（推奨）
1日1回	0 2 * * *	低ボリューム環境

警告

大きなデータセットで同期を頻繁に実行すると、サーバー負荷が増加する可能性があります。自動同期を有効にした後、サーバーリソースを監視し、それに応じて間隔を調整してください。

次のステップ

• 使用ガイド — 手動同期の実行、インポートされたクライアントと請求書の管理、ボット、テンプレート、一括コンタクトの使い方を学ぶ