# WhatsAppグループ（ベータ版） 接続済みの [WhatsApp Web](whatsapp-web.md) 番号のWhatsAppグループをインボックスに表示し、アプリから返信できます。選択した各グループは1つのチャットとして扱われ、メッセージには各メンバーの名前が表示されるため、会話を追ったり、メンバーのメッセージを引用したり、電話と同じようにメンションを送ったりすることができます。必要に応じて、AIエージェントにグループ内で回答させることも可能ですが、その場合はメンバーがあなたの番号をメンションしたとき、またはAIのメッセージに返信したときに限られます。 > **ベータ版。** WhatsAppグループ機能は新機能であり、現在も改善が続けられています。本機能は有料プランで利用可能です。無料プランでは「グループ」セクションはロックされた状態で表示されます。アカウントが代理店によって管理されている場合、グループ機能を利用できるかどうかは代理店が決定します。 グループ機能はWhatsApp Web番号でのみ動作します。WhatsApp Business APIは1対1の通信を前提としているため、グループ機能は利用できません。 --- ## 始める前に - グループ機能は**デフォルトでオフ**になっています。番号に対してグループ機能を有効にし、自分でグループを選択するまで、アプリには何も表示されません。 - **グループ内の全員があなたの返信を見ることができます。** AIの返信を有効にしている場合は、AIの返信も同様です。グループ内では、電話で書き込むときと同じように書き込んでください。 - **WhatsAppはグループ内で自動化を行うアカウントに対して独自のルールを適用しており、** 自動返信を送信するアカウントを制限する場合があります。AIは、利用が想定されているグループでのみ使用するようにしてください。 - **過去のメッセージは取り込まれません。** グループを有効にした後に届いたメッセージが表示され、それ以前の履歴は表示されません。 --- ## ステップ1：番号のグループ機能を有効にする 1. **設定 → チャネル** に移動します。 2. 対象となる番号の **WhatsApp Web** カードを見つけます。番号が接続されている必要があります。 3. そのカードの **グループ** セクションを開きます（**ベータ版**バッジが付いています）。 4. **「グループメンバーは私の返信を見ることができます。WhatsAppはグループ内で自動返信を送信するアカウントを制限する場合があります。」** のチェックボックスをオンにします。これを行うまでスイッチはグレーアウトしたままです。 5. **「WhatsAppグループをインボックスに表示する」** をオンにします。 このスイッチは番号ごとに設定されます。他のWhatsApp Web番号は、同様に有効にするまでそのままの状態です。 --- ## ステップ2：表示するグループを選択する スイッチをオンにすると、その番号が参加しているすべてのグループがリスト表示されます。グループ名、メンバー数、およびあなたの番号が管理者の場合は **管理者** バッジが表示されます。管理者のみが書き込めるグループには **管理者のみ** と表示されます。 1. アプリに表示したい各グループの **インボックスに表示** をオンにします。 2. 新しく参加したグループがリストに表示されない場合は、**グループを更新** をクリックします。 1つの番号につき最大 **25グループ** まで表示できます。カードには使用状況（「25グループ中3つを表示」など）が表示されます。25グループに達した後に別のグループを表示するには、先にいずれかのグループを非表示にする必要があります。グループを非表示にすると、そのグループからの新しいメッセージは届かなくなります。 --- ## グループチャットでの操作 表示した各グループは、**チャット** 内に1つのチャットとして表示されます。これには **グループ** ラベル、メンバー数、最新のメッセージが含まれます。 - **誰が何を書いたか。** 各メンバーのメッセージには名前と固有のカラーが表示され、連続するメッセージの最初のものにはアイコンが表示されます。名前は、その人とすでにプライベートチャットをしている場合は保存した名前が、それ以外の場合はWhatsAppで使用している名前が、それも不明な場合は電話番号が表示されます。 - **自分のメッセージ。** アプリから送信したメッセージや、電話でグループ内に書き込んだメッセージは、チャットの自分の側に表示されます。 - **メンバーへの返信。** メンバーのメッセージに対して **返信** を使用すると、電話と同じように引用返信ができます。 - **メンバーへのメンション。** メッセージボックスに **@** と入力し、リストからメンバーを選択します。相手にはWhatsAppのメンションが通知されます。 - **写真、ボイスメモ、リアクション、既読マーク** は、1対1のWhatsApp Webチャットと同じように動作します。 ### 返信待ちのメッセージ グループ内の最新のメッセージがメンバーからのもので、それ以降こちら側から誰も返信していない場合、グループの行に「**2件の返信待ち**」のように、返信が必要なメッセージ数が表示されます。チャットリスト上部の「**返信が必要**」フィルターを使用すると、それらのグループのみを表示できます。 これに関する通知を受け取ることも可能です。「**WhatsAppグループの返信待ちメッセージ**」通知は、グループごとに最大10分に1回送信されます。他の通知設定と同様に、オンまたはオフに切り替えられます。 ### グループの詳細 グループのサイドパネル（「**グループの詳細**」）を開くと、以下を確認できます。 - **メンバー**: グループの人数とメンバーの全リスト。 - メンバーの横にある「**プライベートチャットを開く**」: その相手との1対1のチャットを開くか、作成します。相手にメッセージは送信されません。WhatsAppがメンバーの番号を非表示にしている場合、この機能は利用できません。その場合、メンバーには「**番号非表示**」と表示され、グループ内でのみ連絡を取ることができます。 - **このメンバーのAIをミュート**: AIはこのグループ内でこのメンバーに応答しなくなります。プライベートチャットには影響しません。 - **このグループのAI**および**AIエージェント**: AIがこのグループで有効かどうか、またどのアカウントが応答するか（下記参照）。 - **会話を要約**: グループ内の最新の会話をAIが短く要約し、誰が何を言ったかをまとめます。 ### グループに書き込めなくなった場合 - あなたの番号がグループを退会したか、削除された場合、チャットには「**あなたの番号はこのグループに含まれていないため、メッセージを送信できません。**」と表示されます。AIもそのグループでの動作を停止します。 - グループが管理者のみ送信可能に設定されており、あなたの番号が管理者でない場合、その旨がチャットに表示され、メッセージは送信されません。 この状況が発生した際に通知を受け取る設定が可能です：「**WhatsAppグループから削除されました**」。 --- ## グループでAIに応答させる AIオプションがまだ表示されない場合は、アカウントで有効になっていません。 AIはグループごとに設定され、以下の2つの選択肢があります。 - **オフ**: AIはこのグループで一切書き込みを行いません。これがデフォルト設定です。 - **メンション時**: AIは、あなたの番号にメンションを送ったメンバー、またはAIのメッセージに返信したメンバーに対してのみ応答します。グループ内でそのメンバーの名前を呼び、メッセージを引用して返信します。メンバーにプライベートメッセージを送ることはありません。 設定手順: 1. 「**設定**」→「**チャネル**」の番号の「**グループ**」リストで、対象グループの「**AI**」を「**メンション時**」に設定します。グループの「**受信トレイに表示**」がオンになると、AIの選択肢が表示されます。（グループのサイドパネルにある「**このグループのAI**」からも変更可能です。） 2. グループで応答するエージェントをプラットフォームに指定します。「**AI Studio**」→「**AIエージェント**」でエージェントを開き、「**エントリーポイント**」タブに移動して、「**新しいエントリーポイント**」をクリックし、「**WhatsAppグループ**」を選択します。 3. 「**対象グループ**」で、「**AIがオンのすべてのグループ**」または「**特定のグループのみ**」を選択し、対象グループにチェックを入れます。 4. 必要に応じて「**コメントキーワード**」を追加します。AIは、これらのキーワードのいずれかを含むメッセージにのみ応答するようになります。 5. ルールはオフの状態で開始されます。「**すぐに回答を開始する**」にチェックを入れるか、準備ができたらリストからルールをオンにして、「**保存**」をクリックします。 グループ内でのAIの動作: - あなたの番号へのメンションや、AIのメッセージへの引用がないメッセージには反応しません。そのようなメッセージにはチャット内に短い注記（**AI宛ではないグループメッセージ**）が表示され、料金は発生しません。 - 最大2件までのテキストメッセージで返信します。グループ内では予約の受付やその他のアクションは行いません。 - グループの平穏を保つため、同一メンバーへの返信は2時間に1回まで、1グループあたりの1日の返信は最大20件までとし、同一グループ内でのメッセージ送信間隔は20秒以上空けます。 - ミュートしたメンバーには一切返信せず、スパムとしてフラグが立てられたメッセージにも返信しません（そのメッセージはスパムとしてマークされた状態でチャット内に表示されます）。 - **500人を超えるメンバー**がいるグループは受信トレイに表示される場合がありますが、AIはそのグループでは利用できません。 --- ## グループで決して行われないこと - グループは連絡先にはなりません。グループやそのメンバーは、あなたの連絡先、リスト、スマートリストに追加されることはなく、連絡先のエクスポートにも表示されません。メンバーが連絡先に変換されることもありません。**プライベートチャットを開く**をクリックしたときにのみ、そのメンバーの連絡先が作成されます。 - グループに対して一斉送信（ブロードキャスト）を行うことはできず、グループ内でフォローアップが送信されることもありません。 - 連絡先作成時に開始される自動化は、グループには適用されません。 - アプリがグループを作成したり、メンバーを追加したり、招待リンクを共有したりすることはありません。また、グループ内でAIが自発的に最初のメッセージを送信することもありません。 --- ## グループの料金 グループに対する追加料金はありません。グループは番号の既存の接続料金に含まれており、グループに届くメッセージは無料です。 グループ内でのAIの返信には、他のAI返信と同じクレジットが消費されます。これは「無制限AI（Unlimited AI）」プランの番号にも適用されます。無制限AIは1対1のチャットを対象としており、グループ内での返信は対象外です。 グループ内であなたが送信したメッセージは、グループのメンバー数に関わらず、その番号の1日あたりの送信制限に対して1メッセージとしてカウントされます。 --- ## トラブルシューティング ### グループがリストに表示されない 番号の「グループ」セクションで **グループを更新** をクリックしてください。リストには、現在その番号が参加しているグループのみが表示されます。番号が退出したグループには **退出済み** と表示されます。 ### 「受信トレイに表示」をオンにできない この番号ではすでに25個のグループを表示しています。別のグループを表示するには、既存のグループを非表示にしてください。 ### AIがグループ内で返信しない 以下の順序で確認してください: 1. グループの **AI** 設定が **メンション時** になっていること。 2. エージェントにこのグループをカバーする **WhatsAppグループ** のエントリーポイントがあり、ルールがオンになっていること。 3. メンバーがあなたの番号をメンションしたか、AIのメッセージに返信していること。グループ内の通常のメッセージは、意図的に無視されます。 4. メンバーがミュートされておらず、グループのメンバー数が500人以下であり、AIがそのメンバーまたはグループに対する制限（上記参照）に達していないこと。 **AI** オプションが完全に表示されない場合は、お客様のアカウントでまだ有効になっていません。 --- ## 関連情報 - [WhatsApp Web](whatsapp-web.md): 番号の接続、送信制限、ウォームアップについて。 - [エントリーポイント](../ai-agents/entry-points.md): 各チャネルでエージェントがどのように選択されるかについて。 - [エラーログ](../settings/error-log.md#app-3314): グループメッセージがAIに送信されなかった場合に表示される注記について。