跳到內容
請注意::這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立,可能沒有經過校對。因此,這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

設定匯入檔案

上次更新時間: 三月 22, 2023

套用至:

所有產品和版本

無論HubSpot是您的第一個CRM還是您從其他系統移動,匯入都可以幫助您創建記錄和活動,並更新您的數據庫。 匯入檔案是用於組織業務關係和流程的資料電子表格。 在開始匯入之前,請查看匯入檔案的相關HubSpot條款和要求。

詞彙表

  • CRM對象:一種類型的關係或過程,您的企業,如聯繫人,公司,交易和工單。 匯入時,物件是您匯入HubSpot的資料集類型。

  • 記錄:對象的單個實例(例如, “湯姆·史密斯”是一個聯繫記錄)。 在單個物件匯入檔案中,檔案的每行代表一個物件記錄。 如果您要在一個檔案中匯入多個物件,每行將表示彼此關聯的記錄。

  • 活動:可以與記錄相關聯的參與,例如發送給聯絡人的電子郵件,或記錄在工單記錄上的備註。 活動包括電話、電子郵件、會議、筆記和任務。 您可以透過匯入建立新活動,但不 更新現有的活動。 呼叫和任務可以自行匯入,但電子郵件、會議和筆記必須匯入並與CRM物件關聯。
  • 屬性:一個欄位,用於儲存有關您的記錄和活動的信息。 在匯入中,屬性將與檔案的欄標題相匹配。

    contact-import-example-1示例文件

在此範例中,正在匯入的物件是聯絡人。 每行代表聯絡人記錄,每列資訊代表聯絡人屬性 (名字、姓氏、電子郵件地址)。

  • 唯一識別碼: HubSpot用來識別每個記錄的屬性值。 在匯入時,您需要一個唯一的識別碼以避免創建重複的記錄(例如, “Tom Smith”的兩個記錄)並關聯不同的記錄(例如,匯入“Tom Smith”並將他與他的公司“Smith Inc.”關聯)。 匯入時可用的唯一識別碼是:
    • Email :聯系人的郵箱地址。 在匯入聯絡人時,這是必要的,以避免重複或將聯絡人與另一個物件關聯。 如果您沒有聯絡人電子郵件地址,請使用記錄ID來更新和關聯現有的聯絡人記錄。
    • 公司域名:公司的網站域名(例如example.com )。 這在進口公司時是必需的,以避免重複或將公司與另一個對象聯繫起來。 如果您沒有公司網域名稱,請使用記錄ID來更新和關聯現有的公司記錄。
    • 記錄ID : HubSpot為每個記錄指定的唯一屬性值。 如果從HubSpot匯出現有記錄,則每個記錄都會有一個記錄ID。 在匯入現有交易、工單或自訂物件並將其與另一個物件關聯時,這是必需的欄位,但如果您沒有電子郵件或公司網域名稱,也可以用作聯絡人和公司的唯一識別碼。
    • 自訂唯一值屬性(僅限優惠、工單和自訂物件測試版) :如果您已建立需要唯一值的屬性,您可以在匯入檔案中使用該屬性作為唯一識別碼。
  • 關聯標籤(僅限專 業和企業) :指定記錄之間關係的值。 建立關聯標籤後,您可以將它們與記錄一起匯入。
  • 映射欄位:匯入過程中的一個步驟,系統會提示您將檔案中的欄位標題與HubSpot屬性相匹配。

例如,您要在一個檔案中匯入和關聯聯絡人和公司。 正在匯入和關聯的物件是聯絡人和公司。 每行代表聯絡人紀錄及其相關公司紀錄。 每個欄位標題表示將在匯入期間映射的屬性。 下列檔案包括聯絡人屬性(名字、 姓氏、電子郵件地址、電話號碼、最愛的食物) 和公司屬性 (姓名、公司網域名稱)。 每個對象還有一個唯一的識別碼,它將連接HubSpot中的兩個唯一記錄(聯繫人的電子郵件地址和公司的公司域名)。 在匯入過程中,您將將欄位映射到HubSpot屬性( First Name欄位到First Name HubSpot屬性)。

import-contacts-and-companies-example-1示例文件

import-mapping-examples將列映射到屬性

文件要求

