設定匯入檔案
上次更新時間: 九月 22, 2023
無論HubSpot是您的第一個CRM ,還是您要從其他系統移動,匯入都可以幫助您建立記錄和活動,並更新您的資料庫。 匯入檔案是用來組織業務關係和流程的資料試算表。 在開始匯入之前,請查看匯入檔案的相關HubSpot條款和要求。
詞彙表
-
客戶關係管理對象:您的企業所擁有的關係或流程類型,例如聯絡人、公司、交易和聯絡單。 匯入時,物件是您要匯入HubSpot的資料集類型。
-
記錄:物件的個別實例(例如,「Tom Smith」是客服案件記錄)。 在單個物件匯入檔案中,檔案的每一行代表一個物件記錄。 如果要在一個檔案中匯入多個物件,每行將代表彼此關聯的記錄。
- 活動:可以與記錄相關聯的參與度,例如傳送給客服案件的電子郵件,或記錄在支援查詢記錄上的備註。 活動包括電話、電子郵件、會議、筆記和任務。 您可以建立新的活動,也可以透過匯入更新現有的通話,但無法 更新現有的電子郵件、會議、筆記或任務。 呼叫和任務可以自行匯入,但電子郵件、會議和備註必須匯入並與CRM物件關聯。
-
屬性:用於儲存記錄和活動相關資訊的欄位。 在匯入時,屬性將與檔案的欄標題相匹配。
示例文件
在此範例中,要匯入的物件是聯絡人。 每行代表聯絡人記錄,每列資訊代表聯絡人屬性(名字、姓氏、電子郵件地址)。
- 唯一識別碼: HubSpot用於將每個記錄識別為獨一無二的屬性值。 在匯入時,您需要一個唯一的標識符,以避免創建重複的記錄(例如, “Tom Smith”的兩個記錄)並關聯不同的記錄(例如,匯入“Tom Smith”並將其與其公司“Smith Inc.”關聯)。 匯入時可用的獨特識別碼有:
- 電子郵件:聯絡人的電子郵件地址。 匯入聯絡人時必須執行此操作,以避免重複或將聯絡人與其他物件關聯。 如果您沒有聯絡人電子郵件地址,請使用記錄ID更新並關聯現有的聯絡人記錄。
- 公司域名:公司的網站域名(例如example.com )。 當導入公司時,為了避免重複或將公司與另一個對象關聯,這是必需的。 如果您沒有公司網域名稱,請使用記錄ID更新並關聯現有的公司記錄。
- 記錄ID : HubSpot為每個記錄提供的唯一屬性值。 如果您從HubSpot匯出現有記錄,每個記錄都會有一個記錄ID。 匯入現有交易、票證或自訂物件並將其與其他物件關聯時,這是必填欄位,但如果您沒有電子郵件或公司網域名稱,也可以用作聯絡人和公司的唯一識別碼。
- 需要獨特值的自訂屬性(僅限公司、交易、門票和自訂物件) :如果您已建立需要獨特值的屬性,則可以將該屬性用作匯入檔案中的獨特識別碼。
- 關聯標籤(僅限專 業和企業) :指定記錄之間關係的值。 建立關聯標籤後,您可以將其與記錄一起匯入。
-
對應欄:匯入過程中的一個步驟,系統會提示您將檔案中的欄標題與HubSpot屬性相匹配。
例如,您希望在一個檔案中匯入並關聯聯絡人和公司。 要匯入和關聯的物件是聯絡人和公司。 每行代表一個客服案件記錄及其關聯的公司記錄。 每個欄標題代表將在匯入期間映射的屬性。 以下顯示的檔案包括聯絡人屬性(名字、 姓氏、電子郵件地址、電話號碼、最愛的食物)和公司屬性(名稱、公司網域名稱)。 每個物件還有一個唯一標識符,用於連結HubSpot中的兩個唯一記錄(聯絡人的電子郵件地址和公司的公司域名)。 在匯入過程中,您會將欄對應到HubSpot屬性(將First Name欄對應到First Name HubSpot屬性)。
示例文件

