摘要
本指南說明如何在 Astra 中設定 HubSpot 建立或更新聯絡人 動作。設定完成後，此動作會根據客戶對話自動在 HubSpot 中建立或更新聯絡人記錄，協助您保持 CRM 資料的準確性和最新狀態。
動作如何運作
當此動作執行時：
Astra 會使用客戶的電子郵件在 HubSpot 中尋找 聯絡人
如果聯絡人存在，它會根據您的設定更新記錄
如果聯絡人不存在，它可能會建立一個新的聯絡人（視您的設定而定）
這可確保您的聯絡人資料無需手動操作即可保持同步。
說明
請依照以下步驟設定動作：
步驟 1：開啟 HubSpot 建立或更新聯絡人範本
登入您的 Astra 帳戶
前往 動作庫
選擇 HubSpot — 建立或更新聯絡人
開啟 設定 步驟
步驟 2：設定動作意圖
您的操作
輸入一個清晰的 動作名稱 和 意圖
隨時按一下 編輯動作意圖 進行更新
運作方式
明確定義的意圖有助於代理判斷何時觸發此動作
離線同步
將此設定為 關閉 以在對話期間執行動作
將其設定為 開啟 以在對話結束後執行動作
步驟 3：選擇您的 HubSpot 帳戶
您的操作
選擇一個現有的 HubSpot 帳戶
或按一下 新增帳戶 以連線一個新的帳戶
運作方式
此動作建立或更新的所有資料將保存在選取的帳戶中
步驟 4：設定聯絡人建立和更新
允許建立和更新新的聯絡人
開啟時：
如果沒有找到符合電子郵件的聯絡人，則會建立一個新的聯絡人
完全更新透過 Astra 建立的聯絡人
關閉時：
不建立新的聯絡人
允許更新現有欄位
開啟時：
更新 HubSpot 中現有的聯絡人欄位（即使不是透過 Astra 建立的）
關閉時：
不更新現有的聯絡人屬性
僅將摘要更新作為備註（如果已設定）
步驟 5：對應欄位（HubSpot → Astra）
欄位對應定義了資料如何從 Astra 流入 HubSpot。
您的操作
對於每一列：
選擇一個 HubSpot 聯絡人屬性（左側）
將其對應至 Astra 欄位（右側）
運作方式
當動作執行時，Astra 會將對應的資料寫入相應的 HubSpot 聯絡人屬性
必填欄位
您必須對應以下欄位：
email
缺少此欄位，動作將無法執行。
新增更多欄位
按一下 對應欄位 以新增其他對應
您可以對應：
標準屬性（電子郵件、電話、姓名等）
您的 HubSpot 帳戶中的自訂屬性
注意： 只有支援的欄位和可編輯的自訂屬性（文字類型）才可供對應。
建立新的 Astra 欄位
您可以在對應時建立新的 Astra 欄位。
這些欄位將：
可在代理設定中使用
顯示為聯絡人屬性以供選擇
使用摘要欄位
如果提供了摘要：
Astra 會在聯絡人上建立或更新一個 備註，包含對話摘要
如果您也將 HubSpot 屬性對應至 摘要：
相同的摘要將寫入該聯絡人屬性
備註仍會建立並連結到聯絡人
動作執行時會發生什麼事
以下是端對端行為：
Astra 會使用對應的電子郵件查找 聯絡人
如果找不到聯絡人：
僅在您的設定允許時，才會建立新的聯絡人
如果聯絡人存在：
聯絡人將根據您的設定進行更新
如果完整更新受限：
可能只會新增或更新摘要備註
額外功能：離線同步
離線同步允許在對話結束後執行動作，而不是在對話期間執行。
啟用時
動作會在對話結束後執行一次
對話結束條件
文字代理： 最後一則訊息後的 10 分鐘
語音代理： 通話結束時
當您想擷取最終確定的資訊而不是即時更新資料時，此功能非常有用。
下一步
設定完成後，您的動作將自動：
從對話中擷取客戶詳細資訊
在 HubSpot 中建立或更新聯絡人
無需手動操作即可保持 CRM 資料的最新狀態
您現在可以在 Astra 中將此動作作為自動化工作流程的一部分使用。