# リストと連絡先の整理

リストは連絡先をグループ化する機能です。「新規リード」「VIP顧客」「ニュースレター購読者」などのリストを作成することで、適切な相手に適切なメッセージを送信できます。

このガイドでは、リストの検索と管理、リスト内の連絡先の閲覧、連絡先の編集、およびメインテーブルからの連絡先の一括管理方法について説明します。


---

## リストの場所

どちらも同じ**連絡先**エリア内にあり、ページ上部の2つのタブで切り替えることができます。

- **連絡先タブ** — テーブルの上にコンパクトなリストピッカーがあり、その横に常に表示される**+ リストを作成**ボタンがあります。
- **リストタブ**（**連絡先**の横にある**リスト**をクリック） — すべてのリストを作成、名前変更、削除、閲覧するための専用ページです。各行にはメンバー数と**「N件のキャンペーン/ブロードキャストに配信中」**というインジケーターが表示されます。


### リストピッカー（連絡先タブ）

1. 左側のサイドバーで**連絡先**をクリックします。
2. テーブルの上にある**リストピッカー**のピルをクリックします。リストのドロップダウンが開き、各リストの名前と連絡先数が表示されます。いずれかを選択してテーブルをそのリストで絞り込むか、**すべての連絡先**を選択してフィルターを解除します。
3. リストを選択した後、もう一度ドロップダウンをクリックすると、**リストを編集**、**リストIDをコピー**、**リストを削除**、**リストと連絡先を削除**といった操作が可能です。これらは、連絡先ページを離れることなく実行できます。


ピッカーの横には常設の**+ リストを作成**ボタンがあり、事前に何かを選択する必要はありません。

### 「リスト」ページ

