WhatsAppチャネル利用マニュアル

最終更新 2026/10/07

本ドキュメントは、Agentic Engineのプラットフォーム管理者と一般ユーザーを対象に、プラットフォームでWhatsAppチャネルを開設し、個人アカウントを連携して、WhatsAppのプライベートチャットやグループチャットでAgentとTeamを使用する方法を説明します。ページの入口やチャネルのステータスに異常がある場合は、システム管理者にお問い合わせください。

警告

コンプライアンスに関する注意：Baileysは、WhatsAppが公式にサポートしていないWeb自動化ソリューションであり、アカウントのレート制限、利用制限、停止のリスクがあります。本番環境で使用する前にコンプライアンス評価を行い、専用のテストアカウントを優先して使用してください。個人のメインアカウントは連携しないでください。

1. 開始前の準備

• プラットフォーム管理者：「システム管理 → チャンネル管理」の権限があり、会社の共有ボット専用のWhatsAppアカウントを用意していること。
• 一般ユーザー：正常にログインできるAgentic Engineアカウントがあり、自分のWhatsAppから共有ボットにプライベートチャットを送れること。
• グループチャットでの利用：共有ボットを事前に対象のWhatsAppグループチャットに追加し、グループメンバーは個人アカウントの連携を完了しておく必要があります。

ヒント

2つの立場を混同しないでください：管理者がQRコードをスキャンするのは、会社の共有ボットをプラットフォームに接続するためです。一般ユーザーはQRコードをスキャンする必要はなく、ワークベンチでワンタイム連携コードを生成し、自分のWhatsAppからボットにプライベートチャットで送信するだけで連携が完了します。

2. 管理者がWhatsAppチャネルを追加する

チャンネル管理の権限を持つ管理者がAgentic Engineにログインし、「システム管理 → チャンネル管理」に進みます。

1. 「新規チャンネル」をクリックし、チャンネルタイプで WhatsApp を選択します。
2. チャンネル名を入力し、必要に応じてデフォルトモデルを選択してシステムプロンプトを入力し、保存します。
3. チャネルの「有効化」スイッチをONにします。初めて有効にしてまだQRコードをスキャンしていない間は「オフライン」と表示されますが、これは正常な状態です。
4. チャネル一覧に戻り、「QR コードで連携」をクリックします。
5. 共有ボット用スマートフォンのWhatsAppで「設定/メニュー → リンク済みデバイス → デバイスをリンク」に進み、ページのQRコードをスキャンします。
6. QRコードは約2分で期限切れになります。期限切れになったら、ページで「QR コードを再生成」をクリックします。
7. スキャンに成功したらチャネル一覧を更新し、ステータスが「オンライン」になったことを確認します。

構成項目	必須	操作の説明
チャンネル名	必須	チャネル一覧とユーザーの連携ページで識別するために使用します。例：「WhatsApp ボット」。
チャネルタイプ	必須	WhatsApp を選択します。
デフォルトモデル	任意	選択しない場合は、プラットフォーム全体のデフォルトモデルを使用します。
システムプロンプト	任意	このWhatsAppチャネルから開始されたAgentの会話にのみ影響します。

ヒント

チャネルに「オンライン」と表示されて初めて、ユーザーのワークベンチにこのWhatsAppチャネルの連携の入口が表示されます。

3. ユーザーの連携と連携解除

WhatsAppアカウントを連携する

1. Agentic Engineにログインし、ワークベンチのサイドバーで「チャネル連携」を開きます。
2. 使用するWhatsAppチャネルを選択し、「連携」をクリックします。
3. ポップアップに表示された連携コマンド全体をコピーします。連携コードの有効期間は10分間で、1回しか使用できません。
4. 自分のWhatsAppアカウントから共有ボットにプライベートチャットで、コマンド全体を送信します。例：+bind ABC234。
5. 「WhatsApp アカウントを連携しました」と表示されたら、ワークベンチに戻り、ステータスが「連携済み」に更新されたことを確認します。

警告

連携コマンドはプライベートチャットでのみ送信できます。グループチャットで送信すると拒否されます。同じWhatsAppのアイデンティティを、複数のAgentic Engineユーザーに同時に連携することはできません。

連携解除またはプラットフォームアカウントの変更

1. ワークベンチのサイドバーで「チャネル連携」を開きます。
2. 対象のWhatsAppチャネルを見つけ、「連携解除」をクリックして確定します。
3. 別のAgentic Engineアカウントを連携する場合は、新しいアカウントでログインし、連携コードを再生成してください。

4. WhatsAppでAgentを使用する

プライベートチャットでの利用

• 連携が完了したら、共有ボットにプライベートチャットで直接質問を送信します。返信は現在のプライベートチャットに返されます。
• ボットから追加情報の入力や実行の続行の確認を求められた場合は、テキストの案内に従ってそのまま返信します。
• WhatsAppは会話のスレッドに対応していないため、すべての返信は元のプライベートチャットに残ります。

操作	書き方	説明
直接質問する	今週のデータを分析して	チャネルのデフォルトAgentを使用します。
新しい会話を開始	+new	プライベートチャットでのみ使用できます。
Agentを指定	+agent Agent名称 问题	例：+agent rhea 帮我分析数据。
現在のタスクを取消	+cancel	メッセージ全体をこのとおり正確に送信する必要があります。

グループチャットでの利用

