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

設定

WhatsApp Cloud API Chat & Marketingモジュールをインストール・アクティベートした後、Perfex CRMとMeta WhatsApp Cloud API間の接続を構成する必要があります。これにはMetaアプリケーションのセットアップ、API認証情報の生成、webhookの構成、モジュール設定の調整が含まれます。

Metaアプリケーションの構成​

WhatsApp Cloud APIはMeta（Facebook）アプリを通じてアクセスされます。まだ作成していない場合は、以下の手順に従ってください。

ステップ1 — Facebook Developersアカウントの作成​

  1. developers.facebook.comにアクセスします。
  2. Facebookアカウントでログインします。
  3. プロンプトが表示されたら、規約に同意しアカウントを確認してデベロッパーとして登録します。

ステップ2 — Metaアプリの作成​

  1. Facebook Developersダッシュボードでアプリを作成をクリックします。
  2. アプリタイプとしてビジネスを選択します（アカウントタイプでビジネスが利用できない場合はその他）。
  3. アプリ名（例：「Perfex CRM WhatsApp」）と連絡先メールを入力します。
  4. ビジネスアカウントを選択します（必要に応じて作成）。
  5. アプリを作成をクリックします。

ステップ3 — アプリにWhatsAppを追加​

  1. 新しいアプリのダッシュボードで、製品リストのWhatsAppを見つけてセットアップをクリックします。
  2. ガイド付きセットアップに従ってWhatsApp Businessアカウントをリンクします。
  3. 開発用のテスト電話番号が自動的に提供されます。後で独自の確認済みビジネス電話番号を追加できます。
備考

テスト電話番号では、事前登録した最大5つの番号にメッセージを送信できます。本番使用では、WhatsApp Businessアカウント設定で独自のビジネス電話番号を追加・確認してください。

ステップ4 — 永続的なアクセストークンの生成​

デフォルトの一時トークンは24時間後に期限切れになります。本番用には、永続的なシステムユーザートークンを生成します：

  1. business.facebook.comにアクセスし、ビジネス設定 > システムユーザーに移動します。
  2. Adminアクセスで新しいシステムユーザーを作成します（または既存のものを使用）。
  3. 新しいトークンを生成をクリックし、WhatsAppアプリを選択して以下の権限を付与します：
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. 生成されたトークンをコピーします — これが永続的なアクセストークンです。
警告

永続的なトークンは一度しか表示されません。安全に保管してください。紛失した場合は、新しいトークンを生成してモジュール設定を更新する必要があります。

Webhookの構成​

Webhookにより、WhatsAppがPerfex CRMインスタンスに受信メッセージ、配信確認、ステータス更新をリアルタイムで通知できます。

Webhookのセットアップ​

  1. Facebook Developersダッシュボードで、アプリのWhatsApp > 構成ページに移動します。
  2. Webhookで編集をクリックします。
  3. モジュールが提供するコールバックURLを入力します（Perfex CRMのWhatsAppモジュール > 設定にあります）。通常は以下の形式です： 
    https://your-perfex-domain.com/whatsapp_cloud_api/webhook
  4. モジュール設定に表示されている確認トークンを入力します。
  5. 確認して保存をクリックします。
  6. 以下のwebhookフィールドをサブスクライブします：
    • messages
    • message_template_status_update
ヒント

Perfex CRMインストールは有効なSSL証明書でHTTPS経由で提供されている必要があります。MetaはHTTPまたは無効/自己署名証明書のwebhook URLを拒否します。

モジュール設定​

Metaアプリのセットアップが完了したら、Perfex CRM内でモジュールを構成します。

  1. Perfex CRMサイドバーのWhatsApp Cloud APIモジュールに移動します。
  2. 設定に移動して以下を入力します：
設定説明
アクセストークン上記で生成した永続的なシステムユーザートークン
電話番号IDMetaアプリの WhatsApp > はじめにページにあります
WhatsApp BusinessアカウントIDMetaアプリのWhatsApp設定にあります
Webhook確認トークン定義するカスタム文字列 — Metaのwebhookセットアップで入力したものと一致する必要があります
アプリIDMetaアプリのID（アプリダッシュボードにあります）
  1. 設定を保存をクリックします。
  2. 接続テストボタンを使用して、モジュールがWhatsApp Cloud APIと通信できることを確認します。

埋め込み構成​

高度なセットアップでは、モジュールは外部ページまたはクライアントポータルにWhatsAppチャットウィジェットを埋め込むことをサポートしています。WhatsAppモジュール > 設定 > 埋め込みに移動して、埋め込みコードスニペットを生成し、ウィジェットの外観（色、位置、ウェルカムメッセージ）をカスタマイズします。

ビジネス認証​

完全なメッセージング容量とすべてのテンプレートカテゴリへのアクセスをアンロックするには、Metaビジネス認証を完了してください：

  1. business.facebook.com > ビジネス設定 > セキュリティセンターに移動します。
  2. 認証を開始をクリックして、ガイド付きプロセスに従います。
  3. Metaが要求するビジネスドキュメントを提出します。
  4. 認証には通常2-5営業日かかります。
備考

ビジネス認証なしでは、メッセージングは24時間のローリングウィンドウで250のユニーク受信者に制限されます。認証後、メッセージの品質と量に基づいて制限が段階的に増加します。

次のステップ​

  • 使用ガイド — チャットインターフェースの使い方、キャンペーンの実行、ボットの構成、テンプレートの管理を学ぶ
  • WhatsAppログ — すべての自動化されたインタラクションの包括的な記録を表示