上次更新時間： 2025年6月3日
在您將資料匯入 HubSpot 之前，請檢閱下列限制和要求。您也可以存取範例檔案 或產生範例檔案，以便開始使用。
若要進一步瞭解匯入工具，請參閱這篇文章。如果您的檔案已準備就緒，請學習如何匯入。
技術要求和限制
所有匯入 HubSpot 的檔案必須：- 為 .csv、.xlsx 或 .xls 檔案。
- 只有一張工作表。
- 包含一列標題，其中每一列標題對應 HubSpot 中的一個屬性。列標題可以任何順序組織而不影響匯入。您可以確認是否已有預設 的屬性 與您的標題相符，或在匯入前建立自訂屬性。進一步了解屬性需求。
- 包含少於 1000 列。
- 如果包含外語字元，則應採用 UTF-8 編碼。
- 如果您匯入的是 Excel 檔案：
- 包含的資料不超出 Excel工作表和工作簿的最大限制。
- 匯入日期和時間選擇器屬性時，包含Number 格式的儲存格。
根據您的 HubSpot 訂閱，匯入工具還有其他技術限制。這些限制包括匯入檔案的大小和行數限制，以及每天可匯入的檔案和行數。
- 如果您只使用 HubSpot 的免費或Smart CRM 專業版 或企業 版工具，則可以：
- 匯入最大 20MB 的檔案。
- 每天最多完成 50 次匯入。
- 每天最多匯入 500,000 行。如果您匯入的檔案包含超過 500,000 行，則需要多天才能完成。
- 如果您的帳戶有Starter、Professional 或Enterprise訂閱，您就可以：
- 匯入最大 512 MB 的檔案。
- 每天最多完成 500 次匯入。
- 每天最多匯入 10,000,000 行，每個檔案的限制為 1,048,576 行。如果您透過匯入API 匯入，每天最多可匯入 80,000,000 行。
這些限制適用於滾動的 24 小時期間，不會在一天中的特定時間重設。進一步瞭解您的HubSpot 訂閱及其限制。
格式化數值
對於匯入檔案的每一行，您都可以為屬性欄位新增數值。值的格式取決於屬性欄位類型和匯入的目標。
根據屬性欄位類型格式化值
根據屬性欄位類型，有特定的格式要求：
| 領域類型 | 需求 |
| 日期選擇器 日期和時間選擇器 |
月份可以是數字、三個字母或全名 (10、OCT、Oct、OCTOBER、10 月)，年份可以是兩位數字或四位數字 (2023、23)，分隔符可以是正斜線、連字符或句點 (10/28/2023、10-28-2023、10.28.2023)。 有效的日期格式為年月日 (如 28/10/2023)、年月日 (如 10-28-23)，或年月日 (如 2023.OCT.28)。 如果您已設定驗證規則，您匯入的值必須遵循規則，否則將無法匯入。 |
| 日期和時間選擇器 |
時間戳可在所有檔案類型中加入 hh:mm (28/10/2020 14:30) ，或在 CSV 檔案或具有文字數字格式儲存格的 Excel 檔案中加入以毫秒為單位的 UNIX 時間戳。如果不包含時間戳記，時間預設為午夜。 |
| 持續時間 |
對於包含持續時間的屬性，例如Call duration 屬性，您的值必須格式化為 UNIX 時間戳，單位為毫秒。進一步瞭解如何格式化時間戳值，以及如何將日期轉換成UNIX 格式。 |
| 枚舉 |
匯入檔案中的值必須符合屬性定義選項的標籤或內部值。對於 HubSpot 預設的枚舉屬性 (例如：生命週期階段、行業)，其值必須符合內部值或英文標籤。 |
| 檔案 |
|
| 多個複選框 |
若要匯入多個值，請在每個值之間加入分號，且不含空格 (值 1;值 2)。這些屬性選項必須在匯入前建立。 若要新增或追加值，請在第一個值之前加上分號 (;值 3;值 4)。這將會追加值，而不是覆寫現有的屬性值。 |
| 數量 |
根據建立的數字屬性類型格式化數值：
|
| 單一複選框 |
為單一複選框欄位建立一列，並將每一行的值設定為True或Yes，以便在 HubSpot 中顯示為 Yes 或已勾選；或False 或 No ，以便在 HubSpot 中顯示為 No 或未勾選。 |
| 期限屬性 |
項目屬性Term 應以 PnYnMnD 或 PnW 的ISO-8601 期間格式加入。例如，P12M 或 P24M 表示年度期限。如果留空，將設定預設期限。 |
| 文字 |
如果您設定了 驗證規則，您匯入的值必須遵循規則，否則將無法匯入。 |
| 使用者（所有者） |
在匯入時為記錄或活動指定擁有者：
|
其他聯絡人電子郵件或公司網域
如果您匯入的連絡人有多個電子郵件地址，請在附加電子郵件地址欄中加入其次要電子郵件地址。如果您匯入的公司有一個以上的網域名稱，請在附加 網域列中 加入其次要網域。若要在單元格中包含多個電子郵件或網域，請使用分號分隔各值 (例如：email@email.com; emailtwo@email.com)。
如果您正在匯入以建立聯絡人或公司，則無法將新聯絡人的電子郵件或新公司的公司網域名稱 設定為另一記錄的現有附加電子郵件或網域。
空白儲存格
匯入工具會忽略電子表格中的空白儲存格，因此在匯入新的屬性資料時，請將沒有屬性值的記錄留空。如果現有記錄在 HubSpot 中已有屬性值，則空白單元格將 不清除現有的屬性值。若要大量清除現有的屬性值，您可以 手動編輯數值 或使用 清除屬性值工作流程動作 .交易合作夥伴
如果您要透過匯入將合作者加入交易，請包含一個 交易合作夥伴標頭。對於每個儲存格，您必須包含兩個或兩個以上的使用者，並以分號隔開 (例如 user1@example.com;user2@example.com)。產品期限與帳單頻率
如果匯入的是Term物業值，您可以將Term列中的值格式化為以月為單位的數字（例如，10表示 10 個月）、PXM （其中 X 是月數）（例如，P6M，表示期限為 6 個月）或PXY（其中 X 是年數）（例如，P1Y，表示期限為 1 年）。
如果匯入帳單頻率屬性值，如果產品是定期價格類型，請使用每月、每年或每季。如果產品是一次性價格，請留空該單元格。
所需的屬性
視您匯入的物件或活動而定，以下屬性是建立記錄所必需的，並且必須包含在檔案中作為欄頭。如果您要更新記錄，則必須包含唯一的識別碼(例如：記錄 ID、電子郵件、公司網域名稱)。
雖然不是必需的，但您可以為每個物件匯入其他屬性，包括自訂和預設屬性。請參考聯絡人、公司、交易、票據、通話、電 子郵件、會議、備註和任務的預設屬性。您也可以在屬性設定中檢視所有屬性及其值。
- 連絡人： 名、姓或電子郵件中至少一項。
- 公司： 名稱或公司網域名稱中的至少一項。
- 交易：如果您要建立新的交易，請輸入交易名稱、管道和交易階段。
- Tickets (票單)： 如果您要建立新的票單，請輸入票單的名稱、管道 及票單狀態。
- 約會：約會開始。約會開始的格式應為日期時間屬性。
- 課程：課程名稱。
- 列表：名稱。
- 服務：名稱、管道和管道階段。
- 產品： 如果您要建立產品， 單價 和名稱。
- 訂單：名稱、管道和管道階段。
- 購物車：名稱。
- 細列項目： 名稱、數量、價格， 以及相關交易的記錄 ID 或交易名稱。如果您也將行項目與產品相關聯，請包含產品的 產品 ID ，這將在匯入時對應為行項屬性。
請注意：當匯入交易的明細項目時，匯入將不會更新交易金額。若要更新相關的交易金額，您可以手動編輯細列項目，或在 HubSpot 中將細列項目與交易關聯。
- 通話： 通話備註。匯入新通話時，也建議包含活動日期。
- 電子郵件： 電子郵件正文和 電子郵件方向。
- 會議：會議描述、會議開始時間和會議結束時間。匯入新會議時，也建議包含活動日期。開始時間、結束時間和活動日期值的格式應為日期時間屬性。
- 附註：附註正文。
- 任務：任務標題和到期日。 到期日應以日期時間屬性格式化。
請注意：雖然並非必要，但建議在匯入新活動時包含活動日期，以指定活動發生的日期和時間。如果您不包含此屬性，活動日期值會自動設定為匯入的日期和時間。
更新現有記錄或避免重複的要求
要更新現有記錄和避免重複記錄，您的檔案必須包含每個物件的唯一識別碼屬性。對於所有物件，您可以 匯出現有記錄 ，並 使用記錄 ID作為唯一識別碼，或使用需要唯一值的自訂屬性。 對於聯絡人，您也可以使用電子郵件。對於公司，您也可以使用公司網域名稱。
如果您要匯入多個物件，並且包含「記錄 ID」，建議您區分檔案欄頭，使 ID 與正確的物件相符 (例如，一列稱為「記錄 ID - 聯絡人」，另一列稱為「記錄 ID - 公司」)。
請注意： 如果您的檔案中包含電子郵件或公司網域名稱 ，則以下行為適用：
- 如果您使用自訂唯一值屬性來重複聯絡人，則電子郵件屬性仍需要唯一值。
- 如果您使用自訂唯一值屬性來重複公司，則公司網域名稱屬性將不需要唯一值。這表示您可以匯入重複的公司網域名稱。如果您不希望多間公司使用相同的網域名稱，您應該在匯入前移除檔案中重複的網域，或改用公司網域名稱作為唯一識別碼。
- 對於在 HubSpot 中列出第二電子郵件地址的現有聯絡人，您可以使用第二電子郵件作為唯一識別碼。如果您使用次要電子郵件，但未 在檔案中包含「 記錄 ID」 欄，次要電子郵件將不會取代主要電子郵件。但是，如果您在文件中包含副電子郵件和記錄 ID 列，副電子郵件將取代主電子郵件。
關聯記錄的要求
在一個檔案中匯入關聯
在一個檔案中，每一行可聯繫兩個或多個記錄。在同一行中包含關聯記錄和/或活動的資訊，並包含每個物件的唯一識別碼。若要將一筆記錄與另一個物件的多個活動或記錄關聯，請在要關聯的每筆記錄的多行中包含該記錄的唯一識別碼。
例如，Luke Danes 是 Luke's Diner 的經理，但卻是 The Dragonfly Inn 的承包商。若要將他與這兩家公司聯繫起來，您需要為 Luke Danes 加入兩行，每家公司的欄位分別是電子郵件(或記錄 ID) 和公司網域名稱(或記錄 ID)。
請注意： 如果您沒有包含唯一的識別碼 (例如：電子郵件、公司網域名稱、記錄ID)，匯入將產生重複的記錄，而不是將每個記錄與相同的記錄相關聯。
如果您要匯入相同的物件關聯，還有其他要求。
匯入兩個檔案中的關聯
若要關聯兩個檔案中兩個物件的記錄，請使用共用列來連接每個檔案中的記錄。您可以參考範例檔案，以獲得匯入和關聯記錄的更多協助。
相同的物件關聯
您可以匯入一個檔案，以大量關聯相同物件的記錄。在匯入過程中，您需要選擇核取方塊，以包含相同物件的關聯。
設定檔案時，請在同一行中包含相關記錄的資訊，並為每條記錄包含唯一的識別碼。以下是相同物件匯入的特定附加要求：
- 在匯入之前，記錄對中至少有一條記錄必須已經存在於 HubSpot 中。例如，您可以匯入一個新的聯絡人並將其與現有的聯絡人建立關聯，但您不能匯入以建立並關聯兩個新的聯絡人。
- 關聯現有聯絡人/公司時，您只能使用主要 電子郵件/公司網域作為唯一識別碼。不支援次要電子郵件或網域。
- 如果要將多筆記錄聯繫到一筆記錄，請在同一個儲存格中以分號分隔記錄的唯一識別符值 (例如：luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com)。
在下面的範例檔案中，Rory 和 Jackson 是新的連絡人，使用他們的電子郵件值作為唯一識別符，以唯一標籤與現有連絡人建立關聯。Sookie 是現有的聯絡人，與兩個具有相同標籤的現有聯絡人建立關聯。在第一行中，關聯標籤是標籤對的一部分，這意味著一旦匯入完成，關聯記錄將擁有Parent 標籤，而 Rory 則擁有配對標籤Child。
親子協會
若要透過匯入建立子母公司關聯，請瞭解更多關於匯入子公司的資訊。
自訂關聯標籤（僅限專業版和企業版）
若要匯入關聯標籤，請加入 關聯標籤欄 。只有當您想要加入標籤來描述關聯時，才需要加入此列。如果您不需要標籤關聯，則不需要此列。
- 您必須在匯入之前在 HubSpot 中建立關聯標籤。
- 要將公司關聯設為主要關聯，請在該行的關聯標籤 列中包含值Primary。
- 若要設定多個標籤來描述兩筆記錄之間的關係，您可以在一個儲存格中包含多個關聯標籤值，並以分號隔開（例如，經理；帳單聯絡人）。
- 如果您要在 多檔案匯入中匯入關聯標籤，您需要在同一個檔案中包含關聯標 籤欄和您要關聯的物件的唯一識別碼。
- 如果您要匯入成對的標籤：
- 對於跨物件關聯，只需在關聯標籤列中包含其中一個標籤。在匯入過程中，標籤會被指定給正確的物件。
- 對於同一物件關聯， 關聯 [唯一識別碼] 欄中 的記錄將接收在匯入過程中加入 或包含在檔案標籤欄中的標籤。行中的其他記錄將接收標籤對中的另一個標籤。
範例檔案
在匯入程序開始時，您可以產生一個範例檔案，其中包含所選物件和活動的所需屬性。如果您想檢視更多包含其他屬性的範例，請參閱這篇文章的範例檔案。