WhatsApp チャネル設定

Marketo Optimizerは、Meta Cloud APIを介してWhatsApp メッセージを送信します。 マーケターが個人のジャーニー用にWhatsApp メッセージを作成する前に、製品管理者がWhatsApp チャネルを設定する必要があります。

Marketo Optimizerの WhatsApp タスクのフロー

WhatsApp チャネルを設定する前に、次のことを確認してください。

IMPORTANT
WhatsApp メッセージングサービスの使用には、Metaの利用条件が適用されます。 Marketo Optimizerを通じてWhatsApp メッセージにアクセスすることにより、お客様はMeta WhatsApp Business ポリシーを確認し、遵守することに同意したものとみなされます。

制限事項 limitations

次の制限が WhatsApp チャネルに適用されます。

  • Adobe Marketo Optimizerは​HIPAAに準拠しておらず、HIPAA対応ではありません。 さらに、サードパーティベンダーは、AdobeのBAAの対象ではありません。 顧客は、独自のコンプライアンスとベンダー検証に責任を負います。

  • 自動応答メッセージまたは事前定義された応答メッセージは、まだサポートされていません。

  • 2025年4月より、Metaは、米国の電話番号(+1のダイヤル コードと米国のエリアコードで構成される番号)を持つWhatsApp ユーザーに対するすべてのマーケティングテンプレートメッセージの配信を一時的に停止しました。 詳しくは、Meta ドキュメント ​を参照してください。

  • ネイティブ統合機能では、サードパーティのビジネスサービスプロバイダー(BSP)との統合は許可されていません。

チャネル設定の完了 complete-channel-configuration

WhatsApp メッセージを送信する前に、Marketo Optimizer環境を設定し、WhatsApp アカウントに接続する必要があります。

次のタスクを実行します。

PREREQUISITES
Marketo Optimizerでこれらのタスクを完了するには、次の権限が必要です。
  • B2B チャネル設定の管理 - チャネル メニューにアクセスするには必須です。
  • B2B WhatsApp設定の管理 - WhatsApp チャネルの設定に必要です。
  • B2B WhatsApp プリセットの管理 - API資格情報とWebhookの作成に必要です。

WhatsApp API 資格情報の作成 create-whatsapp-api-credentials

NOTE
説明された設定は、管理者権限を持つユーザーのみがアクセスできます。
  1. 左側のナビゲーションで、管理 セクションを展開し、チャネル​をクリックします。

  2. パネルで、WhatsApp Settings​を展開し、API Credentials​を選択します。

    管理 / WhatsApp設定が拡張されたチャネル ​ {width="800" modal="regular"}

  3. 右上の「新しいAPI資格情報を作成」をクリックします。

  4. 以下で説明するように、API 資格情報を設定します。

    • 名前 – 資格情報の一意の名前を入力します
    • API トークン - API トークンを入力します。 詳しくは、Meta ドキュメント ​を参照してください。
    • ビジネス アカウント ID - ビジネス ポートフォリオに関連する一意の番号を入力します。 詳しくは、Meta ドキュメント ​を参照してください。

    WhatsApp設定API資格情報 {width="500" modal="regular"}

  5. 「続行」をクリックします。

  6. WhatsApp API資格情報に接続する​ WhatsApp Business Account ​を選択します。

    WhatsApp設定API資格情報は、ビジネスアカウントを選択します {width="500" modal="regular"}

  7. WhatsApp メッセージの送信に使用する​ 送信者名 ​を選択します。

    電話番号の設定は自動的に入力されます。

    • 品質評価 – 過去24時間以内に送信されたメッセージに対する顧客からのフィードバックを反映します。

      • 緑色:高品質
      • 黄色:中品質
      • 赤色:低品質

      詳しくは、Meta ドキュメントの​ 品質評価 を参照してください。

    • スループット – 電話番号がメッセージを送信できる割合を示します。

  8. API 資格情報の設定が完了したら、「送信」をクリックします。

送信​をクリックすると、資格情報はすぐに検証および保存され、API資格情報​の一覧ページにリダイレクトされます。

送信された資格情報が無効な場合は、HTTP 500 エラーメッセージが表示されます。 この場合、設定をキャンセルするか、更新して再送信するかを選択できます。

HTTP 500 エラーのトラブルシューティング

WhatsApp API 資格情報の設定時に HTTP 500 エラーが発生した場合は、次のトラブルシューティング手順に従います。

  1. Adobeの使用権限を確認する – 組織に​cjm whatsapp_の使用権限がプロビジョニングされていることを確認します。 この使用権限がないと、WhatsApp チャネルを設定できません。

  2. ビジネスアカウントフィールドの検証 – すべての必須フィールドが正しいことを確認します。

    • API トークン – 適切な権限🔗を持つ有効なMeta アクセストークンである必要があります。
    • Business Account ID - Meta Business Account IDと正確に一致する必要があります。
  3. 資格情報を外部でテストする – Meta APIを使用して資格情報を直接検証し、問題が資格情報に関するものであるか、Marketo Optimizerの資格情報処理に関するものであるかを確認します。

  4. Adobeへのお問い合わせ – 環境と使用権限が有効であることが確認されたものの、HTTP 500 エラーが解決しない場合は、Adobe担当者にお問い合わせください。

