# カスタムフィールド、リードプロフィール、メモ すべての連絡先には、名前、電話番号、メールアドレス、チャネルといった基本情報があります。しかし、やり取りをする相手については、勤務先、誕生日、前回の購入内容、どのカンファレンス経由で知り合ったかなど、通常はそれ以上の情報を把握しているはずです。このページでは、連絡先に付加できる追加情報と、それぞれの情報の保存場所について説明します。 --- ## 概要 | 項目 | 最適な用途 | 保存場所 | |---|---|---| | **カスタムフィールド** | 短い構造化データ（会社名、役職、誕生日、プランなど） | 連絡先に紐づくキーと値のペアのリスト | | **メモ（リードプロフィール）** | その人物がどのような人物で、なぜ重要なのかを記述する自由形式のテキスト。AIが返信をパーソナライズする際に読み取ります | 連絡先にある単一のテキストエリア | | **ステータス** | 連絡先がジャーニーのどの段階にいるかを追跡します（スパムのマーク付けなどを含む） | 連絡先にある単一の値 | > **以前からアプリをご利用の場合:** 以前は「リードプロファイル」と「日付付きメモのスタックリスト」という2つの別々の機能でしたが、現在は連絡先の詳細レコードにある「**メモ**」という**1つのフィールド**に統合されました。タイトル付きのタイムスタンプ付きメモログは廃止され、連絡先に関するすべての記述はこの1つのボックスに集約されます。実際にどのような運用になるかについては、以下の[メモ](#notes-lead-profile)を参照してください。 --- ## カスタムフィールドの定義 カスタムフィールドは、すべての連絡先で再利用可能です。`company`のようなフィールドを作成すると、それはアカウントのスキーマの一部となり、他の連絡先を編集するたびに候補として表示されるようになります。 **フィールドタイプ:** カスタムフィールドは自由入力テキストのみです。ドロップダウン、ラジオボタン、複数選択タイプはありません。特定のいくつかの値（リードソースの「ニュースレター」、「紹介」、「広告」など）のみを保持させたい場合は、常に同じ値を入力するか、スプレッドシートのエクスポート/インポートを使用して一括入力し、すべての連絡先で希望する表記が統一されるようにしてください。 **命名規則:** - フィールド名は小文字の英字、数字、アンダースコアのみを使用し、英字またはアンダースコアで始める必要があります（例: `lead_source`。 `Lead Source`は不可）。 - **アクセント記号のない英字のみ** — スペース、大文字、アクセント記号付き文字、非ラテン文字は拒否されます。アカウントの他の部分が他の言語であっても、フィールド名は `cumpleaños` ではなく `cumpleanos` や `birthday` にしてください。制限されるのは名前のみで、保存する値はどの言語でも構いません。 - 1つのアカウントにつき最大 **50個のカスタムフィールド** を作成できます。 - 名前は慎重に選んでください。テンプレートやキャンペーンで使用されたフィールドは、その参照を先に削除しない限り削除できません。 --- ## 連絡先でのカスタムフィールドの入力 1. 左側のサイドバーで **Contacts** をクリックします。 2. 連絡先の行をクリックして [クイックビューパネル](creating-contacts.md) を開き、**Edit** をクリックします。または、**New contact** をクリックして新規作成を開始します。 3. 連絡先フォームで **Custom Fields** セクションを探します。 4. **Add a field** に名前を入力します（既存のフィールド名が候補として表示されるので、再利用する場合はクリックします）。**Add** をクリックし、値を入力します。 5. フォームの **Save** をクリックして保存します。 すでに値が入力されているフィールドは、クイックビューパネルおよび連絡先の詳細レコードに読み取り専用の行として表示されます。値を変更するには、再度 **編集** を開いてください。 **フィールドの削除** を編集フォームから行うと、その連絡先からその値が削除されます。テンプレートやキャンペーンで参照されている間は、すべての連絡先およびアカウントのスキーマからフィールドを完全に削除することはできません。 --- ## AIにカスタムフィールドへの入力を任せる AIエージェントは、誕生日、パートナーの名前、食事制限、テーブルの希望など、会話の中で出てきた情報をカスタムフィールドに直接保存できるため、後でブロードキャストやフォローアップに活用できます。この機能はデフォルトではオフになっており、明示的に選択したフィールドにのみ書き込みを行います。 以下の2つの設定が必要であり、**両方**が揃っている必要があります。何も保存されないという問題の最も一般的な原因はこれです。 **1. まずフィールドを作成する。** AIはアカウントに既に存在するフィールドにしか書き込めません。通常の方法（上記の [連絡先のカスタムフィールドへの入力](#filling-in-custom-fields-on-a-contact) を参照）でフィールドを追加してください。例: `customer_birthday`、`partner_name`、`dietary_notes`。命名規則（小文字の英字、数字、アンダースコアのみ）を忘れないでください。 **2. エージェントに権限を与え、フィールドを選択する。** 1. サイドバーの **AI Agents** をクリックし、エージェントを開きます。 2. **AI abilities** タブに移動します。 3. **Contact updates** の下にある **Allow AI to collect extra info** をオンにします。 4. **Collect extra info during booking** というタイトルのカードが表示され、カスタムフィールドが一覧表示されます。AIに入力させたい**各**フィールドの横にあるトグルをオンにします。フィールドを作成するだけでは不十分であり、オフのままのフィールドは無視されます。（カードにカスタムフィールドがまだないと表示される場合は、戻って先に作成してください。） 5. **Save** をクリックし、エージェントを **Publish** します。変更は公開するまでドラフト状態であるため、未公開の変更はライブの会話には影響しません。公開すると、今回の変更だけでなく、保留中の**すべての**ドラフト変更がライブに反映されるため、編集を行っていた場合は他のタブも先に確認してください。 **知っておくべきこと:** - **予約時だけでなく、会話全体で機能します。** カードの文言にかかわらず（この機能は予約から始まりましたが）、AIは予約の有無にかかわらず、連絡先が言及した瞬間に値を保存します。予約機能をオンにする必要はありません。 - **各フィールドを必須に設定できます。** 必須とは「AIが予約を確定する前に収集しなければならない」という意味であり、通常の会話をブロックしたり、予約を受け付けないエージェントで動作したりすることはありません。 - **AIが「メモした」と言っても、保存されたとは限りません。** フィールドが作成され、オンになっていない場合、AIは丁寧に応答してメモしたように振る舞うことがありますが、連絡先には何も保存されません。連絡先レコードを確認して、値が実際に保存されたか確認してください。 - **AIに質問するタイミングを指示します。** エージェントの指示の中で、各フィールドが適用されるタイミングを記述します（「ゲストがアレルギーや食事制限について言及した場合は、`dietary_notes` に保存してください」）。AIはこれを自然言語として読み取るため、全員に対して同じリストで質問攻めにすることはありません。 - **過去のデータは遡って入力されません。** 公開した瞬間からの会話のみがキャプチャされます。過去のチャットですでに言及された詳細は遡って入力されません。 - **連絡先を所有するアカウントで設定してください。** カスタムフィールドは単一のアカウントに属するため、代理店設定の場合は、親アカウントではなく、会話を行っているサブアカウント内で作成してください。 - **自由形式のメモもフィールドに属します。** 会話型AIは連絡先の **Lead profile / Notes** ボックス（下記参照）には書き込めません。これはあなたとチームのための場所ですが、[オートメーション](../automations/automations.md) やAPIからは書き込み可能です。AI自身に「セリアック病向けの料理を希望」といった内容を記録させたい場合は、`dietary_notes` のようなカスタムフィールドを作成してください。 --- ## AIが会話中に読み取れる情報 AIが**チャット中に情報を活用**できるようにするために、どこに情報を保存すべきか判断する際、以下の違いが重要になります。 - **カスタムフィールド：AIは返信のたびに読み取ります。** コンタクトのすべてのカスタムフィールド値は、その値がどのように入力されたか（あなたによる入力、以前のAIによる入力、インポート、またはAPI経由など）に関わらず、会話中いつでもAIが利用可能です。そのため、エージェントの指示に「リピーターには`preferred_barber`で挨拶する」といったルールを含めると、AIはその瞬間に値を確認できるため機能します。 - **タグ：AIはチャット中にタグを確認できません。** タグ付けはAIの返信が送信された後の別のステップとして実行されます。AIはあなたの説明に基づいてタグを適用しますが、会話中にコンタクトがすでにどのタグを持っているかはAIには表示されません。「コンタクトがVIPタグを持っている場合は割引を提案する」といった指示は**機能しません**。 判断の目安：AIが会話の途中で読み取って活用すべき情報はすべて**カスタムフィールド**に入れてください。**タグ**は、会話の前後で発生する処理（コンタクトのフィルタリングやセグメント化、ブロードキャストのターゲット設定、AIがタグを適用した瞬間に他のシステムへ[タグWebhook](../integrations/webhooks.md)を送信するなど）のためのものです。 --- ## カスタムフィールドの一括読み込み インポートウィザードの列マッピングは、**名、姓、電話番号、メールアドレス、タグ、およびメモ**のみを認識します。「このスプレッドシートの列をカスタムフィールドにマッピングする」というステップはありません（対照的に、タグは実際のタグとしてインポートされます）。現在、カスタムフィールドの値を一括で読み込むにはAPIを使用してください。どのルートを選択するかは、連絡先が既に存在するかどうかによって異なります。 **新規の連絡先を追加する場合：** APIの一括連絡先インポートエンドポイントは、同じ呼び出し内でカスタムフィールドの値を直接受け取ることができるため、2回目の処理は不要です。名前、電話番号、メールアドレスと並べて、各レコードに `custom_fields` オブジェクトを含めると、カスタムフィールドが入力された状態で連絡先が登録されます。リクエスト形式については、APIリファレンスの「Contacts」セクションに記載されています。 **既存の連絡先に値を入力する場合：** 1. APIを通じて連絡先をリスト化し、各連絡先のIDを取得します。CSVエクスポートには、連絡先ID列やカスタムフィールド列は含まれません。キーの取得方法とエンドポイントの呼び出し方法については、[API Access](../integrations/api-access.md) を参照してください。 2. スプレッドシートに値を入力します。 3. インポートウィザード自体にはまだカスタムフィールドの列マッピング機能がないため、APIの連絡先更新エンドポイント（[API Access](../integrations/api-access.md) を参照）を使用して、連絡先ごとに値を書き戻します。各更新は送信したキーのみに影響し、省略したカスタムフィールドは現在の値が保持されます。 --- ## メモ（リードプロフィール） 連絡先の **フルレコード**（クイックビューパネルから **Open full record** をクリック）にある **Notes** パネルは、単一の自由記述ボックスです。これは他の場所で「リードプロファイル」とも呼ばれる同じフィールドです。連絡先の **Edit** フォームでは、同じボックスが **Lead profile** とラベル付けされており、「この連絡先に関する内部メモ」と説明されています。別のフィールドを探す必要はありません。ビジネスタイプ、課題、会社規模、最近の活動など、アウトリーチをパーソナライズするのに役立つ会話に関連する内容を何でも書き込んでください。 **AIによる使用方法:** メッセージテンプレート（一斉送信メッセージ、フォローアップ、AIエージェントの指示など）に `{{personal_context|write a one-line opener that references their business}}` のようなプレースホルダーを含めることができます。そのテンプレートが特定の連絡先に送信されると、AIはその連絡先のメモを読み取り、そこに書かれている内容を使用してパーソナライズされた文章を作成します。連絡先にメモがない場合、プレースホルダーはメッセージから単純に削除されます。 AIはこれをあなたのために書き込みません。あなたやチームが入力してください。営業担当者が電話をかける前に読んでおくべき「カンニングペーパー」だと考えてください。AI自身に会話で学んだことを記録させたい場合は、代わりにカスタムフィールドを使用してください。[AIにカスタムフィールドへの入力を任せる](#letting-the-ai-fill-custom-fields-for-you) を参照してください。 編集は簡単です。ボックスに入力し、**Save note**（保存）をクリックします（変更を破棄する場合は **Discard** をクリックします）。エントリごとに個別のタイトルや日付はありません。連絡先ごとに1つの連続したテキストブロックとなっているため、日付付きのログが必要な場合は、各追加内容の先頭に自分で日付を入力してください。 --- ## ステータス 各連絡先には、現在の状況を示す **Status**（ステータス）バッジが表示されます。 | ステータス | 意味 | |---|---| | **New** | 新規。まだやり取りが始まっていません。 | | **Engaged** | エンゲージ済み。積極的に会話中です。 | | **Lead** | リード。購入の関心を示しています。 | | **Customer** | 顧客。コンバージョン済みです。 | | **Churned** | 解約済み。以前は顧客でしたが、現在はアクティブではありません。 | | **Spam** | スパム。メインリストから非表示になります。AIボットは対応せず、おやすみモードがオンになり、キャンペーンの対象外となります。 | 連絡先テーブルの **Status** バッジを直接クリックすると、インラインで変更できます。ただし、「Spam」は例外です。これには追加の副作用があるため、一括操作の **Mark as spam**（スパムとしてマーク）およびその確認画面から設定する必要があります。スパムの解除も同様に **Unmark as spam**（スパム解除）から行えます。 --- ## 連絡先をチームメンバーに割り当てる 担当者の割り当て（他のメンバーが誤って返信しないように、特定のメンバーに連絡先を割り当てること）は、連絡先ページではなく**チャット**画面から設定します。会話を開き、そこにある担当者割り当てコントロールを使用してください。詳細な手順については[チャットインターフェース](../chats/chat-interface.md)を参照してください。割り当てを変更できるのは、アカウント所有者と適切な権限を持つユーザーのみです。 --- ## ブロードキャストとテンプレートでのカスタムフィールドの使用 カスタムフィールドは、送信メッセージ内で役立ちます。ブロードキャストメッセージ、WhatsAppテンプレート、AIエージェントの指示など、メッセージを作成できる場所であればどこでも、以下のようなプレースホルダーを挿入できます。 ``` Hey {{first_name}}, hope things are going well at {{company}}! ``` メッセージが送信される際、`{{first_name}}` と `{{company}}` は各連絡先の値に置き換えられます。連絡先にそのフィールドの値が入力されていない場合、プレースホルダーは空白のままになります。 ヒント: - **小文字とアンダースコア形式の名前を使用する** — プレースホルダーはフィールド名と完全に一致する必要があります（`{{company}}` であり、`{{Company}}` ではありません）。 - **組み込みフィールドも使用可能** — `{{first_name}}`、`{{last_name}}`、`{{email}}`、および `{{phone_number}}` は、カスタムフィールドとして設定しなくても使用できます。 - **メモと組み合わせる** — AIによるパーソナライズされた文章を作成するには、固定のカスタムフィールドの代わりに `{{personal_context|your instruction}}` を使用します。AIが連絡先の「メモ」に基づいて新しい文章を作成します。 - **使用中のフィールドは削除できない** — テンプレートで `{{company}}` を使用している場合、そのテンプレートから削除するまで、システムは `company` の削除をブロックします。 --- ## ヘルプが必要ですか？ 何をどこに配置すべきかの目安は以下の通りです。 - **フィルタリングやマージに使用する短い構造化された事実** → カスタムフィールド - **AIやチームが読むための文脈となる段落** → メモ - **誰が会話を担当しているか** → 担当者（Chatsから設定） 解決しない場合は、サポートまでお問い合わせください。設定のお手伝いをいたします。 --- ## 次のステップ - [新しい連絡先の追加](creating-contacts.md) — 連絡先を1件ずつ追加する方法と、連絡先画面の全体的なガイド。 - [ファイルからの連絡先のインポート](importing-contacts.md) — スプレッドシートを取り込む方法。 - [チャットインターフェース](../chats/chat-interface.md) — 連絡先の割り当てを行う場所。