文件

聯絡人

儲存並管理與你的代理程式聊天過的已識別人員。聯絡人可透過身分驗證自動建立，也能以手動方式或透過 CSV 匯入新增。

Reserved integration fields remain read-only: instagram_username, stripe_customer_id, and source.

聯絡人是曾與你的代理程式聊天過的已識別人員，有別於匿名訪客。每個聯絡人都以來自你自己系統的不可變外部 ID 作為索引鍵，因此同一個人無論跨越多少個工作階段或裝置，都會對應到同一個聯絡人。

你可以在代理程式的「聯絡人」分頁中找到你的聯絡人。

聯絡人儲存的內容

欄位說明
外部 ID來自你系統的不可變 ID（JWT 的 sub）。每個代理程式皆為唯一值。
電子郵件聯絡人的電子郵件地址。
姓名聯絡人的顯示名稱。
電話聯絡人的電話號碼。
自訂屬性你附加的任何額外資料（方案、公司、Stripe ID 等）。
上次出現每次聯絡人聊天時都會自動更新。

聯絡人資料會儲存供你查看與區隔。基於隱私考量，這些資料絕不會被注入代理程式的回答中——請參閱身分驗證 → 隱私。

聯絡人的建立方式

自動透過身分驗證建立（建議）

啟用身分驗證後，你的後端會為每位已登入的使用者簽署一個 JWT。已驗證的使用者第一次聊天時，Agentkit 會根據該 token 中的聲明建立一個聯絡人，並將對話連結到這個聯絡人。之後的聊天會更新同一個聯絡人，並重新整理「上次出現」時間。不需要另外呼叫 API。

手動新增

按一下「新增聯絡人」，然後輸入外部 ID（必填），以及選填的姓名、電子郵件與電話。外部 ID 在同一個代理程式中必須是唯一值。

透過 CSV 匯入

使用「匯入」功能，可從試算表批次建立或更新聯絡人——詳見下方說明。

透過 CSV 匯入聯絡人

按一下「匯入」，然後上傳 .csv 檔案。第一列必須是標題列。支援的欄位如下：

欄位必填備註
external_id是每位聯絡人的唯一 ID。缺少此欄位的資料列會被略過。
name否最多 255 個字元。
email否最多 320 個字元。
phone否最多 50 個字元。
external_id,name,email,phone
import-001,Alice Imported,[email protected],+1 555 000 0001
import-002,Bob Imported,[email protected],+1 555 000 0002

使用匯入對話方塊中的「下載範本」連結，取得起始檔案。

限制與行為：

  • 檔案大小上限為 5 MB；每次匯入最多 10,000 列資料。
  • 若 external_id 已存在，該資料列會更新對應的聯絡人，而不是建立重複的項目。
  • 匯入完成後，你會看到已處理與已略過的聯絡人數量。

尋找聯絡人

聯絡人表格支援：

  • 搜尋外部 ID、電子郵件、姓名與電話。
  • 針對大型聯絡人清單提供分頁功能。
  • 可透過「欄位」切換開關來顯示或隱藏欄位。

後續步驟