
# タグを使用して連絡先にラベルを付ける

タグは、連絡先、チャット、キャンペーンなどで再利用できるラベルです（例：「興味あり」、「予約済み」、「興味なし」など）。

タグは、AIエージェントと組み合わせると特に強力です。エージェント（または従来のキャンペーン）は、会話の進み具合に基づいて連絡先に自動的にタグを付けることができます。また、タグは[Webhook](../integrations/webhooks.md)を通じて他のツールの操作をトリガーしたり、連絡先を取引パイプライン内で自動的に移動させたりすることも可能です。


---

## タグを使用する理由

- **会話の結果を追跡** — どの連絡先が予約したか、興味を示したか、フォローアップが必要かを一目で把握できます。
- **タグを一目で確認** — タグは連絡先テーブルの列として表示されます。
- **フィルタリングとセグメント化** — スマートフィルタチップやフィルタパネルを使用して、特定のタグを持つすべての連絡先を検索できます。
- **ワークフローの自動化** — タグが適用されるたびにWebhookを起動し、他のツールに通知を送ることができます。
- **取引アクションのトリガー** — タグを使用して取引を作成したり、既存の取引をパイプライン内で移動させたりできます。[セールスパイプライン](../deals/sales-pipeline.md)を参照してください。

---

## タグページを開く方法

1. 左側のサイドバーで、**設定**（歯車アイコン）をクリックします。
2. 設定サイドバーの**ワークスペース**グループの下にある**タグ**をクリックします。


> **ワークスペースグループに「タグ」が表示されない場合**、ご利用のサブスクリプションプランにはタグ機能が含まれていません。同じサイドバーにある**請求**をクリックしてアップグレードしてください。

---

## タグを作成する方法

1. タグページを開きます（上記の手順を参照）。
2. **新しいタグ**の下に名前を入力します（例：`VIP`、`Spanish`、`Trial`など）。短く、数単語以内に収めてください。
3. **タグを追加**をクリックします。


新しいタグは下のリストに即座に表示され、すぐに使用できるようになります。[チャット](../chats/chat-interface.md)から連絡先に適用したり、連絡先やチャットの一括**タグ付け**アクションを使用したり、AIエージェントに自動的に適用させたりすることができます。

> **作成に失敗した場合**、その名前のタグがすでにアカウントに存在している可能性があります。別の名前を選択するか、既存の名前を変更してください（下記を参照）。

---

## タグの名前を変更する

以前とは異なり、**直接名前を変更できるようになりました**。リストからタグを見つけ、名前の横にある鉛筆アイコンをクリックし、インラインでテキストを編集して、チェックマークをクリックして保存します（または**×**をクリックしてキャンセルします）。タグを再作成したり、すべての連絡先に手動でタグを付け直したりする必要はありません。


---

## タグリスト

タグはリスト形式で表示され、各行には以下が含まれます：

- **チェックボックス** — 一括選択用。
- **タグ名** — チップとして表示されます。
- **連絡先数** — 現在このタグが付いている連絡先の数。
- **鉛筆アイコン** — インラインで名前を変更します。
- **ゴミ箱アイコン**（赤） — このタグを削除します。

リストの上部にある**検索ボックス**で名前によるフィルタリングが可能です。タグの数が増えてきた場合に便利です。ヘッダーには、タグの合計数と、タグ付けされている連絡先の総数が表示されます。

> **知っておくべきこと:** タグページには、タグごとの**要約を生成**トグル（タグが適用されるたびにAIが自動的に会話の要約を作成する設定）はありません。ここで作成または名前変更したタグには、この方法で構成されたAI要約は適用されません。以前に構成されたタグでその機能を利用している場合、その設定は変更されませんが、現在このページからオン/オフを切り替えるコントロールはありません。

### 単一のタグを削除する

1. タグの行にある**ゴミ箱アイコン**をクリックします。
2. ポップアップで確認します。現在そのタグが付いている連絡先の数が表示されます。この操作は取り消せません。


### 複数のタグを一度に削除する

1. 削除したいタグのチェックボックスにチェックを入れます。
2. 画面下部に選択した数が表示されたフローティングバーが表示されます。
3. そのバーの**削除**をクリックし、確認します。


タグの削除は元に戻せません。AIエージェントやキャンペーンでその名前のタグを使用するルールが設定されている場合、次にタグが適用される際に新しいタグが作成されますが、削除したタグの履歴は失われ、関連付けられていた取引パイプラインのリンクは切断されます。削除後は、エージェント、キャンペーン、取引の自動化設定を確認してください。

---

## 連絡先へのタグの適用

AIエージェントに連絡先を自動的にタグ付けさせる（下記参照）以外にも、以下の場所で手動でタグの適用や削除を行うことができます。

