カスタムフィールド、リードプロフィール、メモ #

すべての連絡先には、名前、電話番号、メールアドレス、チャネルといった基本情報があります。しかし、やり取りをする相手については、勤務先、誕生日、前回の購入内容、どのカンファレンス経由で知り合ったかなど、通常はそれ以上の情報を把握しているはずです。このページでは、連絡先に付加できる追加情報と、それぞれの情報の保存場所について説明します。

概要 #

以前からアプリをご利用の場合: 以前は「リードプロファイル」と「日付付きメモのスタックリスト」という2つの別々の機能でしたが、現在は連絡先の詳細レコードにある「メモ」という1つのフィールドに統合されました。タイトル付きのタイムスタンプ付きメモログは廃止され、連絡先に関するすべての記述はこの1つのボックスに集約されます。実際にどのような運用になるかについては、以下のメモを参照してください。

カスタムフィールドの定義 #

カスタムフィールドは、すべてのコンタクトで再利用可能です。companyのようなフィールドを作成すると、それはアカウントのスキーマの一部となり、すべてのコンタクトの編集フォームに表示されるようになります。

フィールドの型 #

すべてのカスタムフィールドには型があり、その型によってフィールドに保持できるデータや入力方法が決まります。入力方法は、アプリ上での直接入力、インポート、API経由、またはチャットで学習した内容をAIが保存する場合などがあります。

型指定されたフィールドは、書き込まれるすべての場所で検証されます。コンタクトフォームは February 1st を日付フィールドに保存しようとせず、APIはフィールド名と期待される形式を明示したエラーを返し、ファイルインポートはその行をスキップして結果画面にリストアップします。また、AIには事前に形式が伝えられ、万が一異なる形式が送信された場合は修正が返されます。人間が認識可能な形式で入力された値は自動的に変換されます。01/02/1990 はアカウントの日付形式（日・月・年の順、または月・日・年の順。設定 → アカウントで設定）に従って 1990-02-01 になり、yes はチェック済みのチェックボックスになり、newsletter はそのオプションの綴りが一致していれば Newsletter として保存されます。すべての日付が同じ方法で保存されるため、スマートリストや自動化条件で「1990-01-01以前の誕生日」と指定した場合、同じ日を指す3通りの表記ではなく、実際の日付として比較されます。

フィールドの作成と管理 #

1. 左側のサイドバーでコンタクトをクリックします。
2. いずれかのコンタクトを開き、編集をクリックします（または新規コンタクトをクリックします）。
3. カスタムフィールドセクションで、フィールドを追加に名前を入力し、型を選択して（ドロップダウンの場合はオプションを入力）、追加をクリックします。フィールドはアカウント全体に対して作成され、すぐにこのコンタクトに表示されます。
4. 後からフィールドの型やオプションを変更する場合は、名前を変更するのではなく、同じセクションにあるフィールドを管理をクリックしてください。管理画面にはすべてのフィールドとその型が一覧表示されます。新しい型を選択したり、ドロップダウンのオプションを編集したり、リストからフィールドを削除したりできます。

タイプを変更しても、既存の値はそのまま保持されます。 birthday に 1 Feb 1990 というフリーテキストが入力されていた状態でタイプを「日付」に変更した場合、その値は次に編集（ユーザー、API、またはAIによる編集）されるまでそのまま残ります。編集時には正しい日付形式である必要があります。システムが勝手に値を書き換えることはありません。古い値を一括で変換するには、以下の 既存の値を正規化 を使用してください。

既存の値を正規化 #

フィールドにタイプを設定した後も、古い値は保存時の表記のまま保持されます。例えば、ある連絡先では 01/02/1990、別の連絡先では 1 February 1990 といった表記が混在している場合、スマートリストや自動化の日付ルールは YYYY-MM-DD 形式で保存された日付のみを対象とします。既存の値を正規化 を実行すると、これらを一括で変換できます。

