上次更新時間： 2025年11月20日
在將資料匯入 HubSpot 之前，請先檢視以下限制與要求。您亦可存取範例檔案或 產生範例檔案以協助您開始操作。
若需進一步瞭解匯入工具，請參閱本文。若檔案已準備就緒，請學習如何進行匯入。
技術要求與限制
所有匯入 HubSpot 的檔案必須：- 為 .csv、.xlsx 或 .xls 格式檔案。
- 僅含單一工作表。
- 包含標題列，其中每個欄位標題須對應於HubSpot的屬性。欄位標題可自由排列順序，不影響匯入作業。您可在匯入前確認是否已有預設屬性與 標題匹配 ，或建立自訂屬性。深入了解屬性要求。
- 列數需少於 1000 列。
- 若包含外語字元，請採用 UTF-8 編碼。
- 若您正在匯入 Excel 檔案：
- 資料量須低於 Excel工作表與工作簿的最大限制。
- 匯入日期與時間選擇器屬性時，相關儲存格須採用數字格式。
根據您的 HubSpot 訂閱方案，匯入工具另有技術限制。這些限制包含匯入檔案的大小與行數上限，以及每日可匯入的檔案數量與行數。
- 若您僅使用 HubSpot 免費版、Smart CRM 專業版或 企業版工具， 則可：
- 匯入檔案大小上限為 20MB。
- 每日最多可執行 50 次匯入作業。
- 每日最多匯入500,000行資料。若匯入檔案行數超過500,000行，將需數日才能完成處理。
- 若您的帳戶訂閱了入門版、專業版或企業版方案，您可：
- 匯入檔案大小上限為 512 MB。
- 每日完成最多 500 次匯入作業。
- 每日最多匯入 10,000,000 列資料，每檔檔案上限為 1,048,576 列。若透過匯入 API 操作，每日可處理高達 80,000,000 列資料。
這些限制適用於連續24小時週期，不會在特定時間重置。瞭解更多關於您的HubSpot訂閱及其限制的資訊。
格式化數值
在匯入檔案的每行中，您可為屬性欄位新增數值。數值格式取決於屬性欄位類型及匯入目標。
依據屬性欄位類型格式化值
根據屬性欄位類型，存在特定格式要求：
| 欄位類型 | 要求 |
| 日期選擇器 日期與時間選擇器 |
月份可為數字、三字母縮寫或完整名稱（10、OCT、Oct、OCTOBER、October），年份可為兩位數或四位數（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 預設枚舉屬性（例如生命週期階段、產業），值必須與內部值或英文標籤完全匹配。 |
| 檔案 |
|
| 多重核取方塊 |
匯入多個值時，請在每個值之間添加分號且不留空格（value 1;value 2）。此類屬性選項必須在匯入前預先建立。 若需新增或追加值，請在首個值前添加分號（;值 3;值 4）。此操作將追加值而非覆寫現有屬性值。 深入了解匯入多重核取方塊值。 |
| 數字 |
根據建立的數字屬性類型格式化值：
|
| 單選核取方塊 |
為單選核取方塊欄位建立欄位，並將每行值設定為：True或Yes將顯示為 HubSpot 中的「是」或「已勾選」；False 或 No 將顯示為 HubSpot 中的「否」或「未勾選」。 |
| 條款屬性 |
應以 ISO-8601 週期格式PnYnMnD 或 PnW 填寫項目屬性「期限」 。例如：年度期限應填寫 P12M 或 P24M。若留空，系統將設定預設期限。 |
| 文字 |
若已設定 驗證規則，匯入值必須符合規則要求，否則將無法匯入。 |
| 使用者（擁有者） |
若要在匯入過程中為記錄或活動指派擁有者：
|
額外聯絡電子郵件或公司網域
若匯入的聯絡人含多個電子郵件地址，請新增「其他電子郵件地址」欄位記錄次要郵件。若匯入的公司含多個網域名稱，請新增「其他網域」欄位記錄 次要網域。單一儲存格內若需列出多個郵件或網域，請以分號分隔值（例如：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），系統將於匯入時自動移除。
- 交易：若建立新交易，需提供交易名稱、銷售管道及交易階段。
- 工單：若 建立新工單，需填寫工單名稱、流程與 工單狀態。
- 預約：預約開始時間。預約開始時間應以日期時間屬性格式呈現。
- 課程：課程名稱。
- 房源：名稱。
- 服務項目：名稱、銷售管道及 銷售階段。
- 產品：若 更新產品，請提供記錄ID或SKU。
- 訂單：名稱、銷售管道及銷售階段。
- 購物車：名稱。
- 明細項目： 名稱、數量、價格，以及 關聯交易的記錄ID或 交易名稱。 若 同時將明細項目關聯至產品，請包含 產品ID， 該ID將於匯入時作為明細項目屬性進行映射。
請注意：匯入含交易的明細項目時，系統不會更新交易金額。若需更新關聯交易金額，可手動編輯明細項目，或於 HubSpot 中將明細項目與交易建立關聯。
- 通話： 通話備註。導入新通話時，建議同時包含活動日期。
- 電子郵件： 郵件正文與 郵件方向。
- 會議：會議描述、會議開始時間與會議結束時間。匯入新會議時，建議同時包含活動日期。開始時間、結束時間及活動日期值應格式化為日期時間屬性。
- 備註：備註內容。
- 任務：任務標題與 截止日期。 截止日期應格式化為日期時間屬性。
請注意：雖然非必要，但建議在匯入新活動時包含活動日期，以指定活動發生的時間點。若未包含此屬性，系統將自動將活動日期值設為匯入當下的日期與時間。
更新現有記錄或避免重複記錄之要求
為更新現有記錄並避免重複記錄，您的檔案必須為每個物件包含唯一識別符屬性。所有物件皆可 透過匯出現有記錄 並使用 記錄ID作為唯一識別符，或採用需具備唯一值的自訂屬性。 聯絡人可另採用電子郵件地址；企業則可選用公司網域名稱。
若您匯入多個物件且包含記錄 ID，建議區分檔案欄位標題以將 ID 與正確物件對應（例如：一欄命名為「記錄 ID - 聯絡人」，另一欄命名為「記錄 ID - 公司」）。
請注意： 若檔案包含 電子郵件或公司網域名稱 ，將適用以下行為 ：
- 若您使用自訂唯一值屬性來消除聯絡人重複，電子郵件屬性仍需保持唯一值。
- 若使用自訂唯一值屬性進行企業重複資料清除，則「公司網域名稱」屬性無需唯一值。這意味著您可匯入重複的公司網域。若不希望出現相同網域的多個企業，請在匯入前從檔案中移除重複網域，或改用「公司網域名稱」作為唯一識別碼。
- 對於已在 HubSpot 登錄備用電子郵件的現有聯絡人，可使用備用電子郵件作為唯一識別碼。若採用備用電子郵件且 檔案未包含 「記錄 ID」欄位，備用郵件將不會取代主要郵件。但若檔案同時包含備用郵件與記錄 ID 欄位，則備用郵件將取代主要郵件。
關聯記錄之要求
單一檔案匯入關聯資料
在單一檔案中，每行可關聯兩筆或以上記錄。請於同一行內包含關聯記錄及/或活動的相關資訊，並為每個物件添加唯一識別碼。若需將單一記錄關聯至多個活動或另一物件的記錄，請為每筆欲關聯的記錄，在多行中分別加入該記錄的唯一識別碼。
例如：盧克·丹尼斯在盧克餐廳擔任經理，同時是蜻蜓旅館的承包商。若要將他與兩家公司關聯，需為盧克·丹尼斯建立兩行資料，每行包含電子郵件（或記錄ID）欄位，以及對應公司的網域名稱（或記錄ID）欄位。
請注意：若 未包含唯一識別碼（例如電子郵件、公司網域名稱、記錄ID），匯入時將產生重複記錄而非建立關聯。
若需匯入相同物件關聯，則有額外要求。
請將關聯資料分置於兩個檔案匯入
欲關聯兩個檔案中兩個物件的記錄，請使用共同欄位連結各檔案中的記錄。您可參閱範例檔案以獲取更多匯入與關聯記錄的協助。
相同物件關聯
您可匯入單一檔案以批次關聯相同物件的記錄。匯入過程中需勾選核取方塊，方能包含相同物件關聯。
設定檔案時，請將關聯記錄的資訊置於同一行，並為每筆記錄包含唯一識別碼。以下額外要求專為相同物件匯入設計：
- 在匯入前，記錄對中的至少一項記錄必須已存在於 HubSpot 中。例如：您可以匯入新聯絡人並與現有聯絡人建立關聯，但無法同時建立並關聯兩個新聯絡人。
- 關聯現有聯絡人/公司時，僅能使用主要電子郵件/公司網域作為唯一識別碼，次要電子郵件或網域不被支援。
- 若需將多筆記錄關聯至單一記錄，請於同一儲存格內以分號分隔各記錄的唯一識別碼值（例如：luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com）。
在下方的範例檔案中，Rory 和 Jackson 是透過電子郵件值作為唯一識別碼，與現有聯絡人建立關聯的新聯絡人，並被賦予獨特標籤。Sookie 則是現有聯絡人，與兩個具有相同標籤的現有聯絡人建立關聯。首行中的關聯標籤屬於標籤對，這意味著匯入完成後，關聯記錄將擁有「Parent」 標籤，而 Rory 則會擁有配對標籤「Child」。
父/子關聯
若需透過匯入建立子公司與母公司關聯，請參閱匯入子公司相關說明。
自訂關聯標籤
需要訂閱 使用自訂關聯標籤需具備專業版或 企業版訂閱資格。
若要匯入關聯標籤，請包含 「關聯標籤」欄位 。僅當您需要添加標籤來描述關聯時才需新增此欄位。若無需標記關聯，則此欄位非必要。
- 匯入前必須先在 HubSpot 中建立關聯標籤。
- 若要將公司關聯設為主要關聯，請在該行的關聯標籤欄位中 填入值「主要」。
- 若需設定多個標籤描述兩筆記錄間的關係，可在單一儲存格內輸入多個關聯標籤值，並以分號分隔（例如：經理; 帳務聯絡人）。
- 若透過 多檔案匯入方式導入關聯標籤，需在同一檔案中包含關聯標籤欄位及所關聯物件的唯一識別碼。
- 若您正在匯入配對標籤：
- 跨物件關聯時，僅需在關聯標籤欄位填入其中一個標籤。系統將於匯入過程中將標籤分配至正確物件。
- 若為同一物件關聯， 關聯[唯一識別碼]欄位的 記錄將接收匯入過程中新增或 文件標籤欄位包含的標籤；該行另一記錄則接收配對標籤中的另一標籤。
範例檔案
在匯入流程開始時，您可針對選取的物件與活動生成具備必要屬性的範例檔案。若需檢視更多含進階屬性的範例，請參閱附有範例檔案的這篇文章。
