WhatsApp (WhatsApp Cloud API) の対話型統合 の設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：7分

    • 要求者をボットとの会話に参加させることができるように、 WhatsApp (WhatsApp Cloud API) の対話型統合 アプリケーションを設定します。ServiceNow仮想エージェント と統合すると、仮想エージェントまたはライブエージェントとチャットWhatsAppやり取りできます。

    始める前に

    開始する前に、次の操作を行います。

    必要なロール:external_app_install_admin または va_admin

    手順

    1. メタ開発者アカウントと Facebook ビジネスアカウントでの設定が必要です。
      1. WhatsApp Cloud API 入門ガイドの前提条件とステップ 1 を完了して、Meta 開発者アプリを作成します。
      2. アプリシークレットをコピー:
        • メタアプリケーションダッシュボードで、 アプリの設定 > 基本.
        • アプリシークレットをメモします。

          後でこのトークンを使用して、ServiceNow インスタンスで WhatsApp アカウントを認証します。

      3. 電話番号 ID をコピー:
        • 移動先 WhatsApp > API セットアップ.
        • [メッセージの送受信] セクションで、[ 差出人] ドロップダウン リストから WhatsApp 対応の電話番号を選択します。

          この ID は、 ServiceNow インスタンスでプロバイダーレコードを構成するために必要です。

      4. Meta Business Manager でシステムユーザーアクセストークンを作成します。

      システム・ユーザー・アクセス・トークンの作成方法の詳細については、「 システム・ユーザー・アクセス・トークンの生成」を参照してください。アクセストークンの作成時に必要な権限を付与し、アクセストークンをコピーします。

      このトークンは、 ServiceNow インスタンスでトークン検証レコードを構成するために必要です。

    2. ServiceNowインスタンスのWhatsAppからメッセージを受信するには、Webhook URL を確認して設定します。
      1. ナビゲーションフィルターで、「sys_properties.list」と入力します。
      2. sn_va_whatsapp.webhook_verify_tokenプロパティを見つけて開きます。
      3. [値] フィールドに、選択したパスワードまたはシークレットを入力します。
      4. [Save (保存)] を選択します。
      5. Meta 開発者コンソールで、次の場所に移動します。 WhatsApp > 構成 > WhatsApp 構成.
      6. [Webhook] セクションの [コールバック URL] フィールドに、 https://<instance-name>.service-now.com/api/sn_va_whatsapp/va_whatsapp_adapter の形式で URL を入力します。
      7. [トークンを検証] フィールドに、ステップ (c) で ServiceNow インスタンスで設定したパスワードを入力します。
      8. [ 確認して保存] を選択します。
      9. [Webhook フィールド] セクションで、[ 登録 ] 切り替えスイッチを有効にしてメッセージを登録します。
    3. WhatsApp アカウントからの着信ハッシュメッセージを認証するには、認証トークンを格納するハッシュメッセージ検証レコードを作成します。
      1. ServiceNow インスタンスのナビゲーションフィルターで、「hash_message_verification.list」と入力します。
      2. [ハッシュメッセージの検証] リストで、[ 新規] を選択します。
      3. フォームで、フィールドに入力します。
        表 : 1. [ハッシュメッセージの検証] フォーム
        フィールド 説明
        名前

        会社の WhatsApp 勤務先電話番号に関連付けられている認証トークンを格納するハッシュメッセージ検証 [hash_message_verification] テーブル内のレコードの名前。例: WhatsappTestAppInboundToken。
        説明 レコードの説明です。たとえば、「 WhatsApp テストアプリケーション認証トークン」などです。
        シークレット Meta 開発者コンソールで設定されたアプリケーションのアプリシークレット。
      4. ハッシュメッセージ検証レコードの名前をメモしておきます。
      5. [Submit (送信)] を選択します。
    4. 必要な認証ヘッダーを含むメッセージを WhatsApp アカウントに送信するには、システムユーザーアクセストークンを格納するトークン検証レコードを作成します。
      1. ServiceNow インスタンスのナビゲーションフィルターで、「token_verification.list」と入力します。
      2. [トークン検証] リストで、[ 新規] を選択します。
      3. フォームで、フィールドに入力します。
        表 : 2. トークン検証フォーム
        フィールド 説明
        名前 会社のメタビジネスアカウントに関連付けられているシステムユーザーアクセストークンを格納するトークン検証 [token_verification] テーブル内のレコードの名前。例: WhatsappTestAppOutboundToken。
        説明 レコードの説明です。たとえば、「WhatsApp Business Testing アプリケーション送信トークン」などです。
        トークン Meta Business Manager で作成されたシステムユーザーアクセストークン
      4. トークン検証レコードの名前をメモしておきます。
      5. [Submit (送信)] を選択します。
    5. 送信メッセージレコードをメッセージ認証レコードに関連付けます。
      1. ServiceNowインスタンスのナビゲーションフィルターで、「message_auth.list」と入力し、[新規] を選択します。
      2. フォームで、フィールドに入力します。
        表 : 3. メッセージ認証フォーム
        フィールド 説明
        名前 メッセージ認証 [message auth] テーブル内のレコードの名前。例: VA WhatsApp Test App Message Auth。
        プロバイダー 認証トークンのプロバイダー。WhatsAppを入力します。
        グループ名 作成したグループの名前。
        サービスポータル 作成したカスタマーサービスポータル。
        送信サービスのトークン 外部サービスまたは API へのアクセスを認証および承認するために ServiceNow AI Platform が使用する一意のトークン。トークンは、 ServiceNow AI Platform が他のシステムと安全にやり取りできるようにする認証情報です。このトークンは外部サービスによって生成され、プラットフォームが要求を行い、リソースにアクセスできるように ServiceNow AI Platform に提供されます。
        着信メッセージの検証 受信ハッシュメッセージ用に作成したハッシュメッセージ検証レコードの名前。
        送信メッセージの検証 受信ハッシュメッセージ用に作成した トークン メッセージ検証レコードの名前。
        注:
        [ 着信メッセージの検証 ] フィールドと [ 着信メッセージの検証 ] フィールドの値は同じです。
      3. [Submit (送信)] を選択します。
    6. メッセージ認証レコードを WhatsApp 対応の電話番号に関連付けます。
      1. ServiceNow インスタンスのナビゲーションフィルターで、「sys_cs_provider.list」と入力します。
      2. [プロバイダーチャネル] リストで、WhatsAppチャネルに対応する [名前] 列から [VA Whatsapp アダプタプロバイダー] を選択します。
        WhatsAppエントリが存在しない場合は、ナビゲーションフィルターに「sys_cs_provider_application.list」と入力してリストを作成します。
      3. [プロバイダーチャネル ID] 関連リストで、[ 新規] を選択します。
      4. フォームで、フィールドに入力します。
        表 : 4. [プロバイダーチャネル ID] フォーム
        フィールド 説明
        名前 ユーザーが連絡するエンティティの名前 (IT サービスデスクなど)。
        受信 ID WhatsApp 対応の電話番号に対応する電話番号 ID。
        メッセージ認証 作成したメッセージ認証。
      5. [Submit (送信)] を選択します。
    7. プロバイダーチャネル ID プロパティを設定します。
      1. 作成したプロバイダーチャネル ID を選択します。
      2. [プロバイダーチャネル ID プロパティ] セクションで [ 新規] を選択します。
      3. フォームで、フィールドに入力します。
        表 : 5. [プロバイダーチャネル ID] フォーム
        フィールド 説明
        名前 ユーザーが連絡するエンティティの名前。display_phone_numberを入力します。
        値 作成した電話番号 ID に対応する実際の電話番号を入力します。
        説明 プロバイダーチャネルの説明を追加します。
      4. [Submit (送信)] を選択します。
    8. 送信したメディアコンテンツをサーバーでダウンロードできるようにします。
      1. ServiceNow インスタンスのナビゲーションフィルターで、「sys_cs_provider.list」と入力します。
      2. [プロバイダーチャネル] リストで、WhatsAppチャネルに対応する [名前] 列から [VA Whatsapp アダプタプロバイダー] を選択します。
      3. [信頼できるメディアドメイン] フィールドに lookaside.fbsbx.com を入力します。
      4. [Update (更新)] を選択します。