文件要求和技術限制
匯入HubSpot的所有檔案必須:- 是.csv、.xlsx或.xls文件。
- 只有一張工作表。
- 包含標題列,其中每個欄標題對應於HubSpot中的屬性。 欄標題可以按任何順序組織,而不會影響匯入。 您可以確認預設屬性是否已存在以匹配標題,或在匯入前建立自訂屬性。 進一步了解住宿要求。
- 包含少於1000列。
- 如果包含外語字元,請使用UTF-8編碼。
- 如果要在Excel檔案中匯入日期時間屬性,請包含數字格式的儲存格。
- 僅包含使用小數點格式的美元貨幣數據(例如123.45 )。
匯入工具有其他技術限制,具體取決於您的HubSpot訂閱。 這些限制包括匯入檔案的大小和行數限制,以及每天可以匯入的檔案和行數。
- 如果你使用HubSpot的免費工具,你可以:
- 匯入檔案大小上限為20MB。
- 每天最多完成50次匯入。
- 每天最多匯入500,000列。 如果您匯入的檔案包含超過500,000行,則需要多天才能完成。
- 如果你的帳戶擁有Starter、Professional或Enterprise訂閱,你可以:
- 匯入檔案大小上限為512 MB。
- 每天最多完成500次匯入。
- 每天最多匯入10,000,000行,每個檔案限制為1,048,576行。 如果你透過匯入API匯入,每天最多可以匯入80,000,000列。
這些限制適用於滾動的24小時期間,並且不會在一天中的特定時間重置。 深入瞭解您的HubSpot訂閱及其限制。
房源要求
格式化屬性值
正確匯入資料需要以下格式規則:
- 對於聯絡人屬性電話號碼和手機號碼,若要匯入並根據國家/地區代碼自動格式化電話號碼,請格式化為+ [國家/地區代碼] [號碼]。 如果有分機號碼,請新增分機號碼[number]。 例如,帶有美國國家代碼的電話號碼看起來像+11234567890 ext123。
- 對於包含價格的屬性,您必須使用HubSpot接受的貨幣之一。 您可以在帳戶預設設定的「貨幣」分頁中找到可接受的貨幣清單及其貨幣代碼。
- 匯入工具會忽略試算表中的空白儲存格,因此匯入新屬性資料時,如果記錄中沒有屬性值,請將儲存格留空。 如果現有記錄已在HubSpot中具有屬性的值,則空白儲存格不會清除現有的屬性值。 若要大量清除現有的屬性值,您可以手動編輯這些值,或使用「清除屬性值」工作流程動作。
- 若要在匯入期間將擁有者指派給記錄或活動:
- 對於物件,請包含[Object]擁有者標頭。 對於活動,請包括分配給標題的活動。
- 將使用者的姓名或電子郵件地址新增至該欄的每一列。 透過匯入指派記錄的使用者不會收到指派新記錄或活動的通知。
- 對於包含日期的屬性,若要格式化此屬性的值:
- 有效日期格式包括mm/dd/yyyy (2020年10月28日)、dd/mm/yyyy (2020年10月28日)或yyyy-mm-dd (2020-10-28)。
- 對於日期時間屬性,若要包含時間,請將時間戳記新增為hh: mm (28/10/2020 14:30)。 根據預設,匯入工具使用24小時制。 若要指定12小時制,請在時間戳記中新增AM或PM ( 2020年10月28日下午2:30 )。 如果你沒有提供時間戳記,系統會預設時間為午夜。
請注意:如果要匯入預設的HubSpot日期屬性(例如,關閉日期) ,則必須以毫秒為單位將值格式化為UNIX時間戳記。 匯入Excel檔案時,日期時間屬性儲存格必須為數字格式。 深入瞭解如何格式化時間戳記值,以及如何將日期轉換為UNIX格式。
-
- 對於列舉屬性類型,匯入檔案中的值必須與屬性定義選項的標籤或內部值相符。 對於HubSpot預設列舉屬性(例如,生命週期階段、行業) ,值必須與內部值或英文標籤相符。
- 深入瞭解如何匯入至核取方塊屬性。
- 匯入產品 時:
- 如果要匯入Term屬性值,請將Term欄中的值格式化為PXM ,其中X是月數(例如, P6M ,為期6個月)或PXY ,其中X是年數(例如, P1Y ,為期1年)。
- 如果要匯入帳單頻率屬性值,如果產品具有週期性價格類型,請按月、按年或按季度使用。 如果產品有一次性價格,請將儲存格留空。
必需的屬性
根據您要匯入的物件或活動,需要下列屬性,並且必須作為欄標題包含在檔案中:
- 聯絡人: 名字、姓氏、電子郵件中至少一個,或現有聯絡人的紀錄ID。
- 公司:名稱、公司網域名 稱或現有公司的記錄ID中至少一個。
- 優惠:如果您正在建立新優惠、優惠名稱、管線和優惠階段。 對於現有交易,請記錄ID。
- 聯絡單:如果你要建立新聯絡單,請提供聯絡單名稱、管道和聯絡單狀態。 對於現有聯絡單,請記錄ID。
- 產品:單價和名稱,或現有產品的記錄ID。
- 行項目:名稱、數量 、價格以及相關交易的記錄ID或交易名稱。 如果您還將行項目與產品關聯,請包含產品的產品ID ,該項目將在匯入期間映射為行項目屬性。
請注意:匯入包含交易的單行項目時,匯入不會更新交易金額。 若要更新關聯的交易金額,您可以手動編輯行項目,或在HubSpot中將行項目與交易關聯。
- 通話:通話備註(描述或提供通話內容的文字欄位)。
- 電子郵件:電子郵件正文(電子郵件的文本正文)和電子郵件方向(傳入或傳出)。
- 會議:會 議描述(描述會議的文字欄位)、會議開始時間和會議結束時間。 開始和結束時間值應格式化為日期時間屬性。
- 備註:備註內文(備註的文字內文)。
- 任務:任務標題(任務名稱)和截止日期。 截止日期的格式應為日期時間屬性。
其他屬性
不需要其他屬性,但也可以匯入HubSpot以批次新增或更新資料。 您可以匯入以下額外屬性:
- HubSpot預設聯絡人、公司、交易和票證屬性,不包括某些無法編輯的自動設定屬性。 進一步了解預設聯絡人、公司、優惠和聯絡單屬性。
- 你為聯絡人、公司、優惠、門票或自訂物件建立的任何自訂屬性。
- 針對所有活動,您可以匯入以下內容:
- 活動指派給:活動的所有者。 此屬性的值必須是HubSpot中的使用者名稱或使用者的電子郵件地址。
- 活動日期:活動發生的日期和時間。 此屬性的格式應為日期時間屬性。 如果您匯入新活動且不包含此屬性,活動日期值會自動設定為活動建立的日期和時間。
- 呼叫屬性:
- 通話和會議類型:通話類型。 這些選項會在通話和會議類型設定中設定。
- 所有方向:通話的方向,無論是主動聯繫還是主動聯繫。
- 通話持續時間:通話時間,以毫秒為單位。
- 通話結果:通話結果。 這些選項會在通話和會議結果設定中設定。
- 通話來源:通話來源。 選項包括VoIP、Zoom或整合平臺。
- 通話狀態:通話的狀態或結果。 選項包括「忙碌」、「已取消」、「已完成」、「連線中」、「失敗」、「進行中」、「錯過」、「無人接聽」、「佇列中」或「鈴聲
-
- 通話標題:通話的名稱。
- 寄件人號碼:發起通話的人的電話號碼。
-
- 錄音網址:存取通話錄音的網址。
- 收件人號碼:接聽來電者的電話號碼。
- 可用文字記錄:表示通話是否有文字記錄,真或假。
- 電子郵件屬性:
- 電子郵件主旨:電子郵件的主旨行。
- 電子郵件傳送狀態:電子郵件的狀態。 選項包括「退回」、「失敗」、「已排程」、「已傳送」或「已傳送」。
- 會議屬性:
-
- 通話和會議類型:會議類型。 這些選項會在通話和會議類型設定中設定。
- 內部會議筆記:用於新增會議筆記的文字欄位。
- 地點類型:舉辦會議的地點類型。 選項包括電話通話、地址或視訊會議。
- 集合地點:集合地點的名稱。
- 會議名稱:會議的名稱。
-
- 會議結果:會議結果。 這些選項會在通話和會議結果設定中設定。
- 任務屬性:
- 指派對象:被指派完成任務的使用者。
- 備註:用於新增任務備註的文字欄位。
- 優先順序:指派給任務的優先順序。 選項包括「低」、「中」或「高」。
- 佇列:應用於任務的任務佇列。
- 任務類型:任務類型。 選項包括電話、電子郵件或待辦事項。 如果您在匯入期間未設定類型,任務預設會設定為待辦事項。
- 任務狀態:任務的狀態。 選項包括「已完成」、「已延遲」、「進行中」、「未開始」或「等待中」。
關聯和重複資料刪除需求
- 要在一個檔案中匯入和關聯多個物件,請在同一行中包含關聯記錄和/或活動的相關資訊。 在兩個檔案中,使用公用欄連接每個檔案中的記錄。 您可以參考範例檔案,以獲取更多有關匯入和關聯記錄的說明。
- 若要更新現有記錄、關聯記錄並避免重複記錄,檔案必須包含每個物件的唯一識別碼屬性。 對於所有物件,您可以匯出現有的記錄,並使用記錄ID作為唯一識別碼。 對於聯絡人,您也可以使用電子郵件。 對於公司,您也可以使用公司域名。
- 如果您要匯入多個物件並包含記錄ID ,建議區分檔案欄標題以將ID與正確的物件相匹配(例如,一欄稱為「記錄ID -聯絡人」,另一欄稱為「記錄ID -公司」)。
- 您可以使用次要電子郵件作為HubSpot中列出次要電子郵件地址的現有聯絡人的唯一識別碼。 如果您使用次要電子郵件,且未在檔案中包含「 記錄ID」欄,則次要電子郵件不會取代主要電子郵件。 但是,如果您在檔案中同時包含輔助電子郵件和記錄ID作為欄,則輔助電子郵件將取代主要電子郵件。
- 若要將一個記錄與另一個物件的多個活動或記錄關聯,請將記錄的唯一識別碼包含在要關聯的每個記錄的多行中。 例如, Luke Danes是Luke 's Diner的經理,但也是The Dragonfly Inn的承包商。 若要將他與兩家公司聯繫起來,您需要為Luke Danes加入兩列,每個公司的電子郵件(或記錄ID )和公司網域名稱(或記錄ID )列。
請注意:如果您不包含唯一識別碼(例如電子郵件、公司網域名稱、記錄ID ) ,匯入將建立重複的記錄,而不是將每個記錄關聯到相同的記錄。
-
- 要設置多個標籤來描述兩個記錄之間的關係,您可以在一個儲存格中包含多個關聯標籤值,用分號分隔(例如,經理;帳單聯繫人)。
-
- 如果要在多個檔案匯入中匯入關聯標籤,則需要在同一檔案中包含關聯標籤欄和關聯物件的唯一識別碼。
- 若要透過匯入建立子母公司關聯,請在匯入檔案中包含母公司欄以及母公司的記錄ID值。 深入瞭解如何匯入子公司。
範例匯入檔案
以下檔案包含每個物件或活動所需的欄標題,以及可能的其他標題。 您可以添加自己的列標題,以更新或創建對維護組織的HubSpot數據庫很重要的任何其他屬性。
一個物件或活動
- 客服案件範例試算表: XLSX或 CSV
- 公司試算表範例: XLSX或 CSV
- 優惠試算表範例: XLSX或 CSV
- 支援查詢範例試算表: XLSX或 CSV
- 產品試算表範例: XLSX或 CSV
- 工作範例試算表: XLSX或 CSV
- 通話範例試算表: XLSX或 CSV
檔案準備就緒後,請瞭解如何將一個物件或活動匯入HubSpot。
請注意:產品只能在單個物件匯入中匯入。 您可以將現有產品關聯到行項目,或手動將產品關聯到交易或報價。
具有關聯的多個物件
您可以將多個物件或物件和活動匯入並關聯到一個檔案或兩個單獨的檔案中,其中每個檔案代表一個物件/活動。
在一個檔案中匯入多個物件
要在一個文件中匯入和關聯多個對象/活動,請在文件的同一行中包括要關聯的記錄/活動。 這些範例檔案代表常見的使用案例,但您可以透過取代欄標題來混合和匹配物件或活動。
- 聯絡人和公司試算表範例: XLSX或CSV。
- 具有關聯標籤的聯絡人和公司試算表範例: XLXS或 CSV
- 客服案件和聯絡單範例試算表: XLSX或 CSV
- 公司和交易示例試算表: XLSX或 CSV
- 公司和備註試算表範例: XLSX或 CSV
- 公司、交易和備註試算表範例: XLSX或 CSV
- 交易和新行項目範例試算表(含相關產品) : XLSX或CSV。 匯入一個檔案時,每個交易只能匯入一個行項目。
- 通話和聯絡人範例試算表: CSV
- 備註和聯絡單範例試算表: CSV
- 任務和現有交易範例試算表: CSV
- 電子郵件和現有客服案件範例試算表: CSV
檔案準備就緒後,請瞭解如何將多個物件或活動匯入並關聯到HubSpot。
匯入兩個檔案中的多個物件
匯入並關聯兩個檔案時,每個檔案代表一個物件或活動。 在兩個檔案匯入中,您只能匯入兩個物件或一個物件和一個活動。 若要匯入兩個以上的物件/活動,您可以在一個檔案中匯入。
要確定哪些記錄應在文件之間關聯,請在兩者中都包含一個公用列。 其中一個檔案在此欄的每一列都應具有唯一的值。 在另一個檔案中,使用這些值來指示每行應與哪個記錄關聯。 例如,常見用例是匯入和關聯聯絡人和公司。 在以下示例文件中,公司名稱是常用列:
在公司文件中,公司名稱列中的每行都有唯一的值。 在聯絡人檔案的每行中,「公司名稱」欄中的值與聯絡人將與之關聯的公司相符。 您可以在匯入聯絡人和公司時使用這些檔案,或混合和匹配其他物件,只要包含一個公用欄即可。
其他示例包括:
- 在兩個檔案中有關聯標籤 的交易和公司:在這些樣本檔案中,公司名稱是公司物件的唯一密鑰。
- 兩個檔案中的交易和新行項目:在這些範例檔案中,交易名稱是交易物件的唯一金鑰。 匯入兩個檔案時,您可以匯入每個交易的多個行項目。
- 兩個檔案中的來電和聯絡人:在這些檔案中,電子郵件是聯絡人的常用欄和唯一鍵 。
檔案準備就緒後,了解如何將多個物件或活動匯入並關聯到HubSpot。