1. フィールドの管理 を開きます（上記参照）。すべての日付、数値、ドロップダウン、チェックボックスフィールドの下に 既存の値を正規化 リンクが表示されます。テキストフィールドには表示されません（テキストは入力された通りに保存されるため）。
2. リンクをクリックします。この時点では何も変更されません。アプリが連絡先を確認し、変更される値の数、例（"01/02/1990" becomes "1990-02-01" など）、および読み取れなかった値の一覧を表示します。
3. N個の値を変更 をクリックすると変換が実行されます。そのままにする場合は キャンセル をクリックしてください。

知っておくべきこと:

• フィールドのタイプとして読み取れる値のみが変更されます。スラッシュで区切られた日付は、アカウントの日付形式（設定 → アカウント で設定された「日/月」または「月/日」の順序）に従います。日付フィールド内の next spring のように読み取れない値は変更されず、リストに表示されるため、該当する連絡先で手動で修正できます。
• すでに正しい形式の値や空の値は変更されません。繰り返し実行しても問題ありません。
• フィールドのタイプを変更した直後の場合は、先に フィールドを保存 をクリックしてください。新しいタイプが保存された後にのみリンクが表示されます。
• 現在のアカウント内のすべての連絡先に適用されます。エージェンシー設定の場合は、連絡先を所有するサブアカウント内で実行してください。
• 同じアクションはAPIでも POST /users/me/custom-fields/{key}/normalize として利用可能で、dry_run を使用してプレビューできます。

リストからフィールドを削除すると、編集フォームやAIのフィールド選択肢から非表示になります。コンタクトに保存済みの値は保持され、同じ名前で再度追加すれば再び表示されます。コンタクトからフィールドの値を完全に消去したい場合は、APIのカスタムフィールドの削除呼び出しを使用してください。

命名規則:

• フィールド名は小文字、数字、アンダースコアのみを使用し、先頭は文字またはアンダースコアである必要があります（例: lead_source は可、Lead Source は不可）。
• アクセント記号のない英字のみ — スペース、大文字、アクセント記号付き文字、非ラテン文字は拒否されます。アカウントの他の部分が別の言語であっても、フィールド名は cumpleanos や birthday のように命名してください（cumpleaños は不可）。制限されるのは名前のみであり、保存する値（およびドロップダウンのオプション）はどの言語でも構いません。
• 1つのアカウントにつき最大 50個のカスタムフィールド を作成でき、ドロップダウンには最大 100個のオプション を設定できます。
• 名前は慎重に選んでください。テンプレートやAIエージェントで使用されているフィールドは、それらの参照を削除しない限り削除できません。

連絡先でのカスタムフィールドの入力 #

1. 左側のサイドバーで 連絡先 をクリックします。
2. 連絡先の行をクリックして クイックビューパネル を開き、編集 をクリックします。または、新規連絡先 をクリックして新しく作成します。
3. 連絡先フォームで カスタムフィールド セクションを探します。アカウント内のすべてのフィールドが、そのタイプに応じたコントロール（テキストボックス、数値ボックス、日付ピッカー、ドロップダウン、またはチェックボックス用の「はい/いいえ」ドロップダウン）とともに表示されます。
4. 値を入力し、フォームの 保存 をクリックして保存します。フィールドのタイプに適合しない値は即座にフラグが立てられ、修正されるまでフォームは保存されません。

すでに値が入力されているフィールドは、クイックビューパネルおよび連絡先の詳細レコードに読み取り専用の行として表示されます。値を変更するには、再度 編集 を開いてください。

値をクリアする: フィールドに値が入力されると、編集フォームのボックス内に小さな × が表示されます。これをクリックすると、その連絡先の値のみがクリアされます。フィールド自体はアカウントや他のすべての連絡先から削除されるわけではありません。テンプレートやAIエージェントから参照されている間は、すべての連絡先およびアカウントのスキーマからフィールドを完全に削除することはできません。

AIにカスタムフィールドへの入力を任せる #