• 共有ボットが対象のグループチャットに参加していること、メッセージを送信するメンバーが個人アカウントの連携を完了していることを、事前に確認します。
• メッセージを送信する際は、WhatsApp標準の@メンション機能で共有ボットを選択する必要があります。似た名前を手入力しただけではトリガーされません。
• ボットを@メンションしていない通常のグループメッセージは無視され、Agentの会話には入りません。
• グループチャットでは +new は使用できません。タスクを取消するには @机器人 +cancel を送信します。

管理者によるグループチャット振り分けの設定

1. 「システム管理 → チャンネル管理」に進み、対象のWhatsAppチャネルで「メッセージ振り分け」を開きます。
2. 既定のAgentまたはTeamを選択します。グループチャット振り分けを有効にする前に、既定の対象を設定する必要があります。
3. 必要に応じて呼び出しコマンドとキーワードのルールを追加し、保存します。
4. テスト用のグループで @机器人 +help を送信し、現在のユーザーが使用できるAgent/Teamを確認します。

用途	例	説明
利用可能な機能を確認	@机器人 +help	現在のユーザーが使用できるAgent/Teamを表示します。
機能を指定	@机器人 +analysis 分析本周数据	管理者が設定した呼び出しコマンドに従って振り分けます。
キーワードで振り分け	@机器人 帮我检查埋点方案	ルールに一致した場合は対応する機能を、一致しない場合は既定の対象を使用します。

グループチャットのコンテキスト：システムが参照するのは、最近ボットを明示的に@メンションし、実際に処理された公開グループチャットのターンのみです。@メンションされていない通常のグループメッセージ、他のグループチャット、個人のプライベートチャットは混ざりません。

5. 添付ファイルとタスク通知

添付ファイルの送受信

• ボットには、JPEG/PNG画像と、TXT、Markdown、CSV、JSON、PDF、Word、Excel、PowerPointのドキュメントを送信できます。
• 音声、動画、ステッカーは現在Agentに渡されません。ボットが処理できない理由を案内します。
• デフォルトでは、1ファイルあたり2 MiBまで、1メッセージあたり最大5個の添付ファイルを処理します。超える場合は、ファイルを圧縮するか分けて送信してください。
• Agentが生成した画像やサポート対象のドキュメントは、元のプライベートチャットまたはグループチャットに直接送り返されます。

Agent Teamのタスク通知

1. Agent Teamの即時タスクまたはスケジュールタスクを作成する際に、通知チャンネルとしてWhatsAppを選択します。
2. タスクが終了すると、共有ボットがタスク作成者の連携済みWhatsAppアカウントにプライベートチャットで通知します。
3. 長い結果は自動的に複数のメッセージに分割して送信されます。

通知が届かない場合は、個人アカウントが引き続き「連携済み」になっているか、WhatsAppチャネルがオンラインか、タスクでWhatsApp通知が選択されているかを確認してください。通知の配信に失敗しても、タスク自体の最終ステータスは変わりません。

6. 接続管理とよくある質問

管理者による接続の管理

• チャネルの連携に成功すると、チャネル一覧の「QR コードで連携」が「連携を管理」に変わります。
• チャネルに「再連携が必要」または「WhatsApp の接続が切れました」と表示された場合は、「連携を管理」で案内に従ってQRコードを再度スキャンします。
• 共有ボットのアカウントを変更する前に、まずチャネルを無効にし、「連携をリセット」を実行してから新しいアカウントでスキャンします。
• 連携をリセットすると、既存のユーザー連携が解除され、未使用の連携コードも無効になります。実行前にユーザーに通知し、完了後にユーザーに再度連携してもらってください。
• チャネルを削除すると、そのチャネルでのメッセージの送受信が停止します。今後使用しないことを確認してから削除してください。

よくある質問

現象	対処方法
ワークベンチにWhatsAppの連携の入口がない	チャネルが有効になっていて、QRコードのスキャンに成功し、「オンライン」と表示されていることを管理者に確認してもらってください。
連携コードが無効、または期限切れになっている	ワークベンチに戻って再生成し、10分以内に正しい共有ボットへプライベートチャットでコマンド全体を送信してください。
プライベートチャットは正常だが、グループチャットで応答がない	ボットがグループチャットに参加していること、送信者が連携済みであること、WhatsApp標準の@メンションでボットを選択していることを確認してください。グループチャット振り分けを有効にしている場合は、既定のAgent/Teamの設定も必要です。
QRコードが期限切れ、または読み込みに失敗する	「QR コードを再生成」をクリックします。それでも生成できない場合は、システム管理者にお問い合わせください。
スキャン後もオフラインと表示される	しばらく待ってからチャネル一覧を更新します。それでもオンラインにならない場合は、「連携を管理」から再連携するか、システム管理者にお問い合わせください。
テキストは正常だが、添付ファイルを処理できない	ファイルタイプ、サイズ、数を確認し、ファイルを圧縮するか分けて送信してみてください。
Teamのタスク通知が届かない	アカウントの連携ステータス、チャネルのオンライン状態、タスクでWhatsApp通知が選択されているかを確認してください。
連携先のプラットフォームアカウントを変更したい	まず元のAgentic Engineアカウントの「チャネル連携」で連携を解除してから、新しいアカウントでログインして連携コードを再生成してください。

警告

スマートフォン側でこの共有ボットに対応する「リンク済みデバイス」を削除すると、チャネルの接続が切れます。管理者がプラットフォームでQRコードを再度スキャンして連携する必要があります。

---

関連ページと次のステップ

• 他のプラットフォームの接続手順を確認する：チャンネル管理。
• チャネル接続と連携の全体的な流れを確認する：チャネルの概要と連携。
• 使用するAgentを設定する：Agent。
• プラットフォーム内での会話の使い方を確認する：会話。