管理 Salesforce 整合 API 呼叫和同步錯誤
上次更新時間: 2025年5月27日
可搭配下列任何訂閱使用,除非另有註明:
|
|
|
|
|
HubSpot-Salesforce 整合可能會遇到同步錯誤,導致資料無法同步。您可以在 Salesforce 整合設定中找出並解決這些同步錯誤。
調整 API 通話限制
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。在左側邊欄選單中,前往「整合功能」>「已連結的應用程式」。
- 在連接的應用程式清單中,按一下Salesforce。
- 在Sync Health (同步健康狀況) 標籤的API call use (使用 API 通話 ) 部分中,檢視您在過去 24 小時內使用的 API 通話數量。受 Salesforce 限制的數字是您根據 Salesforce 設定可以進行的 API 通話數量。若要調整可分配給 HubSpot 的呼叫數量,請編輯Allocated to HubSpot欄位。
檢視 Salesforce 同步錯誤
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。在左側邊欄選單中,前往「整合功能」>「已連結的應用程式」。
- 在連接的應用程式清單中,按一下Salesforce。
- 在Sync Health (同步健康狀況) 索引標籤的Sync errors (同步錯誤) 下方,檢視每個錯誤類型的卡片,以及目前錯誤和受影響記錄的數量。按一下錯誤類型卡片,以檢視右側面板中的錯誤詳細資訊。進一步瞭解每種錯誤類型和解決建議。
- 若要檢視錯誤的更多詳細資訊,請按一下錯誤類型 欄中的info info 圖示 。
- 若要對個別記錄採取行動,請按一下「受影響記錄」欄中的 [#] 記錄 ,然後按一下「行動>建立 HubSpot 記錄的臨時檢視 」,以建立受影響記錄的篩選檢視。
- 解決錯誤後,返回錯誤清單。選取任何已解決錯誤左側的核取方塊,然後按一下重新同步。
- 若要匯出錯誤,請按一下錯誤清單左上方的匯出錯誤 (CSV) 。

Salesforce 同步錯誤類型
協會
關聯錯誤的範例
- 達到關聯限制
- 等待帳戶同步
錯誤的意義
記錄未同步的原因是它們與尚未同步至 HubSpot Companies 的 Salesforce 帳戶相關聯,或與已達 HubSpot 記錄關聯上限的記錄相關聯。
如何解決錯誤
若要解決「已達到關聯限制 」錯誤,您可以移除某些關聯記錄,或將它們與不同的 Salesforce 記錄關聯,然後繼續同步。
若要解決Waiting for account to sync 錯誤 ,建議您執行SalesforceAccounts 匯入。
自訂程式碼
自訂程式碼錯誤的範例
- Salesforce 自動化
- 遺失聯絡人 ID
- Salesforce 自訂欄位驗證規則
- Salesforce 流程
錯誤的意義
由於 Salesforce 帳戶中的自動化、流程或驗證規則所導致的問題,導致記錄無法同步。
如何解決錯誤
由於這些錯誤源自 Salesforce,因此建議您與 Salesforce 管理員合作,解決 Salesforce 自訂程式碼中的問題。
重複
重複錯誤的範例
- 電子郵件已在使用中
- Salesforce 重複規則
錯誤的意義
由於電子郵件地址已存在於 HubSpot 聯絡人記錄中,或由於Salesforce 中的重複刪除規則,Salesforce 線索或聯絡人無法同步至 HubSpot。
如何解決錯誤
若要解決電子郵件已在使用中的錯誤,請從現有的 HubSpot 聯絡人中移除電子郵件地址。
若要解決Salesforce 重複規則 錯誤, 建議您檢查Salesforce 中設定的重複資料刪除的匹配規則。
權限
權限錯誤的範例
- 存取權限不足或遺失 Salesforce 記錄
- Salesforce 欄位權限
- Salesforce 存取權限不足
錯誤的意義
在 HubSpot 中作出的變更無法同步到 Salesforce,因為連接的使用者無法存取 Salesforce 中必要的欄位或物件。
如何解決錯誤
在大多數情況下,當整合嘗試以不正確的值更新 Salesforce 欄位或建立不正確的關聯時,會發生存取不足或遺失 Salesforce記錄的 錯誤。
若要解決Salesforce 欄位權限 錯誤,請 確保 Salesforce 整合使用者對 Salesforce 中的欄位擁有「讀取」和「編輯」權限。
當 Salesforce 整合使用者因其在 Salesforce 中的使用者權限而無法在 Salesforce 中執行動作時,會發生Insufficient Salesforce access 錯誤。建議您檢查 Salesforce 中的 Salesforce 整合使用者權限。
選取清單
選取清單錯誤範例
- 遺失 Salesforce 挑選清單選項
- 狀態或國家值不匹配
- 選項不匹配
- 不活動的 Salesforce 擁有者
- 受限制的選項清單值
- 不活動的機會階段
- Salesforce 所有者未同步
- 超出選項限制
- 預設銷售流程不可用
- 機會階段遺失或無效
錯誤的意義
由於 HubSpot 和 Salesforce 中的 Picklist 欄位值不一致,導致記錄無法同步。當一個系統中的揀選清單值與另一個系統中的任何當前值不匹配、揀選清單已達到值限制或傳輸的值無效時,就可能發生這種情況。
如何解決錯誤
要解決 Mismatched state or country value錯誤,建議您檢查是否符合下列要求:
- HubSpot 中Country屬性選項的內部值必須與 Salesforce 中State and Country/Territory picklist 設定中的現有Country 選項相符。
- 在 Salesforce 中,State值必須作為記錄的Country值的Available State/Province 選項存在。此外,HubSpot 中State屬性選項的內部值必須與 Salesforce 中現有的State選項相符。
要解決選項不匹配的錯誤,建議您更新 Salesforce 欄位選項的內部/API 名稱,以匹配 HubSpot 中的屬性選項內部值。
要解決不活動的 Salesforce 擁有者錯誤,請將 HubSpot 記錄重新指定給 Salesforce 中的活動使用者。
當您在 Salesforce 中為欄位開啟了限制揀選清單到值設置中定義的值時,會發生限制揀選清單值 錯誤 。當這個設定在 Salesforce 中開啟時,您嘗試從 HubSpot 同步到 Salesforce 的值必須作為選項存在於 Salesforce 挑選清單中。建議您關閉「限制選項清單 」至 Salesforce 中值設置中定義的值,這樣任何值都可以從 HubSpot 同步到 Salesforce。
如果 Salesforce 中的商機階段不活躍,並嘗試同步到 HubSpot,則會發生商機階段不活躍錯誤。要解决此错误,请将 Salesforce 中的机会阶段更改为活动状态,或将机会移动到活动状态。
若要解決Salesforce 擁有者未同步錯誤,請確保 Salesforce使用者在 Salesforce 中的使用者類型設定為Standard、Power Partner 或Guest。
要解決超出選項限制的錯誤,建議您在 HubSpot 和 Salesforce 中刪除團隊不使用的額外屬性選項。此外,確保所有映射的屬性都有對應的欄位類型。
在大多數情況下,預設銷售流程不可用 的錯誤發生於 Salesforce 商機嘗試同步到 HubSpot 時缺少記錄類型。如果您在 Salesforce 中開啟了記錄類型,但您沒有使用它們,或者 Salesforce 商機沒有記錄類型,建議您與 Salesforce 合作停用所有記錄類型或創建一個新的記錄 類型。
要解決缺失或無效機會階段錯誤,請確保 Salesforce 機會階段值存在於 HubSpot 管道中。
屬性對應
屬性對應錯誤範例
- 類型不匹配
- 遺失 Salesforce ID
- 無效的 Salesforce ID
錯誤的意義
記錄不同步是因為 HubSpot 屬性和 Salesforce 欄位之間的對應不一致。這可能意味著屬性和欄位類型不相容、屬性或欄位不再存在,或需要建立 Salesforce 參考欄位對應。
如何解決錯誤
要解決類型不匹配錯誤,請確保 HubSpot 中的屬性類型與 Salesforce 中的欄位類型相容。進一步瞭解可同步至 Salesforce 的 HubSpot 屬性欄位類型。
當 HubSpot 嘗試同步一個非現有 Salesforce ID 的值到 Salesforce 中的參考/查詢欄位時,會發生MissingSalesforce ID 錯誤。
要解決Invalid Salesforce ID錯誤,建議您檢查在 Salesforce 中設定的自訂驗證規則。
財產價值
財產價值錯誤範例
- 字串太長
- 無效電子郵件
- 缺少所需的國家
- 無效值
- 業主指定
- 限制唯一值
- 缺少必填值
錯誤的意義
記錄無法在 HubSpot 和 Salesforce 之間同步,因為它們包含無效的屬性值。這些錯誤通常需要更新受影響的個別記錄以修正錯誤。
如何解決錯誤
若要解決字串太長的錯誤,請縮短 Salesforce 或 HubSpot 中的欄位值,或增加 Salesforce 中欄位的字元限制。
要解決無效電子郵件 錯誤,請更新嘗試同步到 HubSpot 的 Salesforce 記錄上的電子郵件地址格式。
要解決Missing required country錯誤,建議您檢查是否符合下列要求:
- HubSpot 中Country屬性選項的內部值必須與 Salesforce 中State and Country/Territory picklist 設定中的現有Country 選項相符。
- 在 Salesforce 中,State值必須作為記錄的Country值的Available State/Province 選項存在。此外,HubSpot 中State屬性選項的內部值必須與 Salesforce 中現有的State選項相符。
要解決Invalid value 錯誤,建議您更新 Salesforce 記錄上的屬性值,以符合 HubSpot 對於屬性值的要求。
在大多數情況下,當 HubSpot 活動作為 Salesforce 任務同步到 Salesforce,且 HubSpot 嘗試將任務指派給 Salesforce 佇列擁有者 時,會發生擁有者 指派錯誤。
若要解決限制唯一值錯誤,建議您檢查在 Salesforce 中設定的重複資料刪除的匹配規則。
要解決缺失必填值錯誤,請為任何在 HubSpot 中標記為必填的屬性在 Salesforce 記錄中新增一個值。
其他
由於未知錯誤,記錄無法同步。請聯絡 HubSpot 支援以取得這些錯誤的進一步協助。
請注意:一次可以大量重新同步 100 個 Salesforce 錯誤。若要同步超過 100 個錯誤,請從 Salesforce匯入記錄或更新映射的屬性。
設定同步錯誤通知
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。在左側邊欄選單中,前往「整合功能」>「已連結的應用程式」。
- 在連接的應用程式清單中,按一下Salesforce。
- 按一下Sync Health (同步處理狀況) 索引標籤。
- 在Sync errors(同步錯誤)下,按一下Manage notifications(管理通知)。
- 在對話方塊中,切換開啟通知開關。
- 選取Instantly(立即)、Daily(每日)或Weekly(每週)旁邊的單選按鈕,以設定通知的頻率。
- 按一下儲存。