匯入HubSpot的所有檔案必須:

  • 是.csv、.xlsx或.xls文件。
  • 只有一張牀單。
  • 包含少於1,048,576行和1,000列。
  • 對於使用免費工具的用戶,文件必須小於20MB。 對於擁有Starter、Professional或Enterprise訂閱的帳戶,檔案最多可達512 MB。
  • 包含一個標題行,其中每個列標題對應於HubSpot中的屬性。 列標題可以以任何順序組織,而不會影響匯入。 您可以在匯入之前確認預設屬性是否已經存在以匹配您的標題或創建自訂屬性。 進一步了解HubSpot對聯絡人公司優惠和工的預設屬性。
  • 如果包含外語字符,則為UTF-8編碼。
  • 如果要在Excel檔案中匯入日期-時間屬性,則包含數字格式的儲存格。
  • 僅包含使用小數(例如123.45 )格式化爲美元的貨幣數據。 

房源要求

正在格式化房源值

下列格式規則是正確匯入資料所必需的:

  • 對於聯絡人屬性電話號碼和手機號碼,根據國家代碼自動導入並格式化電話號碼,格式為+ [國家代碼] [號碼]。 如果有分機,添加分機[數字]。 例如,使用美國國家代碼的電話號碼看起來像+11234567890 ext123。
  • 對於包含價格的旅居,您必須使用HubSpot接受的貨幣之一。 接受的貨幣及其貨幣代碼清單可在帳戶預設設定中的「貨幣」標籤頁中找到。
  • 匯入工具會忽略電子表格中的空格,因此在匯入新的屬性資料時,如果記錄中沒有屬性值,則儲存空格。 如果現有記錄已在HubSpot中具有該屬性的值,則空白儲存格將不會清除現有屬性值。 若要批量清除現有屬性值,您可以手動編輯值或使用清除屬性值工作流程操作
  • 若要在匯入期間為記錄或活動指派擁有者:
    • 對於物件,包括一個[物件]擁有者標頭。 對於活動,包括分配給標題的活動。
    • 使用者的姓名或電子郵件地址新增至該欄的每一行。 透過匯入指派紀錄的使用者不會收到指派新紀錄或活動的通知
  • 若屬性包含日期,則格式化此屬性的值:
    • 有效日期格式包括mm/dd/yyyy (10/28/2020)、dd/mm/yyyy (28/10/2020)或yyyy-mm-dd (2020-10-28)。
    • 若要包含時間,請將時間戳新增為hh: mm (28/10/2020 14:30)。 預設情況下,匯入工具使用24小時制。 若要指定12小時的時鐘,請在時間戳記中新增AM或PM (10/28/2020 2:30 PM)。 如果沒有包含時間戳記,預設時間會設定為午夜。

請注意:如果您要匯入預設的HubSpot日期屬性(例如,關閉日期) ,則您的值必須格式化為以毫秒為單位的UNIX時間戳記。 如果匯入Excel檔案,則日期-時間屬性儲存格必須為數字格式。 進一步了解如何格式化時間戳值,以及如何將日期轉換為UNIX格式。

  • 根據屬性欄位類型,還有其他特定的格式要求:
    • 對於自訂數字或文字屬性,如果您已設定驗證規則,則匯入的值必須遵循規則,否則將不會被匯入。
  • 輸入產品時(僅限專 業和企業) :
    • 如果要匯入Term屬性值,請將Term欄中的值格式化為PXM ,其中X是月數(例如, P6M ,期限為6個月)或PXY ,其中X是年數(例如, P1Y ,期限為1年)。
    • 如果要匯入帳單頻率屬性值,如果產品具有定期價格類型,請使用每月、每年或每季度。 如果產品有一次性價格,請將儲存格留空。

必需的特性

根據您要匯入的物件或活動,需要下列屬性,並且必須在檔案中包含為列標題:

  • 聯絡人: 名字、姓氏、電子郵件或現有聯絡人、記錄ID中的至少一項。
  • 公司:至少有一個名稱、公司網域名稱或現有公司的記錄ID。
  • 交易:如果您正在創建新交易,交易名稱,管道和交易階段。 對於現有的交易,記錄ID。 
  • 工單:如果您要新建工單、工單名稱、管道和工單狀態。 對於現有的工單,記錄ID。 
  • 產品:單價和名稱,或對於現有產品, 記錄ID。
  • 明細項目:名稱、數量 、價格,以及相關交易的記錄ID或交易名稱。 如果您也將行項目與產品關聯,請包含產品的產品ID ,該產品將在匯入期間作為行項目屬性映射。

