上次更新時間： 2025年10月3日
在您將資料匯入 HubSpot 之前，請檢閱下列限制和要求。您也可以存取範例檔案 或產生範例檔案，以便開始使用。
要了解更多關於匯入工具，請參考這篇文章。如果您的檔案已準備就緒，請學習如何匯入。
技術要求和限制
所有匯入 HubSpot 的檔案必須：- 為 .csv、.xlsx 或 .xls 檔案。
- 只有一張工作表。
- 包含一個標題行，其中每一列標題對應 HubSpot 中的一個屬性。列標題可以任何順序組織而不影響匯入。您可以確認是否已有預設 的屬性 與您的標題相符，或在匯入前建立自訂屬性。進一步了解屬性需求。
- 包含少於 1000 列。
- 如果包含外語字元，則應為 UTF-8 編碼。
- 如果您匯入的是 Excel 檔案：
- 包含的資料不超出 Excel工作表和工作簿的最大限制。
- 匯入日期和時間選擇器屬性時，包含Number 格式的儲存格。
根據您的 HubSpot 訂閱，匯入工具還有其他技術限制。這些限制包括匯入檔案的大小和行數限制，以及每天可匯入的檔案和行數。
- 如果您只使用 HubSpot 的免費或Smart CRM Professional 或Enterprise 工具，則可以：
- 匯入最大 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 時間戳記。如果不包含時間戳記，時間預設為午夜。 |
| 時間長度 |
對於包含持續時間的屬性，例如呼叫持續時間屬性，您的值必須格式化為 UNIX 時間戳，單位為毫秒。進一步瞭解如何格式化時間戳值，以及如何將日期轉換成UNIX 格式。 |
| 枚舉 |
匯入檔案中的值必須符合屬性定義選項的標籤或內部值。對於 HubSpot 預設的枚舉屬性 (例如：生命週期階段、行業)，其值必須符合內部值或英文標籤。 |
| 檔案 |
|
| 多個核取方塊 |
若要匯入多個值，請在每個值之間加入分號，不要有空格 (值 1;值 2)。這些屬性選項必須在匯入前建立。 若要新增或追加值，請在第一個值之前加上分號 (;值 3;值 4)。這將會追加值，而不是覆寫現有的屬性值。 |
| 數量 |
根據建立的數字屬性類型格式化數值：
|
| 單一核取方塊 |
為單一複選框欄位建立一列，並將每一行的值設定為True或Yes，以便在 HubSpot 中顯示為 Yes 或已勾選；或False 或 No ，以便在 HubSpot 中顯示為 No 或未勾選。 |
| 術語屬性 |
行項屬性Term 應以 PnYnMnD 或 PnW 的ISO-8601 期間格式加入。例如，P12M 或 P24M 表示年度期限。如果留空，將設定預設期限。 |
| 正文 |
如果您已 設定驗證規則，您匯入的值必須遵循規則，否則將無法匯入。 |
| 使用者（擁有者） |
要在匯入時指定記錄或活動的擁有者：
|
其他聯絡人電子郵件或公司網域
如果您匯入的聯絡人有一個以上的電子郵件地址，請在附加電子郵件地址欄中加入他們的次要電子郵件。如果您匯入的公司有一個以上的網域名稱，請在Additional domains (額外網 域名稱)欄中 加入其次要網域名稱。若要在單元格中包含多個電子郵件或網域，請使用分號分隔各值 (例如：email@email.com; emailtwo@email.com)。
如果您正在匯入以建立聯絡人或公司，則無法將新聯絡人的電子郵件或新公司的公司網域名 稱設定為另一記錄的現有附加電子郵件或網域。
空白儲存格
匯入工具會忽略試算表中的空白儲存格，因此在匯入新的屬性資料時，請將沒有屬性值的記錄儲存為空白儲存格。如果現有記錄在 HubSpot 中已有屬性值，則空白儲存格不會清除現有屬性值。若要大量清除現有的屬性值，您可以 手動編輯值 或使用「 編輯記錄 」 工作流程動作。交易合作者
如果您透過匯入將合作者加入交易，請包含交易合作者標題。對於每個單元格，您必須包含兩個或更多使用者，並以分號分隔 (例如：user1@example.com;user2@example.com)。產品期限和帳單頻率
如果匯入期限屬性值，您可以將期限列中的值格式化為以月為單位的數字（例如，10表示 10 個月）、PXM （其中 X 為月數）（例如，P6M，表示期限為 6 個月）或PXY（其中 X 為年數）（例如，P1Y，表示期限為 1 年）。
如果匯入帳單頻率屬性值，如果產品具有循環價格類型，請使用每月、每年或每季。如果產品是一次性價格，則單元格留空。
必要的屬性
視您匯入的物件或活動而定，以下屬性是建立記錄所需的，並且必須包含在檔案中作為列頭。如果您要更新記錄，則必須包含唯一的識別碼(例如：記錄 ID、電子郵件、公司網域名稱)。
雖然不是必需，但您可以為每個物件匯入其他屬性，包括自訂和預設屬性。請參閱聯絡人、公司、交易、票單、通話、電 子郵件、會議、備註和任務的預設屬性。您也可以在屬性設定中檢視所有屬性及其值。
- 聯絡人：至少名、姓或電子郵件中的一項。
- 公司： 姓名或公司網域名稱中至少一項。
請注意： 公司網域名稱屬性只接受頂層網域 (例如：.com、.edu) 以下的值。後面有字串的值 (例如：.edu/home) 會在匯入時自動移除。
- 交易：如果您要建立新的交易，請輸入交易名稱、管道和交易階段。
- Tickets (票單)： 如果您要建立新的票單，請輸入票單的名稱、管道 及票單狀態。
- 約會：約會開始。約會開始的格式應為日期時間屬性。
- 課程：課程名稱。
- 列表：名稱。
- 服務：名稱、管道和管道階段。
- 產品： 如果您要更新產品，記錄 ID或SKU。
- 訂單：Name（名稱）、Pipeline（管道）和Pipeline Stage（管道階段）。
- 購物車：名稱。
- 行列項目： 名稱、數量、價格， 以及相關交易的記錄 ID 或交易名稱。如果您也將行列項目與產品相關聯，請包含產品的 產品 ID ，這將在匯入時對應為行列項目屬性。
請注意：當匯入交易的明細項目時，匯入將不會更新交易金額。要更新關聯的交易金額，您可以手動編輯細列項目或在 HubSpot 中將細列項目與交易關聯。
- 通話： 通話備註。匯入新通話時，也建議包含活動日期。
- 電子郵件： 電子郵件正文和 電子郵件方向。
- 會議：會議描述、會議開始時間和會議結束時間。匯入新會議時，也建議包含活動日期。開始時間、結束時間和活動日期值的格式應為日期時間屬性。
- 附註：附註正文。
- 任務：任務標題和到期日。 到期日應以日期時間屬性格式化。
請注意：雖然並非必要，但建議在匯入新活動時包含活動日期，以指定活動發生的日期和時間。如果不包含此屬性，活動日期值會自動設定為匯入的日期和時間。
更新現有記錄或避免重複的要求
若要更新現有記錄和避免重複記錄，您的檔案必須包含每個物件的唯一識別符屬性。對於所有物件，您可以 匯出現有記錄 ，並 使用記錄 ID 作為唯一識別碼，或使用需要唯一值的自訂屬性。 對於聯絡人，您也可以使用電子郵件。對於公司，您也可以使用公司網域名稱。
如果您要匯入多個物件，並且包含 Record ID，建議區分檔案列標題，使 ID 與正確的物件相符 (例如，一列稱為 Record ID - 聯絡人，另一列稱為 Record ID - 公司)。
請注意： 如果您的檔案中包含電子郵件或公司網域名稱 ，則以下行為適用：
- 如果您使用自訂唯一值的屬性來重複聯絡人，Email屬性仍需要唯一值。
- 如果您使用自訂唯一值屬性來重複公司，則公司網域名稱屬性將不需要唯一值。這表示您可以匯入重複的公司網域名稱。如果您不希望多間公司使用相同的網域名稱，您應該在匯入前移除檔案中重複的網域，或改用公司網域名稱作為唯一識別碼。
- 對於在 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。
- 若要設定多個標籤來描述兩個記錄之間的關係，您可以在一個單元格中包含多個關聯標籤值，並以分號隔開（例如，經理；帳單聯絡人）。
- 如果您要在 多檔案匯入中匯入關聯標籤，您需要在同一個檔案中包含關聯標 籤欄和您要關聯的物件的唯一識別碼。
- 如果您要匯入成對的標籤：
- 對於跨物件關聯，只需在關聯標籤列中包含其中一個標籤。在匯入過程中，標籤會被指派給正確的物件。
- 對於同一物件關聯， 關聯 [唯一識別碼] 欄中 的記錄將接收在匯入過程中加入 或包含在檔案標籤欄中的標籤。行中的其他記錄將接收標籤對中的另一個標籤。
範例檔案
在匯入程序開始時，您可以產生一個範例檔案，其中包含所選物件和活動的所需屬性。如果您想查看更多包含附加屬性的範例，請參閱這篇文章的範例檔案。