- **チャットから** — [チャット](../chats/chat-interface.md)で連絡先の会話を開きます。右側の連絡先パネルにある「**タグ**」セクションで現在のタグを確認し、「**管理**」リンクをクリックするか、会話の「**⋯**」メニューを開いて「**タグを管理…**」を選択します。
- **一括で** — 複数の連絡先（「連絡先」内）またはチャット（「チャット」内）を選択し、「**タグ付け**」の一括アクションを使用します。
- **後からAIに判断させる** — 「**AIで自動タグ付け**」を実行すると、エージェントのタグ付けルールを会話全体に対してオンデマンドで適用できます。詳細は[会話へのオンデマンドタグ付け](#tagging-a-conversation-on-demand)を参照してください。
- **自動的に** — AIエージェントやキャンペーンがチャット中にタグを適用するように設定します（下記参照）。


どちらのパスからでも同じ **タグの割り当て** ダイアログが開きます。リストを検索またはスクロールし、適用するタグにチェックを入れます。必要に応じて、ダイアログを閉じることなく **新しいタグを作成** をクリックし、最後に **タグを適用** をクリックします。


---

## AIエージェントによる連絡先の自動タグ付け

これがタグの強力な点です。自分で連絡先にタグを付ける代わりに、AIに監視対象を指示することで、会話の途中でAIが自動的にタグを適用します。これはAIエージェントごと（または、まだエージェントに移行していない場合は従来のキャンペーンごと）の **タグ** ステップで設定します。上記のタグ設定ページは再利用可能なタグライブラリ自体を管理するためのものであり、ここでの設定とは異なります。

1. [AIエージェント](../ai-agents/ai-agents.md)（またはキャンペーン）エディタを開き、**タグ**ステップに移動します。
2. **タグを追加**をクリックし、ライブラリから既存のタグを選択するか、新しい名前を入力します。
3. **適用条件**の下に、タグをトリガーする状況を記述します。例：*「連絡先が通話の予約を希望している、または価格について質問している場合」*
4. 必要に応じて**Webhook URL**を追加します。<span data-t="appName">Your AI Connector</span>は、タグが適用された瞬間にその連絡先とタグをそのURLにPOSTします。最初にタグを保存してから、フィールドの横にある**テスト**を使用してサンプルペイロードをすぐに送信し、自動化がそれを受信することを確認してください。
5. AIが後で連絡先からタグを削除できるようにしたい場合を除き、**AIにこのタグを削除させる**はオフのままにしてください。以下の[AIの判断方法](#how-the-ai-decides--adding-and-removing)を参照してください。
6. **変更を保存**をクリックします。

### AIにタグのルールを作成させる

AIエージェントの**タグ**ステップには、**AIで生成**ボタンもあります。このボタンをクリックすると、エージェントの指示とビジネスコンテキストを読み取り、一連のタグ（通常3〜8個）を提案します。各タグには、エージェントの言語で記述された「適用条件」ルールがすでに含まれています。新しい名前を作成する前に、既存のタグライブラリを検索し、同じ意味を持つ既存のタグがあればそれを再利用します。そのため、追加されるタグは、チームがすでにフィルタリングや自動化に使用しているタグと整合性が保たれます。**自分のタグに追加**（現在のタグを保持し、新しいタグのみを追加）または**すべてのタグを置き換え**を選択し、他のタグと同様に行を確認・編集してください。1回の実行につき1クレジット（Maxティアでは0.25クレジット、独自のAIキーでエージェントを実行する場合は無料）がかかります。ウェブサイトやドキュメントから作成されたエージェントは、セットアップウィザードまたは**新しいエージェント**のいずれであっても、タグが自動的に生成されるため、このリストはすでに埋まっていることがよくあります。生成されたタグは、AIが初めて連絡先に適用した時点でタグライブラリに追加されます。それ以前に追加されることはありません。提案された行を削除すれば、どこにも表示されることはありません。



> **エージェントタグとキャンペーンタグの違い:** まだ従来のキャンペーンを使用している場合でも、そのタグステップは同じように動作します。エージェントに移行してもタグのルールは引き継がれます。詳細は [AIエージェント](../ai-agents/ai-agents.md) を参照してください。

### AIの判断方法 — 追加と削除

AIは返信のたびに、最近の会話内容とお客様のタグ付けルールを照らし合わせ、連絡先のタグを更新します。AIの判断について知っておくべきポイントは以下の通りです。

- **会話がルールと明確に一致する場合にのみタグを追加します。** 「おそらく」では不十分です。確信が持てない場合は、タグを付けません。
- **タグを削除することもできますが、許可した場合に限ります。** 各タグには**AIにこのタグを削除させる**スイッチがあり、デフォルトではオフになっています。タグのルールでタグを外すべきタイミングを記述している場合（例：*「支払いが期限を過ぎている間は適用し、支払いが完了したら削除する」*）は、このスイッチをオンにしてください。会話がその条件を満たしていると判断した瞬間に、AIがタグを削除します。スイッチがオフの場合、タグは適用専用となり、AIはタグを付けることはあっても削除することはありません。タグの削除は無料です（クレジットを消費しません）。
- **連絡先がすでに持っているタグや今日の日付を認識しているため**、「今日現在で期限切れ」や「毎月5日に支払い」といったルールが記述通りに機能します。
- **ユニークなセットは整理された状態を保ちます。** 連絡先が一度に1つしか持てないタグのセット（支払い期日の日付タグなど）を使用している場合、AIは古いタグをそのままにするのではなく、正しいタグに変更された時点で古いタグを入れ替えます。セット内のすべてのタグで削除スイッチをオンにしてください。そうしないと、古いタグが残ったままになります。
- **エージェントのタグリストに含まれていないタグには一切触れません。** エージェントのルールの一部ではない手動で適用したタグは、そのまま保持されます。

> **ヒント — 削除条件もルールに記述してください。** 「適用条件」のテキスト欄には、タグを外すべきタイミングも記述できます。*「価格について質問があったら追加し、購入後に削除する」*といったルールにすれば、AIに両方の条件を伝えることができます。ただし、ルールだけでは不十分です。**AIにこのタグを削除させる**スイッチもオンにする必要があります。

> **なぜ削除がデフォルトでオフなのか（2026年8月12日変更）。** 「適用条件」はタグが「真」になるタイミングを記述するものですが、AIがその逆を読み取ってしまうことがありました。単に会話のトピックではなくなっただけのタグを削除してしまうのです。以前はタグのWebhookが削除時にも実行されていたため、すでにそのステップを通過した連絡先に対して自動化が再実行される可能性がありました。タグのWebhookは現在、適用時にのみ実行されるようになり、削除はタグごとにスイッチをオンにする仕組みに変更されました。既存のタグはすべて保持されます。もしAIによるタグの削除に依存していた場合は、そのタグのスイッチをオンにしてください。

### 会話へのオンデマンドタグ付け

リアルタイムのタグ付けは、AI自身が返信を行う場合にのみ発生します。チームがAIを一時停止して対応した会話、WhatsAppの履歴からインポートされたチャット、およびエージェントのタグ付けルールを作成する前に発生したやり取りは、AIによって確認されません。また、新しいルールを追加したり「**AIで生成**」をクリックしたりした際にも、既存の会話は自動的には処理されません。「**AIで自動タグ付け**」はこれらすべてをカバーします。ワンクリックで、エージェントのタグ付けルールを直近のメッセージだけでなく*会話全体*に対して実行し、リアルタイムのタグ付けと同様にタグの追加や削除を行います。

開始方法は以下の3通りです。

- **1つのチャット** — 会話を開き、ヘッダーの「**3点メニュー**」（⋯）をクリックして「**AIで自動タグ付け**」を選択します。確認後、しばらくするとどのタグが追加または削除されたかを示すメッセージが表示されます。


- **複数の連絡先** — 「**連絡先**」ページで連絡先にチェックを入れ、フローティングアクションバーの「**自動タグ付け**」をクリックします。デフォルトでは各連絡先が自身のAIエージェントのルールに基づいて判断されます。「**すべてにこのエージェントのタグを使用**」でエージェントを選択すると、選択した全員にそのエージェントのルールを適用できます。実行中はウィンドウに進捗が表示され、完了すると概要が表示されます。ウィンドウを閉じても実行は継続されます。


- **エージェントが処理するすべての会話** — エージェントの「**タグ**」タブで、「**既存の会話に適用**」をクリックします。そのエージェントの最新の会話のうち、最大500件に対してルールが実行されます。


期待される動作:

- **同じルール、同じ判断。** リアルタイムのタグ付けと全く同様に、「適用タイミング」のルールと「**AIによるタグ削除を許可**」スイッチに従います。エージェントのリストにないタグを追加したり、許可されていないタグを削除したりすることはありません。
- **同じ料金。** タグ1件の適用につき1クレジット（Maxプランでは0.25、独自のAIキーを使用している場合は無料）がかかります。会話の読み取りは無料であるため、新しいタグが適用されなかった連絡先には料金は発生せず、タグの削除にも料金はかかりません。これはリアルタイムのタグ付けと同じ料金体系であるため、リアルタイムのタグ付けをオフにして別の方法でタグを取得しても、コストが安くなることはありません。
- **1回につき最大500件の連絡先、一度に1つの実行。** メッセージがまだない連絡先、AIエージェントが割り当てられていない連絡先、またはタグ付けルールがないエージェントを持つ連絡先はスキップされ、概要にカウントされます。実行中にクレジットが不足した場合、その時点で停止しますが、それまでにタグ付けされた内容は保持されます。

---

## 次のステップ

- [AIエージェント](../ai-agents/ai-agents.md) — 連絡先に自動でタグを付けるエージェントを設定します。
- [チャットインターフェース](../chats/chat-interface.md) — 個々の連絡先にタグを適用または管理します。
- [Webhook](../integrations/webhooks.md) — タグを他のツールと連携させ、ワークフローを自動化します。
- [新しい連絡先の追加](creating-contacts.md) — 連絡先を追加する際にタグを適用します。