請注意:透過匯入,您可以匯入以建立新的行項目,但不更新現有的行項目。 當 匯入包含交易的明細項目時,匯入將不會更新交易金額。 若要更新現有行項目或更新相關交易金額,您可以手動編輯行項目或將行項目與HubSpot中的交易關聯。


  • 呼叫:呼叫備註(描述或提供呼叫上下文的文本欄位)。
  • 電子郵件:電子郵件正文(電子郵件的文本正文)和電子郵件方向( 傳入或傳出)。
  • 會議:會 議說明(描述會議的文字欄位)會議開始時間會議結束時間。 開始和結束時間值應格式化為日期-時間屬性
  • 注:注正文(注的文本正文)
  • 任務:任務標題(任務名稱)和截止日期。 截止日期應格式化爲日期-時間屬性

其他房源

不需要其他屬性,但也可以匯入HubSpot以批量添加或更新數據。 您可以匯入以下附加屬性:

  • HubSpot預設的聯絡人、公司、交易和工單屬性,不包括某些自動設定無法編輯的屬性。 進一步了解預設聯絡人、公司優惠票務屬性。
  • 您為聯絡人、公司、優惠、工單或自訂物件建立的任何自訂房源
  • 對於所有活動,您可以匯入以下內容:
    • Activity assigned to:活動的所有者。 此屬性的值必須是HubSpot中的用戶名稱或用戶的電子郵件地址。 
    • 活動日期:活動發生的日期和時間。 這應該被格式化為日期-時間屬性。 如果您匯入新活動但不包含此屬性,活動日期值會自動設定為活動建立的日期和時間。
  • 呼叫屬性:
    • 呼叫方向:呼叫的方向,呼 入或呼出。  
    • 呼叫來源:呼叫的來源。 選項包括VoIP、 Zoom或 整合平臺。
    • 呼叫狀態: 呼叫的狀態或結果。 選項包括忙碌、 已取消、已 完成、 正在連線、 失敗、正在進行中  錯過、 無人接聽、 已排隊或 正在振鈴。
    • Call title :呼叫的名稱。
    • 錄音URL :存取通話錄音的URL。
    • 字幕可用:指示呼叫是否有字幕,真或假。
  • 電子郵件屬性:
    • 電子郵件主題: 電子郵件的主題行。
    • 電子郵件發送狀態:電子郵件的狀態。 選項包括 退回、 失敗、 排程、 發送或 發送。
  • 會議屬性:
    • 內部會議備註:用於新增會議備註的文本欄位。
    • 地點類型:舉辦會議的地點類型。 選項包括 電話呼叫、 地址或 視訊會議。
    • 會議地點:會議地點的名稱。
    • 會議名稱:會議的名稱。
  • 任務屬性:
    • 備註:用於新增任務備註的文本欄位。
    • 優先順序:指派給任務的優先順序。 選項包括 低、 中或 高。
    • 任務類型:任務的類型。 選項包括 呼叫、 電子郵件或 待辦事項。 如果您在匯入期間沒有設定類型,則該任務預設會設定為 待辦 事項。 
    • 任務狀態:任務的狀態。 選項包括「 已完成」、「 延期」、「正在 進行」、 「未開始」或「 等待」。

聯想和重復數據刪除要求

  • 若要在一個檔案中匯入和關聯多個物件,請包含有關同一行中的相關記錄和/或活動的資訊。 在兩個檔案中,使用共用欄位連接每個檔案中的記錄。 您可以參閱範例檔案,以獲得更多有關匯入和關聯記錄的協助。
  • 若要更新現有記錄、關聯記錄並避免重複記錄,您的檔案必須為每個物件包含唯一的識別碼屬性。 對於所有物件,您可以匯出現有記錄,並將記錄ID用作唯一識別碼。 對於聯系人,您也可以使用電子郵件。 對於公司,您也可以使用公司域名。
    • 如果您要匯入多個物件並包含紀錄ID ,建議區分檔案欄標題以將ID與正確的物件相匹配(例如,一列稱為紀錄ID -聯絡人,另一列稱為紀錄ID -公司)。
    • 您可以使用次要電子郵件作為現有聯絡人的唯一識別碼,這些聯絡人在HubSpot中列出了次要電子郵件地址。 如果您使用的是次要電子郵件,且在檔案中包含「記錄ID」欄,則次要電子郵件不會取代主要電子郵件。 但是,如果您在檔案中同時包含備用電子郵件和記錄ID列,則備用電子郵件取代主要電子郵件。
  • 若要將一個記錄與另一個物件的個活動或記錄關聯,請在要關聯的每個記錄的多行中包含記錄的唯一識別碼 。 例如, Luke Danes是Luke 's Diner的經理,但卻是The Dragonfly Inn的承包商。 要將他與兩家公司聯繫起來,您需要將Luke Danes的兩行包含在每家公司的電子郵件(或記錄ID )和公司域名(或記錄ID )列中。