AIエージェントは、誕生日、パートナーの名前、食事制限、テーブルの希望など、会話の中で出てきた情報をカスタムフィールドに直接保存できるため、後でブロードキャストやフォローアップに活用できます。この機能はデフォルトではオフになっており、明示的に選択したフィールドにのみ書き込みを行います。

以下の2つの設定が必要であり、両方が揃っている必要があります。何も保存されないという問題の最も一般的な原因はこれです。

1. 最初にフィールドを作成します。 AIは、アカウントに既に存在するフィールドにのみ書き込むことができます。連絡先の編集フォーム（上記の連絡先のカスタムフィールドへの入力を参照）から追加するか、以下のステップ4でエージェントから直接追加してください。これは、まだ連絡先がない新しいアカウントで素早く行う方法です（例: customer_birthday、partner_name、dietary_notes）。命名規則を忘れないでください：小文字、数字、アンダースコアのみを使用します。

2. エージェントに権限を与え、フィールドを選択する。

1. サイドバーの AIエージェント をクリックし、エージェントを開きます。
2. AI機能 タブに移動します。
3. 連絡先の更新 の下にある AIによる追加情報の収集を許可する をオンにします。
4. 予約中に情報を収集する というタイトルのカードが表示され、カスタムフィールドが一覧表示されます。AIに入力を許可する各フィールドの横にあるトグルをオンにします。フィールドを作成するだけでは不十分であり、オフのままのフィールドは無視されます。リストにないフィールドが必要な場合、または全くフィールドがない場合はどうすればよいでしょうか？同じカードにある カスタムフィールドの管理 をクリックし、フィールドとそのタイプを追加して保存します。すると、そのフィールドがすぐにリストに表示され（オフの状態）、その時点からすべての連絡先で利用可能になります。
5. 保存 をクリックし、エージェントを 公開 します。変更内容は公開するまでドラフト状態のままとなるため、未公開の変更がライブの会話に影響を与えることはありません。公開すると、今回の変更だけでなく、保留中のすべてのドラフト変更がライブに反映されるため、他のタブも編集している場合は先に確認してください。

知っておくべきこと:

• AIには各フィールドの型が伝えられます。 日付フィールドの場合、コンタクトが言った内容（「1990年2月1日」など）を1990-02-01に変換してから保存します。ドロップダウンの場合は定義されたオプションからのみ選択し、チェックボックスの場合は「はい」か「いいえ」を保存します。それでも適合しない値が送信された場合は、期待される形式とともに保存が拒否され、AIは再度質問するか自己修正を行います。解析不能な値がコンタクトに保存されることはありません。
• 予約時だけでなく、会話全体で機能します。 カードの文言にかかわらず（この機能は予約から始まったため）、AIはコンタクトが言及した瞬間に値を保存します。予約が関与しているかどうかは問いません。予約機能がオンになっている必要もありません。
• 各フィールドは必須に設定できます。 「必須」とは「AIが予約を確定する前に収集しなければならない」という意味であり、通常の会話を妨げることはありません。また、予約を受け付けないエージェントでは何も機能しません。
• AIが「メモした」と言っても、保存されたとは限りません。 フィールドが作成され、有効になっていない場合、AIは丁寧に「承知しました」と返答することはできますが、コンタクトには何も保存されません。値が実際に保存されたかどうかは、コンタクトレコードを確認してください。
• AIに質問のタイミングを指示します。 エージェントの指示で、各フィールドが適用されるタイミングを記述してください（「ゲストがアレルギーや食事制限について言及した場合は、dietary_notesに保存してください」）。AIはこれを平易な言葉として読み取るため、全員に対して同じリストで尋問することはありません。
• 過去のデータは遡って入力されません。 公開した瞬間からの会話のみがキャプチャされます。過去のチャットですでに言及された詳細は遡って入力されません。
• コンタクトを所有するアカウントで設定してください。 カスタムフィールドは単一のアカウントに属します。エージェンシー設定の場合は、親アカウントではなく、エージェントが会話を行っているサブアカウント内で作成してください。
• 自由形式のメモもフィールドに含めることができます。 会話型AIはコンタクトの「リードプロフィール/メモ」ボックス（下記参照）に書き込むことはできません。これはあなたとチームのための場所ですが、自動化やAPIからは書き込み可能です。AI自身に「セリアック病向けの料理を希望」といった内容を記録させたい場合は、dietary_notesのようなカスタムフィールドを作成してください。

