メインコンテンツへ移動
本文へ移動
WhatsApp を接続

AIP

WhatsApp を接続

WhatsApp で顧客からの質問やファイルを受け取り、Agent が返信します。

始める前に

有効な Agent と、Meta のビジネスポートフォリオ、WhatsApp Business Account(WABA)、アプリを管理できるアカウントを用意します。

1

WhatsApp アカウントを用意する

Meta Business Suite でポートフォリオを選び、「設定 → アカウント → WhatsApp アカウント」を開きます。既存のアカウントと番号を利用できます。

WhatsApp アカウントと追加ボタン
初回:ログインしてアカウントを作成

アカウントに合った方法でログインします。

Meta ログイン

「追加 → WhatsApp Business アカウントを作成」を選びます。

ビジネスアカウントの作成

実際の会社名またはブランド名とカテゴリを入力し、画面に従って確認します。

アカウント名とカテゴリ

表示される選択肢から番号を設定します。自分の番号を使う場合は番号認証を完了します。

番号の選択と続行

作成後は一覧に戻ります。表示名の審査と番号の状態は Meta の管理画面で確認します。

アカウント作成完了
2

Meta アプリを用意する

Meta for Developers で、WABA と同じポートフォリオのビジネスアプリを選択または作成します。

アプリ一覧と作成ボタン
アプリがない場合の作成手順

アプリ名と連絡先メールアドレスを入力します。WhatsApp のユースケースがあれば選択します。

アプリ名と連絡先メール旧版のその他ユースケースビジネスアプリの種類

対象のポートフォリオを選び、アプリを作成します。

ポートフォリオの選択
3

番号とアカウント ID を取得する

Business Suite の WhatsApp アカウント詳細にある ID を Business Account ID(WABA ID)としてコピーします。

アカウント詳細の WABA ID

「電話番号」を開き、接続する番号を選びます。

電話番号一覧

ダイアログ上部の ID を Phone Number ID としてコピーし、国番号付きの電話番号も控えます。

Phone Number ID と国番号付き電話番号
4

権限と認証情報を用意する

Business Suite の「ユーザー → システムユーザー」で既存ユーザーを選びます。新規作成時は Employee を選択します。

Employee システムユーザーの作成

「アセットを割り当てる」で今回のアプリと WABA を選び、以下の権限を付与します。

アセット必要な権限
Meta アプリアプリの開発
WhatsApp アカウント対象番号の管理とメッセージの送受信
アプリのアセットと開発権限WABA の番号とメッセージ権限

割り当て済みアセットにアプリと WABA があることを確認し、トークンを生成します。

割り当て済みアセットとトークン生成

同じアプリを選び、有効期限と次の 2 つの権限を設定します。

Permission
whatsapp_business_messaging
whatsapp_business_management
トークンの権限と生成ボタン
アプリと有効期限の選択
トークンのアプリを選択

用途に合わせて有効期限を設定します。画像の「期限なし」でも取り消しや無効化は起こり得ます。

トークンの有効期限

生成されたアクセストークンをコピーします。

アクセストークンのコピー欄(値はマスク済み)

同じアプリの「アプリ設定 → 基本」で App Secret を表示してコピーします。

App Secret と表示ボタン
Business Suite からアプリ設定を開く

「アカウント → アプリ」から対象を選び、メニューの「アプリダッシュボードで開く」へ進めます。

アプリダッシュボードを開く
5

AIP でチャネルを作成する

「チャネル → 新規チャネル」で WhatsApp を選び、名前と国番号付き電話番号を入力して次に進みます。

チャネル名、番号と次へ

Phone Number ID、Business Account ID、Meta アクセストークン、Meta App Secret を入力して作成します。

インストール画面の完全なコールバック URL と Webhook Verify Token を次の手順用にコピーします。

コールバック URL と Webhook Verify Token
6

メッセージのコールバックを設定する

  1. Meta for Developers でアプリの Webhook を開き、WhatsApp Business Account を選びます。
  2. AIP の URL と Webhook Verify Token を入力して検証・保存します。
  3. messages を購読します。
  4. Meta の実メッセージ受信要件を満たし、必要に応じて Live に切り替えます。
複数の WABA でアプリを共有する場合

既存のアプリのコールバックと messages 購読を維持します。管理者が新しい WABA の subscribed_apps に override_callback_uri と verify_token を設定して確認します。同じ WABA 内の複数番号は、事前にルーティングを確認してください。

7

Agent を選んでテストする

AIP に戻り、プラットフォーム設定の完了を確認して有効な Agent を選び、保存します。

Agent と利用認可の設定