請注意:如果您不包含唯一的識別碼(例如,電子郵件、公司網域名稱、記錄 ID ) ,匯入將創建重複的記錄,而不是將每個記錄關聯到相同的記錄。

flex-associations-import-example

  • 若要匯入關聯標籤(僅限 業和企業) ,請包含一個關聯標籤列。  在匯入之前,您必須在HubSpot中建立關聯標籤
    • 若要設定多個標籤來描述兩個記錄之間的關係,您可以在一個儲存格中包含多個關聯標籤值,以分號分隔(例如, Manager; Billing contact )。
    • 如果要在多個檔案匯入中匯入關聯標籤,則需要包含「關聯標籤」欄您在同一檔案中關聯的物件的唯一識別碼。
  • 若要透過匯入建立子母公司關聯,請在匯入檔案中包含一個母公司欄位,以及母公司的記錄ID值。 了解更多關於進口兒童公司的資訊。

示例匯入檔案

以下檔案包括每個物件或活動所需的欄標題,以及可能的額外標題。 您可以新增自己的欄標題來更新或建立任何其他屬性,這些屬性對維護組織的HubSpot資料庫非常重要。

一個物件

  • 聯系人示例電子表格: XLSXCSV
  • 公司示例表格: XLSXCSV
  • 交易示例電子表格: XLSXCSV
  • 工單示例電子表格: XLSXCSV
  • 產品示例試算表: XLSXCSV

檔案準備就緒後,請瞭解如何將一個物件或活動匯入HubSpot。

請注意:產品只能在單個物件匯入中匯入。 您可以將現有產品關聯到明細項目,或手動將產品關聯到交易或報價

具有關聯的多個物件

您可以將多個物件或物件和活動匯入並關聯在一個檔案或兩個獨立的檔案中,其中每個檔案代表一個物件/活動。

在一個檔案中匯入多個物件

若要在一個檔案中匯入和關聯多物件/活動,請在檔案的同一行中包含您要關聯的記錄/活動。 這些示例文件代表常見用例,但您可以通過替換欄標題來混合和匹配物件或活動。

  • 聯系人和公司示例電子表格:  XLSXCSV。
  • 具有關聯標籤示例試算表的聯絡人和公司 XLXS或CSV。
  • 聯系人和工單示例電子表格: XLSXCSV。
  • 公司和交易示例電子表格: XLSXCSV。
  • 公司和筆記示例試算表: XLSXCSV。
  • 公司、交易和筆記示例試算表: XLSXCSV。
  • 交易和新行項目示例試算表(包括相關產品) XLSXCSV。 匯入一個檔案時,每筆交易只能匯入一個明細項目
  • 呼叫和聯系人示例電子表格: CSV。
  • 備註和工單示例試算表: CSV。
  • 工作和現有交易示例試算表CSV。

檔案準備就緒後,請瞭解如何將多個物件或活動匯入並關聯至HubSpot。

在兩個檔案中匯入多個物件

兩個檔案中匯入和關聯時,每個檔案代表一個物件或活動。 您只能在兩個檔案匯入中匯入兩個物件或一個物件和一個活動。 若要匯入多於兩個物件/活動,您可以在一個檔案中匯入。

確定哪些記錄應該在檔案之間關聯,在兩者中都包含一個共同的欄位。 此列中的每行都應具有唯一的值。 在另一個檔案中,使用這些值來指示每行應與哪個記錄相關聯。 例如,一個常見的用例是匯入和關聯聯絡人和公司。 在以下示例文件中,公司名稱是常用列:

在公司文件中, “公司名稱”列中的每行都有唯一的值。 在聯絡人檔案的每行中,公司名稱欄中的值與聯絡人將與之關聯的公司相匹配。 您可以在匯入聯絡人和公司時使用這些檔案,或混合搭配其他物件,只要包含一個共同欄位即可。

其他示例包括:

  • 在兩個檔案中有關聯標籤 的交易和公司:在這些示例檔案中,公司名稱是公司物件的唯一密鑰。
  • 交易和兩個檔案中的新行項目:在這些示例檔案中,交易名稱是交易對象的唯一關鍵。 匯入兩個檔案時,您可以匯入每個交易的多個行項目
    • 交易示例電子表格: XLSXCSV
    • 明細項目示例電子表格(以及相關產品) : XLSXCSV
  • 兩個檔案中的呼叫和聯絡人:在這些檔案中,電子郵件是聯絡人的公用欄位和唯一鍵
    • 呼叫示例電子表格CSV。
    • 聯系人示例電子表格CSV。

檔案準備就緒後,請瞭解如何將多個物件或活動匯入並關聯至HubSpot。

這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助