**連絡先**の横にある**リスト**タブをクリックします。すべてのリストが、名前、メンバー数、および**「N件のキャンペーン/ブロードキャストに配信中」**インジケーター（そのリストに新しく追加された連絡先に自動的にメッセージを送信するアクティブなブロードキャストやキャンペーンの数）とともに表示されます（これが重要な理由については[リストへの連絡先の追加](#adding-contacts-to-a-list)を参照してください）。


リストの**行メニュー**（「⋯」）を開くと、以下の操作が可能です。

| オプション | 説明 |
|---|---|
| **リストを編集** | リストの名前を変更し、含まれる連絡先を変更できます。 |
| **リストIDをコピー** | リストの内部IDをクリップボードにコピーします（APIやWebhookで便利です）。 |
| **リストを削除** | リスト自体を削除しますが、アカウント内の**すべての連絡先は保持されます**。単にこのリストから削除されるだけです。 |
| **リストと連絡先を削除** | リストを削除し、そのリストに含まれる**すべての連絡先を完全に削除**します。この操作は取り消せません。 |

2つの削除オプションは赤色で表示され、それぞれ確認画面が開きます。リストの削除とリスト内の連絡先の削除は常に別々の「本当に実行しますか？」というステップになっているため、リストだけを削除するつもりが誤って連絡先まで消去してしまうことはありません。

> **リストがブロードキャストで使用されている場合**、そのリストを削除することはできません。ダイアログに該当するブロードキャスト名が表示されます。**ブロードキャスト**ページを開き、ブロードキャストを削除するか、別のリストを指定してリストの関連付けを解除してから、再度お試しください。

---

## 新しいリストの作成

リストピッカー（連絡先タブ）またはリストページ上部の**+ 新規リスト**ボタンから操作します。

1. **+ Create list** / **+ New List** をクリックします。
2. **List type** で、**Static list** が選択されていることを確認します。これは通常のリストで、連絡先を自分で選択します。（**Smart list** はルールに基づいて自動的に入力されます。以下の [Smart Lists](#smart-lists-auto-updating) を参照してください。）
3. 名前を入力します（例: `Summer Sale Contacts`）。
4. *(オプション)* ダイアログに表示される場合は、すぐに連絡先を追加します。
5. **Create list** をクリックします。


新しいリストは、ピッカーと「リスト」ページの両方に即座に表示されます。

> **「リストを作成」が表示されない場合：** お使いのアカウントには連絡先を編集する権限がありません。アカウントの所有者に連絡し、チームの役割を更新してもらってください。

---

## スマートリスト（自動更新）

**スマートリスト**は、自分で入力する必要のないリストです。一度ルールを設定すれば（例：「タグ `hot-lead` を持ち、過去90日以内にアクティブである」）、リストは自動的に最新の状態に保たれます。条件に一致する人が追加され、一致しなくなった人は削除されるため、手動で操作する必要はありません。

通常の（**静的**）リストはその逆で、追加した連絡先は、削除するまでリストに残り続けます。どちらのリストも他の機能では同様に動作します。スマートリストに対して一斉送信を行ったり、連絡先テーブルをフィルタリングしたり、他のリストと全く同じようにエクスポートしたりできます。

### スマートリストの作成

1. **Lists** タブで、**+ New list** をクリックします。
2. **List type** で **Smart list** を選択します。
3. 名前を付けます（例: `Hot leads (active)`）。
4. **Rules** で **Match: All rules** または **Any rule**（下記参照）を選択し、最初のルールを作成します。チェックする項目、比較方法、値を指定します。
5. 条件を追加する場合は、**+ Add rule** をクリックします。スマートリストには最大20個のルールを使用できます。
6. ルール下の行を確認してください。現在一致している連絡先の数がカウントされ（「≈ 3 contacts match」）、その一部が表示されます。保存する前に、ルールが意図した通りに機能しているか確認できます。
7. **Create list** をクリックします。


リストは作成した瞬間に埋められるため、開いたときにはすでにメンバーが含まれています。

### すべてのルールに一致 vs いずれかのルールに一致

- **All rules** — *すべての*ルールが真である場合にのみ、連絡先がリストに含まれます。絞り込みに使用します（「タグ `hot-lead` を持ち、**かつ**過去90日以内にアクティブ」）。
- **Any rule** — *少なくとも1つ*のルールが真である場合に、連絡先がリストに含まれます。収集に使用します（「タグ `newsletter` を持つ、**または**タグ `webinar` を持つ」）。

### ルールの作成対象

| グループ | 確認できる項目 |
|---|---|
| **人物属性** | **タグ**（いずれかを含む / すべて含む / いずれも含まない）、**リスト**（含まれる / 含まれない — 通常のリストのみ）、**チャネル**（WhatsApp、SMS、Instagramなど）、**ステータス** |
| **行動履歴** | **追加日**、**最終アクティビティ**、**最後に受信したメッセージ**、**最後に送信したメッセージ**、**最初のAI会話**、**最後のAI会話** — それぞれ「過去N時間/日以内」、「過去N時間/日以内ではない」（一度も行っていないユーザーも含まれます）、特定の日時の前後（時刻指定も可能）で設定できます。また、**現在**ボタンを使用すると現在の時刻が入力されます（例えば、大規模なインポート直前に、それ以降に追加された連絡先のみを抽出する場合に便利です）。単に「入力済み」または「空」で指定することも可能です。また、**AIと会話した**（オン/オフ）も設定できます |
| **設定** | **AI返信**（オン/オフ）、**おやすみモード**、**プライベート連絡先**、**返信履歴あり** |
| **取引** | **取引ステージ** — 選択したパイプラインステージのいずれか（またはなし）に[取引](../deals/sales-pipeline.md)があるか、単に**取引あり** / **取引なし** かどうか |
| **詳細情報** | **メールアドレス**、**電話番号**、**名**、**姓** — 入力済み、空、特定のテキストを含む/含まない。**割り当てられたキャンペーン**、**割り当てられた担当者**、および名前による任意の**カスタムフィールド** |

テキスト比較において大文字と小文字は区別されません。「過去30日以内に発生していない」というルールは、一度も発生していない連絡先にも一致します。

#### AIが実際に処理した連絡先

**「AIと会話した」**は、AIが少なくとも1通のメッセージを送信したすべての連絡先で「はい」となり、それ以外（チームメンバーのみが返信した相手を含む）は「いいえ」となります。これはAIが初めて相手にメッセージを送信した時点で設定され、その後、AI返信をオフにしたり別のキャンペーンに移動したりしても解除されることはありません。

代理店がよく必要とするような、**特定の期間**にAIが処理した連絡先を抽出したい場合は、代わりに**「最後のAI会話」**で「過去30日以内」を使用してください。これは常に直近1ヶ月を反映するローリングウィンドウとなります。

よく混同される2つのルールがあります：

- **AI返信**（設定内）はスイッチです。これはAIがその連絡先に返信することを「許可」しているかどうかを示すものであり、実際に返信したかどうかを示すものではありません。
- **返信履歴あり**は、チームメンバーを含め、誰かに対して「連絡先側から」返信があったかどうかを指します。

リストを作成しなくても、同様の方法で「連絡先」テーブルをフィルタリングできます。**フィルター**を開いて **AIと会話した** をオンにするか、テーブルの上部にある **AIと会話した** クイックチップをクリックしてください。連絡先レコードではなく会話を探したい場合は、[チャットページ](../chats/chat-interface.md#chat-filters)にも同様の **AIと会話した** チップが用意されています。



### スマートリストの見分け方

Listsページでは、スマートリストには **Smart** バッジが表示され、名前の下にルールの概要が平易な英語で記載され、最後に更新された日時（「Updated 4 minutes ago」）が表示されます。メンバー数はライブカウントです。


### スマートリストが更新されるタイミング

- **連絡先が変更された直後。** タグ付け、ステータスの変更、カスタムフィールドへの入力などを行い、条件に一致（または不一致）するようになると、数秒以内にリストに反映されます。取引を別のパイプラインステージにドラッグした場合も同様で、**取引ステージ**ルールはボードが変更された瞬間に反応します。
- **時間ベースのルールは15分ごと。** 「過去30日間アクティビティなし」のようなルールは、連絡先に触れなくても時間の経過とともに条件を満たすようになるため、すべてのスマートリストは15分周期でも再チェックされます。
- **オンデマンド。** リストの **⋯** メニューを開き、**今すぐ更新**をクリックするとルールが即座に再実行され、行のメンバー数と「更新日時…」の表示がすぐに最新の状態になります。

### 手動でメンバーを追加・削除することはできません

それこそがスマートリストの目的です。メンバーシップはルールに基づいて算出されるため、手動で行った変更は次回のチェック時に元に戻されてしまいます。実際には以下のようになります。

- 展開されたリストには **連絡先を追加** ボタンやメンバーの **削除** ボタンはなく、代わりに*「メンバーはこのリストのルールから算出されます」*と表示されます。
- スマートリストは、連絡先ページの **リスト** 一括操作、連絡先自身のリスト選択ツール、またはインポート先としては表示されません。

リストのメンバーを変更するには、**⋯** メニューを開いて **ルールを編集** をクリックしてください。

### スマートリストとブロードキャスト

ブロードキャストは他のリストと同様にスマートリストをターゲットにできます。これがスマートリストの最も便利な点です。「タグ `hot-lead`、7日間返信なし」という条件を指定すれば、対象者が自動的に維持されます。

> **注意：自動的にメッセージが送信される場合があります。** そのリストに対するライブブロードキャストやキャンペーンで **新しいリストメンバーに送信** がオンになっている場合、ルールに新しく一致したすべての連絡先に自動的に開始メッセージが送信されます。これこそが組み合わせる目的ですが、操作を行わなくてもメッセージが送信される可能性があり、各メッセージはクレジットを消費します。ルールを広げる前に、リストが何に供給されているか（リストページの **供給先** カラム）を確認してください。

---

## リストメンバーの閲覧と検索

「リスト」ページでリストの行をクリックすると、リストが展開され、そのリストに含まれる全員が表示されます。名前、電話番号、またはメールアドレスで検索できる検索ボックスも用意されています。そこから**リスト内の個別の連絡先を削除**できます。これはリストからその連絡先を削除するだけであり、連絡先自体を削除したり、他のリストに影響を与えたりすることはありません。

[スマートリスト](#smart-lists-auto-updating)では、同じパネルは読み取り専用になります。メンバーの閲覧や検索は可能ですが、メンバーシップはルールから生成されるため、削除を行うことはできません。

---

## リストへの連絡先の追加

連絡先をリストに追加するには、展開されたリストビュー、連絡先のクイックビューパネルや詳細レコード、または以下の **リストに追加** 一括操作を使用します。[スマートリスト](#smart-lists-auto-updating)はこれらの場所には表示されません。ルールに基づいて自動的にメンバーが追加されます。

> **注意: リストに連絡先を追加すると、メッセージが送信される場合があります。** そのリストでライブ配信中のブロードキャストの **「新しいリストメンバーに送信」** がオンになっている場合、連絡先を追加するとすぐに開始メッセージが送信され、クレジットが消費され、そのブロードキャストのエージェントに返信が転送されます。
>
> 実行前に警告が表示されます。一括の **「リストに追加」** アクション、リスト自体の **「メンバーを追加」** 画面、連絡先でのリスト切り替えなど、どの方法で追加する場合でも、画面上でどのブロードキャストが送信されるかが通知され、確認が求められます。リストから連絡先を削除しても何も送信されないため、即座に反映されます。
>
> 同じリストで **複数の** ライブ配信中のブロードキャストのトグルがオンになっている場合、新しい連絡先は **それぞれの開始メッセージを1通ずつ** 受け取り、それぞれ個別に課金されます。警告にはその数が表示されます。ブロードキャストの「オーディエンス」ステップからこれを停止できます。詳細は [ブロードキャスト](../broadcasts/broadcasts.md) を参照してください。

---

## 連絡先の編集

1. 「連絡先」テーブルで、連絡先の**行**の任意の場所をクリックして[クイックビューパネル](creating-contacts.md)を開きます。
2. **編集**をクリックします。
3. 名前、電話番号、メールアドレス、チャネル、タグ、またはメモを更新します。
4. **保存**をクリックします。

> **行のクリックと名前のクリックの違い。** 行をクリックするとクイックビューパネルが開きます。連絡先の**名前**をクリックすると、代わりにその相手とのチャットが開きます。詳細は[新しい連絡先の追加](creating-contacts.md)を参照してください。

リストのメンバーシップは、編集フォーム自体からではなく、クイックビューパネルの**「リスト」**セクションから編集します。パネル内の**「リスト」**の横にある**「+」**をクリックし、リストのチェックボックスをオンまたはオフにします。

---

## 一括操作（一度に複数の連絡先を選択する）

1. 連絡先の行の先頭にあるチェックボックスをオンにします。必要な数だけチェックを入れるか、ヘッダーのチェックボックスを使用して現在表示されているすべての連絡先を選択できます。ページ全体にチェックを入れると、**テーブル行のすぐ上に青い帯が表示され**、「**フィルターに一致するN件の連絡先をすべて選択**」というオプションが提供されます。これを1回クリックすると、表示されているページだけでなく、一致するすべての連絡先に選択範囲が拡大されるため、一度のアクションで数千件の連絡先を処理できます。この帯は「誰を」選択するかを決めるためのもので、実際に何かを「実行する」ボタンは下の操作バーにあります。
2. **画面下部にフローティング操作バーが表示され**、以下の操作が可能です。
   - **Botをオン / Botをオフ** — 選択したすべての連絡先に対してAIボットを切り替えます。
   - **非公開 / 公開にする** — プライバシー設定を切り替えます。
   - **DND / DNDを無効化** — おやすみモード（DND）を切り替えます。
   - **スパムとしてマーク / スパムから除外**。
   - **アーカイブ / アーカイブ解除** — 選択したすべての連絡先のチャットを閉じてチャットアーカイブに移動するか、すべて元に戻します。これは「チャット」ページと同じアーカイブです。[会話を閉じる](../chats/chat-interface.md#closing-a-conversation-when-youre-done)を参照してください。
   - **キャンペーンを割り当て** — 選択した連絡先をキャンペーンに振り分けます。**クラシックキャンペーンアカウントのみ** — 以下の注記を参照してください。
   - **リストに追加**。
   - **タグ付け** — 選択したすべての連絡先にタグを適用します。
   - **自動タグ付け** — 各連絡先のAIエージェントに会話全体を読み取らせて独自のタグ付けルールを適用させるか、選択した全員に対して1つのエージェントのルールを選択します。ライブタグ付けと同じ料金（タグ1件につき1クレジット）がかかります。新しいタグが適用されなかった連絡先には料金は発生しません。1回につき最大500件の連絡先まで処理可能です。[オンデマンドで会話にタグを付ける](../get-started/creating-tags.md#tagging-a-conversation-on-demand)を参照してください。
   - **自動化** — 選択した連絡先を自動化に追加します。アカウントで自動化機能が有効な場合にのみ表示されます。
   - **エクスポート** — 選択した連絡先をファイルとしてダウンロードします。
   - **削除** — 選択したすべての連絡先を完全に削除します。
3. 実行したいアクションをクリックします。削除やスパムとしてマークといった破壊的なアクションの場合は、最初に確認を求められます。

> **「Assign campaign」ボタンが表示されませんか？AIエージェントアカウントでは正常な動作です。** メニューに **AI Agents** が表示され、**Campaigns** エントリがない場合、連絡先をキャンペーンに割り当てる機能は適用されません。代わりに連絡先を **リスト** に追加し、[Broadcast](../broadcasts/broadcasts.md) を使用してそのリストに送信するか、[Entry Point](../ai-agents/entry-points.md) を使用して新しい会話を適切なエージェントに振り分けてください。従来の方法から新しい方法への完全なマッピングについては、[Moving from Campaigns to Broadcasts & Agents](../moving-from-campaigns.md) を参照してください。

バーの端にある小さな**「×」**をクリックするか、チェックボックスをオフにすると、選択が解除されます。

> **「チャット」ページとは異なります。** **連絡先**ページでは、一括操作バーは画面下部にフローティング表示されます。**チャット**ページでは、同様のバーがチャットリストの*上部*、リスト列内に配置され、独自のマスターチェックボックスを備えています。[受信トレイの一括操作](../chats/chat-interface.md#bulk-inbox-actions)を参照してください。どちらのページも、表示されているページがすべてチェックされると、行の上に「N件すべてを選択」という同様の帯が表示されます。

> **ヒント: 連絡先を均等なバッチに分割する。** 「50件ずつのリストに分割」する自動ボタンはありませんが、テーブル機能を使えばすぐに実行できます。テーブルには正確に**1ページあたり50件の連絡先**が表示され、ヘッダーのチェックボックスでページ内の全件を選択できるからです。ヘッダーのチェックボックスにチェックを入れ、**リストに追加**をクリックし、ポップアップ内の **+ 新規リスト** を押して名前（例: 「バッチ1」）を付けます。リストを作成した瞬間に、選択した連絡先が自動的にそのリストに追加されます。次に、次のページに移動して同じ操作を繰り返します。数百件の連絡先であっても、数分で50件ずつの均等なリストに分割できます。一人ずつ追加する必要はありません。もしバッチ処理が必要な目的が（整理ではなく）*送信*のみであれば、リストを作成する必要さえありません。[ブロードキャスト](../broadcasts/broadcasts.md)の **Dripモード** を使用すれば、1つの大きなリストから自動的にバッチ処理で送信が行われます。

---

## 次のステップ

- [新しい連絡先の追加](creating-contacts.md) — 連絡先を1件ずつ追加する方法と、連絡先画面の全体的なツアーです。
- [ファイルから連絡先をインポートする](importing-contacts.md) — 連絡先のスプレッドシートをアップロードします。
- [連絡先をエクスポートする](exporting-contacts.md) — 連絡先をファイルとしてダウンロードします。