本文へ移動
◈hastdocs
日本語
Hast ホーム

AIP

WhatsApp を接続

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

始める前に

AIP 画面で作成する新しい WhatsApp チャネルは Dualhook を使用します。FDE の案内に従い、自分の Dualhook 組織と WhatsApp Business アカウントを接続します。認可はアカウントの所有者が行ってください。

この Profile に接続済みのアカウントは既存のチャネルを使用します。ナレッジベースへの追加に再認可は不要です。自動返信が必要な場合は有効な Agent を用意します。

1

アカウントの認可を準備する

Dualhook のアカウント接続ガイド に従い、組織と WhatsApp Business アカウントを準備します。今回接続するアカウントと番号を確認してください。

履歴が必要な場合は初回の WhatsApp 認可時にインポートを選び、接続後 24 時間以内に要求します。対象は接続前の最大 180 日間です。実際の内容はプロバイダーが提供し、グループやすべての過去のメディアは含まれません。

2

AIP でチャネルを作成する

「チャネル → チャネルを追加」で WhatsApp を選びます。名前を入力し、利用可能な履歴を取り込むか選択してチャネルを作成します。

コールバック URL と検証 token が表示されます。未完了の場合はチャネル一覧の設定完了ボタンから続行できます。

3

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

現在の Dualhook 組織の接続設定に、AIP の完全なコールバック URL と検証 token を入力し、アカウントの認可を完了します。両方の値を安全に管理してください。

このチャネル用のコールバックを使用します。別のアカウントの値で既存のコールバックを上書きしないでください。

4

アカウント情報を保存する

今回の Dualhook 接続で提供された WABA ID と Phone Number ID を AIP に入力します。これらはアカウントと番号の識別子で、電話番号そのものではありません。

Outbound API key を取得する

Dualhook Runtime API ガイド に従い、その組織の Outbound API key を取得します。同名の欄に入力し、アカウント情報を保存します。この欄には Dualhook の送信用 API 認証情報を使用します。

保存後にアカウントの設定完了が表示されます。履歴の状態はプロバイダーのコールバックで更新されます。履歴メッセージの受信完了後も、メディアが別途届く場合があります。

5

Agent を関連付けてテストする

新しい内容は自動で同期され、ナレッジの同期に Agent は不要です。チャネルの内容表示を開き、新しいメッセージが届くことを確認します。検索に使用する場合は、そのソースをナレッジベースに追加します。

自動返信には Agent の「チャネル」でこの接続を関連付けて保存します。Agent を有効にし、別の WhatsApp 番号からメッセージを送って同じ会話に返信が届くことを確認してから、画像やファイルを試します。チャネルの関連付けとナレッジの参照権限は個別に設定します。

既存の Meta 接続

Meta に直接接続する既存の WhatsApp チャネルは引き続き管理できます。そのチャネルの再認可を開き、元のアカウントの phone_number_id、business_account_id、token_secret_value、app_secret_value を入力して保存し、メッセージをテストします。Token と App Secret は同じ Meta App のもので、その App に対象 WABA への権限が必要です。

既存の Meta 接続と新しい Dualhook 接続では認証情報が異なります。既存接続の更新時はアカウントとコールバックを維持し、認証情報の更新だけを目的にチャネルを重複作成しないでください。

よくある問題

設定が未完了のままの場合

設定完了ボタン、または設定内のアカウント接続設定を開きます。現在の Dualhook 組織のコールバック、WABA ID、Phone Number ID、Outbound API key を確認し、アカウント情報を保存します。

接続済みでも返信がない場合

まず内容表示で新しいメッセージを確認します。次に Agent が有効か、このチャネルに関連付けられているか、チャネルのトリガールールを満たすかを確認します。ナレッジの同期だけでは自動返信は有効になりません。

履歴が揃わない場合

初回認可時に履歴を要求したかと、プロバイダーの進捗を確認します。インポートには時間と内容の制限があり、すべてのメディアが揃うとは限りません。認可を繰り返して別のソースを作成しないでください。

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