WhatsApp Webhook を追加 configure-webhooks

Webhookを使用すると、Marketo OptimizerはWhatsApp Business アカウントからインバウンドメッセージ、同意応答、配信通知を受け取ることができます。 Webhookを設定して、適切な同意管理とメッセージ追跡を確保します。

NOTE
オプトインまたはオプトアウトのキーワードが指定されていない場合、標準の同意メッセージは有効になりません。

WhatsApp API資格情報が正常に作成されたら、webhookを設定できます。

  1. ナビゲーションパネルで、WhatsApp Webhook​を選択します。

  2. 「Webhookを作成」をクリックします。

  3. Webhook設定の​ Name ​を入力します。

  4. 設定​で、Webhookに関連付けるAPI資格情報(前のタスクで作成)を選択します。

  5. インバウンドキーワードカテゴリ​で、キーワードと返信メッセージを定義するカテゴリを選択します。

    • オプトイン - WhatsApp メッセージを受信するには、ユーザーが積極的に同意する必要があります。多くの場合、Web サイトまたはアプリのフォームを通じて管理されます。
    • オプトアウト - StopやNo MessageなどのフレーズをリッスンするようにWebhookを設定して、ユーザーをオプトアウトとして自動的にマークします。
    • ヘルプ - ユーザーがHELP (またはUnknownなどの類似キーワード)を送信するタイミングを自動システムで検出し、サービスの指示などの特定の情報を含む自動的に返信できるようにします。
    • Default – 特定のキーワードに一致しない受信メッセージを処理します。 これは、Adobe Experience Platform データセットでトラッキングイベント(開封数や配信レポートなど)を有効にするフォールバックカテゴリとして機能します。

    キーワードカテゴリを選択すると、デフォルトのキーワードが入力されます。

  6. キーワードを入力​するには、カスタムキーワードを入力し、追加 (+)をクリックします。

    カテゴリごとに複数のキーワードを追加できます。

    note
    NOTE
    キーワードでは大文字と小文字が区別されません(stopとSTOPは同じように扱われます)。
  7. 受信したメッセージがこのカテゴリのキーワードと一致したときに自動的に送信するには、返信メッセージ​を入力します。

    オプトインキーワードと返信メッセージを含む WhatsApp設定のWebhook {width="500" modal="regular"}

  8. 設定する追加のキーワードカテゴリごとに、右上隅にある​追加 (+)をクリックし、手順5 ~ 7を繰り返します。

  9. 送信​をクリックして、Webhook設定を保存します。

トークンとURLをコピーし copy-token-and-url

Webhookが送信されたら、トークンとURL値を取得し、Metaに登録できます。

  1. WhatsApp Webhook リストで、作成したWebhookの名前をクリックします。

  2. Verify Token​と​ Webhook URL ​の値をコピーします。

    WhatsApp設定Webhook設定でURLをコピーし、トークンを検証する {width="500" modal="regular"}

  3. Meta for Developers ポータル ​で、WhatsApp アプリケーション設定に移動し、コピーした値を使用してWebhookを設定します。

チャネル設定の作成 create-channel-configuration

チャネル設定では、ジャーニーアクションノードからWhatsApp メッセージを送信する際に使用される配信設定を定義します。

  1. ナビゲーションパネルの​ 一般設定 ​で、チャネル設定​を選択します。

    ​ チャネル設定リスト ​ {width="600" modal="regular"}

  2. 右上の「チャネル設定を作成」をクリックします。

  3. 設定に「名前」と「説明」(オプション)を入力します。

    note
    NOTE
    名前は文字(A ~ Z)で始まる必要があり、英数字、アンダースコア (_)、ドット (.)、ハイフン (-)のみを含めることができます。
  4. チャネルを選択​するには、WhatsAppを選択します。

    顧客のプリファレンスを尊重するため、選択したマーケティングアクションに関連するあらゆる同意ポリシーが自動的に活用されます。 例えば、ジャーニーでその設定を使用しているWhatsApp メッセージは、WhatsApp メッセージの受信に同意したプロファイルにのみ送信されます。 これらのコミュニケーションの受信に同意しないプロファイルは除外されます。

  5. WhatsApp Settings​で、前のタスクで作成した​WhatsApp設定 (API資格情報)を選択します。

  6. メッセージ配信に使用する​ 送信者の電話番号 ​を入力します。

    WhatsApp チャネル設定の詳細 {width="500" modal="regular"}

  7. (現在Marketo Optimizerには適用されません) WhatsApp Execution フィールド​で、受信者が複数の電話番号を使用できる場合に優先電話番号として使用するプロファイル属性を選択します。

  8. 送信​をクリックして保存するか、ドラフトとして保存​をクリックして、後で設定を完了して送信します。

検証チェックの実行時に、設定は最初に​処理中 ステータスで表示されます。 すべてのチェックが合格すると、ステータスは​ アクティブ ​に変更され、マーケターがジャーニーアクションでWhatsApp メッセージを作成するときに設定を選択できる状態になります。

recommendation-more-help
marketo-optimizer-help-user-guide