メインコンテンツまでスキップ

WordPress用WordFexプラグイン

WordFexは、Perfex REST APIを使用して新しいWordPressユーザー登録データをPerfex CRMインストールに自動的に同期します。WordPressサイトでユーザーまたは顧客が登録するたびに、そのデータが顧客またはリードとしてPerfex CRMにプッシュされます。

概要​

  • 著者： Themesic
  • 同期先： Perfex CRMの顧客またはリード
  • 連携方法： Perfex REST API

要件​

WordFexをインストールする前に、以下を確認してください：

  • 動作するWordPressインストール（セルフホスト型）
  • アクティブなPerfex CRMインストール
  • Perfex CRMにインストール・アクティベートされたPerfex REST APIモジュール*（別途購入）*
警告

Perfex REST APIモジュールはWordFexが機能するために必須です。Perfex CRMインスタンスに別途購入してインストールする必要があります。

インストール​

  1. ダウンロードしたアーカイブを展開し、upload.zipファイルを見つけます。
  2. WordPress管理パネルでプラグイン → 新規追加に移動します。
  3. プラグインをアップロードをクリックし、upload.zipファイルを選択して今すぐインストールを押します。
  4. 有効化をクリックしてプラグインを有効にします。
  5. 有効化後、WordPress管理サイドバーの設定の下に新しいWordFexメニュー項目が表示されます。

設定​

WordPress管理パネルの設定 → WordFexに移動します。以下の設定を構成する必要があります：

1. PerfexインストールURL​

Perfex CRMインストールのベースURLを入力します。

備考

管理パネルURLではなく、PerfexのインストールURLを使用してください。例えば、https://crm.example.com/adminではなくhttps://crm.example.comを使用してください。

2. Perfex APIキー​

Perfex CRMからAPIキーを生成します：

  1. Perfex CRM管理パネルにログインします。
  2. REST APIモジュール → API → API管理に移動します。
  3. 新しいトークンを作成をクリックします。
  4. 生成されたトークンをコピーし、WordFex設定のPerfex APIキーフィールドに貼り付けます。

3. 同期方法​

新しい登録がPerfex CRMにどのように同期されるかを選択します：

値動作
customers新規登録がPerfex顧客として同期
leads新規登録がPerfexリードとして同期

4. リードグループ名​

同期されるリードのリードグループIDを設定します。このフィールドはPerfex CRM内のターゲットリードグループの数値IDを受け付けます。

  • デフォルト値は1（プライマリリードグループ）です。
  • カスタムグループを使用するには、Perfex CRMで新しいグループを作成（例：「ウェブサイト」）し、その数値IDをここに入力します。
ヒント

この設定は同期方法がleadsに設定されている場合にのみ使用されます。顧客と同期する場合は無視されます。

すべてのフィールドを構成したら、変更を保存をクリックします。新しいユーザーまたは顧客登録のたびにデータが自動的に同期されるようになります。

トラブルシューティング​

WordFexはサーバー上の以下のファイルにログ出力を記録します：

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

同期が期待通りに動作しない場合は、このファイルを確認してください。以下は一般的なエラーメッセージとその解決策です：

「Wrong number of segments」​

原因： APIキーが無効または正しくコピーされていない。

解決策： WordFex設定のAPIキーがPerfex CRMで生成されたトークンと一致することを確認します。末尾のスペースなしでトークンを再コピーしてください。

「Malformed UTF-8 Characters」​

原因： APIキーに無効な文字が含まれているか、コピー&ペースト中に破損した。

解決策： Perfex CRMで新しいAPIトークンを生成し、再度貼り付けます。

「The action you have requested is not allowed.」を含むHTMLレスポンス​

原因： Perfex CRMのCSRF保護がAPIリクエストをブロックしている。

解決策： 2つのオプションがあります：

  1. Perfex CRMインストールの/application/config/config.phpファイルをREST APIモジュールが提供するバージョンに置き換える。
  2. CSRF保護設定に/api/エンドポイントの例外を追加する。
警告

CSRF設定の変更はCRMのセキュリティに影響します。REST APIモジュールのドキュメントで推奨される変更のみを適用してください。

カスタマイズ​

カスタムのWordPressまたはWooCommerceフィールドをPerfex CRMに同期する必要がありますか？カスタムフィールドマッピングのソリューションについてはThemesicサポートにお問い合わせください。

サポート​

問題が発生した場合やサポートが必要な場合は、Themesicサポートポータルをご利用ください：

https://themesic.com/support