AIが会話中に読み取れる情報 #

AIがチャット中に情報を活用できるようにするために、どこに情報を保存すべきか判断する際、以下の違いが重要になります。

• カスタムフィールド：AIは返信のたびに読み取ります。 コンタクトのすべてのカスタムフィールド値は、その値がどのように入力されたか（あなたによる入力、以前のAIによる入力、インポート、またはAPI経由など）に関わらず、会話中いつでもAIが利用可能です。そのため、エージェントの指示に「リピーターにはpreferred_barberで挨拶する」といったルールを含めると、AIはその瞬間に値を確認できるため機能します。
• タグ：AIはチャット中にタグを確認できません。 タグ付けはAIの返信が送信された後の別のステップとして実行されます。AIはあなたの説明に基づいてタグを適用しますが、会話中にコンタクトがすでにどのタグを持っているかはAIには表示されません。「コンタクトがVIPタグを持っている場合は割引を提案する」といった指示は機能しません。

判断の目安：AIが会話の途中で読み取って活用すべき情報はすべてカスタムフィールドに入れてください。タグは、会話の前後で発生する処理（コンタクトのフィルタリングやセグメント化、ブロードキャストのターゲット設定、AIがタグを適用した瞬間に他のシステムへタグWebhookを送信するなど）のためのものです。

カスタムフィールドの一括読み込み #

インポートウィザードは、スプレッドシートの列をカスタムフィールドに直接マッピングします。フィールド名と一致するヘッダーを持つ列（大文字・小文字やアクセント記号は区別されません）は自動的に照合されます。その他の列は手動でフィールドを指定でき、インポート中に新しいカスタムフィールドを作成して列からフィールドを生成することも可能です。

新規コンタクトを追加する場合：ファイル内のカスタムフィールドごとに1列ずつ配置してインポートしてください。新しいコンタクトは、それらのフィールドが入力された状態で登録されます。

既存の連絡先に値を入力する場合：

1. コンタクトをエクスポートします。コンタクトのCSVエクスポートには、カスタムフィールドごとに1列が含まれています。
2. スプレッドシートに値を入力します。電話番号の列は、コンタクトの照合に使用されるため、そのままにしておいてください。
3. 確認ステップで 既存のコンタクトを更新 をオンにしてファイルをインポートします。各行はファイル内に値があるカスタムフィールドのみを更新します。空のセルは現在の値をそのまま保持します。

APIのバルクコンタクトインポートエンドポイントは、各レコードに対して custom_fields オブジェクトと同じ値を受け取ります。独自のツールから実行したい場合は、APIアクセスを参照してください。

メモ（リードプロフィール） #

連絡先の フルレコード（クイックビューパネルから Open full record をクリック）にある Notes パネルは、単一の自由記述ボックスです。これは他の場所で「リードプロファイル」とも呼ばれる同じフィールドです。連絡先の Edit フォームでは、同じボックスが Lead profile とラベル付けされており、「この連絡先に関する内部メモ」と説明されています。別のフィールドを探す必要はありません。ビジネスタイプ、課題、会社規模、最近の活動など、アウトリーチをパーソナライズするのに役立つ会話に関連する内容を何でも書き込んでください。

AIによる使用方法: メッセージテンプレート（一斉送信メッセージ、フォローアップ、AIエージェントの指示など）に {{personal_context|write a one-line opener that references their business}} のようなプレースホルダーを含めることができます。そのテンプレートが特定の連絡先に送信されると、AIはその連絡先のメモを読み取り、そこに書かれている内容を使用してパーソナライズされた文章を作成します。連絡先にメモがない場合、プレースホルダーはメッセージから単純に削除されます。

