AIP
WhatsApp を接続
WhatsApp で顧客からの質問やファイルを受け取り、Agent が返信します。
始める前に
有効な Agent と、Meta のビジネスポートフォリオ、WhatsApp Business Account(WABA)、アプリを管理できるアカウントを用意します。
WhatsApp アカウントを用意する
Meta Business Suite でポートフォリオを選び、「設定 → アカウント → WhatsApp アカウント」を開きます。既存のアカウントと番号を利用できます。

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

番号とアカウント ID を取得する
権限と認証情報を用意する
Business Suite の「ユーザー → システムユーザー」で既存ユーザーを選びます。新規作成時は Employee を選択します。

「アセットを割り当てる」で今回のアプリと WABA を選び、以下の権限を付与します。
| アセット | 必要な権限 |
|---|---|
| Meta アプリ | アプリの開発 |
| WhatsApp アカウント | 対象番号の管理とメッセージの送受信 |


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

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

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

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

AIP でチャネルを作成する
メッセージのコールバックを設定する
- Meta for Developers でアプリの
Webhookを開き、WhatsApp Business Accountを選びます。 - AIP の URL と
Webhook Verify Tokenを入力して検証・保存します。 messagesを購読します。- Meta の実メッセージ受信要件を満たし、必要に応じて
Liveに切り替えます。
複数の WABA でアプリを共有する場合
既存のアプリのコールバックと messages 購読を維持します。管理者が新しい WABA の subscribed_apps に override_callback_uri と verify_token を設定して確認します。同じ WABA 内の複数番号は、事前にルーティングを確認してください。
Agent を選んでテストする
よくある問題
権限がない・トークンが無効
対象アプリと WABA の割り当て、および上記 2 つの権限を確認します。トークンが失効したらチャネルの認証情報を更新します。
コールバック検証後も返信がない
messages、WABA のアプリ購読、番号 ID、Agent と利用認可を確認します。実コールバックが 401 の場合は App Secret の所属アプリを確認し、管理者にチャネル名・送信時刻・エラーコードを伝えます。
送信制限・表示名の審査
131047 は会話ウィンドウの終了を示します。顧客に再送してもらうか、承認済みテンプレートを使用します。131037 は WhatsApp Manager で対象番号の表示名審査と拒否理由を確認します。
テキストは届くが添付に失敗する
Agent の書き込み可能なワークスペース、コマンド実行、ネットワークアクセスを有効にします。小さなファイルの読み取りと返信を別々に試し、形式・容量制限と配信結果を確認します。

