別の WhatsApp 番号から挨拶を送り、同じ会話に返信が届くことを確認してから画像やファイルを試します。利用認可が有効な場合、他のユーザーは案内に従って招待コードを使います。

よくある問題

権限がない・トークンが無効

対象アプリと WABA の割り当て、および上記 2 つの権限を確認します。トークンが失効したらチャネルの認証情報を更新します。

コールバック検証後も返信がない

messages、WABA のアプリ購読、番号 ID、Agent と利用認可を確認します。実コールバックが 401 の場合は App Secret の所属アプリを確認し、管理者にチャネル名・送信時刻・エラーコードを伝えます。

送信制限・表示名の審査

131047 は会話ウィンドウの終了を示します。顧客に再送してもらうか、承認済みテンプレートを使用します。131037 は WhatsApp Manager で対象番号の表示名審査と拒否理由を確認します。

テキストは届くが添付に失敗する

Agent の書き込み可能なワークスペース、コマンド実行、ネットワークアクセスを有効にします。小さなファイルの読み取りと返信を別々に試し、形式・容量制限と配信結果を確認します。

Hast についてHast AIP、Hast Agent、Hast GTM と、FDE チームによる導入支援を紹介します。AIP の紹介FDE の導入ワークベンチで Agent を設定し、業務システムを接続します。最初の Agent を作成外部サービスを使わずに、設定・保存・デバッグを試します。Agent の設定と管理役割、モデル、機能を設定し、現在有効な設定を管理します。Skills の管理Agent が使うスキルファイルを作成、インポート、選択します。ナレッジベースの追加URL やファイルを索引化し、Agent が資料を検索できるようにします。業務シークレットの管理認証情報を保存して Agent にバインドし、設定例に実際の値を含めないようにします。業務ツールの接続入力と認証方法を指定して、Agent から既存の HTTP サービスを呼び出します。長期メモリの設定Agent が読めるメモリと、新しいメモリの保存先を指定します。Agent のデバッグ保存した設定、会話の継続、ツールの結果を検証します。インポート・エクスポート・複製設定を再利用し、移行後にリソースと認証情報を再確認します。HTTP 接続サーバーから Agent を呼び出し、会話の継続、応答の取得、停止を行います。MCP 接続Public API Key で外部 Agent クライアントから AIP ツールを利用します。Slack を接続するAgent を Slack に追加して、チャンネルやダイレクトメッセージで質問したり、ファイルを扱ったり、チームで利用したりできます。WhatsApp を接続WhatsApp で顧客からの質問やファイルを受け取り、Agent が返信します。WeChat カスタマーサービスを接続Agent を WeChat カスタマーサービスに接続し、顧客の質問に返信します。Task Agent の紹介計画から実行、成果物まで、ツール・ファイル・継続的な文脈を使って作業を進めます。最初のタスクを完了依頼を送信し、計画を確認して、最終成果物を検証します。会話の計画・実行・管理計画の調整、実行の停止、会話履歴の管理を行います。ファイルのアップロード・閲覧・取得入力資料を渡し、タスクが作成した成果物を保存します。アプリ接続と機能設定外部アプリを認証し、タスク間で使う背景情報を管理します。定期タスクの作成周期とタイムゾーンを設定し、各実行の結果を確認します。Task Agent のトラブルシューティング権限、接続、タスク状態、ファイルを確認します。API クイックスタートキーを作成し、タスクを送信して実行結果を読み取ります。イベントストリームSSE フレーム、切断後の再開、Event v2 の構造を確認します。API リファレンス公開 API の引数、認証、応答スキーマを確認します。GTM の紹介Web サイトの共通プロジェクトで調査、露出分析、マーケティング原稿を扱います。最初の GTM プロジェクトを作成サイトを入力し、初期化を待って最初の結果を確認します。プロジェクトとサイト資料の管理プロジェクトの切り替え、サイト情報の更新、設定の管理を行います。会社分析とプロジェクト文書製品、競合、マーケティング資料を確認し、コンテンツ作成の背景に使います。SEO とサイト性能モバイルとデスクトップの PageSpeed レポートを確認します。AI によるブランド言及購買者の質問と、モデル回答でのブランド言及を確認します。Google Analytics の接続アカウントを認証し、GA プロパティを選んでトラフィックを確認します。X 原稿の生成と公開投稿を生成し、プレビューを確認して X で公開します。記事の下書きを生成スタイル、言語、読者を指定し、Markdown を確認してコピーします。Growth Agent の利用会話でプロジェクト資料を参照し、対応するバックグラウンド操作を開始します。実行状態とトラブルシューティングキュー、依存関係、結果を確認し、未完了をデータなしと混同しないようにします。プランと使用量現在の Profile の利用権限、使用量、請求を確認します。