AIはこれをあなたのために書き込みません。あなたやチームが入力してください。営業担当者が電話をかける前に読んでおくべき「カンニングペーパー」だと考えてください。AI自身に会話で学んだことを記録させたい場合は、代わりにカスタムフィールドを使用してください。AIにカスタムフィールドへの入力を任せる を参照してください。

編集は簡単です。ボックスに入力し、Save note（保存）をクリックします（変更を破棄する場合は Discard をクリックします）。エントリごとに個別のタイトルや日付はありません。連絡先ごとに1つの連続したテキストブロックとなっているため、日付付きのログが必要な場合は、各追加内容の先頭に自分で日付を入力してください。

Chatsの連絡先サイドパネルには、ノートの隣にリサーチセクションがあります。最初の返信の前に新しい連絡先をリサーチするがオンになっているときにエージェントが自動的に作成する概要と、手動で実行または更新するための今すぐリサーチボタンが表示されます。

ステータス #

各連絡先には、現在の状況を示す Status（ステータス）バッジが表示されます。

連絡先テーブルの Status バッジを直接クリックすると、インラインで変更できます。ただし、「Spam」は例外です。これには追加の副作用があるため、一括操作の Mark as spam（スパムとしてマーク）およびその確認画面から設定する必要があります。スパムの解除も同様に Unmark as spam（スパム解除）から行えます。

連絡先をチームメンバーに割り当てる #

担当者の割り当て（他のメンバーが誤って返信しないように、特定のメンバーに連絡先を割り当てること）は、連絡先ページではなくチャット画面から設定します。会話を開き、そこにある担当者割り当てコントロールを使用してください。詳細な手順についてはチャットインターフェースを参照してください。割り当てを変更できるのは、アカウント所有者と適切な権限を持つユーザーのみです。

ブロードキャストとテンプレートでのカスタムフィールドの使用 #

カスタムフィールドは、送信メッセージ内で役立ちます。ブロードキャストメッセージ、WhatsAppテンプレート、AIエージェントの指示など、メッセージを作成できる場所であればどこでも、以下のようなプレースホルダーを挿入できます。

Hey {{first_name}}, hope things are going well at {{company}}!

メッセージが送信される際、{{first_name}} と {{company}} は各連絡先の値に置き換えられます。連絡先にそのフィールドの値が入力されていない場合、プレースホルダーは空白のままになります。

ヒント:

• 小文字のアンダースコア形式の名前を使用してください — プレースホルダーはフィールド名と完全に一致する必要があります（{{company}}であり、{{Company}}ではありません）。
• 型指定されたフィールドは、あなたが書く形式で表示されます — 日付フィールドはアカウントの日付形式（設定 → アカウントに従い、01/02/1990または02/01/1990）で表示され、チェックボックスはYesまたはNoとして、ドロップダウンはオプションの正確な文言として表示されます。
• 組み込みフィールドも機能します — {{first_name}}、{{last_name}}、{{email}}、{{phone_number}}はカスタムフィールドとして設定しなくても機能します。
• メモと組み合わせる — AIによるパーソナライズされた行には、固定のカスタムフィールドの代わりに{{personal_context|your instruction}}を使用してください。AIはコンタクトのメモに基づいて新しい内容を作成します。
• 使用中のフィールドは削除できません — テンプレートで{{company}}が使用されている場合、そのテンプレートから削除するまでcompanyの削除はブロックされます。

ヘルプが必要ですか？ #

何をどこに配置すべきかの目安は以下の通りです。

• フィルタリングやマージに使用する短い構造化された事実 → カスタムフィールド
• AIやチームが読むための文脈となる段落 → メモ
• 誰が会話を担当しているか → 担当者（Chatsから設定）

解決しない場合は、サポートまでお問い合わせください。設定のお手伝いをいたします。

次のステップ #

• 新しい連絡先の追加 — 連絡先を1件ずつ追加する方法と、連絡先画面の全体的なガイド。
• ファイルからの連絡先のインポート — スプレッドシートを取り込む方法。
• チャットインターフェース — 連絡先の割り当てを行う場所。