知識庫

管理 Salesforce 整合 API 呼叫和同步錯誤

作者:HubSpot Support | Nov 21, 2022 12:49:27 PM

HubSpot-Salesforce 整合可能會遇到同步錯誤,導致資料無法同步。您可以在 Salesforce 整合設定中找出並解決這些同步錯誤。

調整 API 呼叫限制

  • 在連線的應用程式清單中,按一下Salesforce
  • Sync Health (同步健康狀況) 標籤的API call use (使用 API 通話 ) 部分,檢視過去 24 小時內使用的 API 通話數量。受 Salesforce 限制的數字是您根據 Salesforce 設定可以進行的 API 通話數量。要調整可分配給 HubSpot 的呼叫數量,請編輯Allocated to HubSpot欄位。

檢視 Salesforce 同步錯誤

  • 在連接的應用程式清單中,按一下Salesforce
  • Sync Health索引標籤的Sync errors 下,檢視每個錯誤類型的卡片,以及目前錯誤和受影響記錄的數量。按一下錯誤類型卡片,以檢視右側面板中的錯誤詳細資訊。進一步瞭解每種錯誤類型和解決建議

  • 若要檢視錯誤的詳細資訊,請按一下「錯誤類型 」欄中的info 資訊圖示
  • 若要對個別記錄採取行動,請按一下「受影響記錄」欄中的 [#] 記錄 ,然後按一下「行動>建立 HubSpot 記錄的臨時檢視 」,以建立受影響記錄的篩選檢視。
  • 解決錯誤後,返回錯誤清單。選取任何已解決錯誤左側的核取方塊,然後按一下重新同步
  • 若要匯出錯誤,請按一下錯誤清單左上方的匯出錯誤 (CSV)


Salesforce 同步錯誤類型

關聯

關聯錯誤的範例

  • 達到關聯限制
  • 等待帳戶同步

錯誤的意思

記錄未同步的原因是它們與尚未同步到 HubSpot Companies 的 Salesforce 帳戶相關聯,或者它們與已達到 HubSpot 記錄關聯限制的記錄相關聯。

如何解決錯誤

要解決已達到關聯限制的 錯誤,您可以移除一些關聯記錄,或將它們與不同的 Salesforce 記錄關聯,然後繼續同步。

要解決Waiting for account to sync 錯誤 ,建議您執行匯入 Salesforce帳戶

自訂程式碼

自訂程式碼錯誤的範例

  • 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 中執行動作,則會發生 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 中為欄位開啟了 "Restrict picklist to the values defined in the value setsetting"(「限制選項 列表值 」)設定,就會發生 "Restricted picklist value "(「限制選項列表值」錯誤 。當這個設定在 Salesforce 中開啟時,您嘗試從 HubSpot 同步到 Salesforce 的值必須作為選項存在於 Salesforce 挑選清單中。建議您關閉「限制篩選列表為 Salesforce 中值設置中定義的值」,這樣任何值都可以從 HubSpot 同步到 Salesforce。

當具有非活動機會 階段的 Salesforce機會 嘗試同步到 HubSpot 時,會發生非活動機會階段錯誤 。要解決此錯誤,請將 Salesforce 中的機會階段變更為活動,或將機會移至活動階段。

要解决Salesforce 所有者未同步错误,请确保 Salesforce 用户在 Salesforce 中将用户类型设置为标准Power PartnerGuest

要解決超出選項限制的錯誤,建議您在 HubSpot 和 Salesforce 中刪除團隊不使用的額外屬性選項。此外,確保所有映射的屬性都有對應的欄位類型。

在大多數情況下,預設銷售流程不可用 的錯誤發生於 Salesforce 機會嘗試同步到 HubSpot 時遺失了記錄類型。如果您在 Salesforce 中開啟記錄類型,但您沒有使用它們,或者 Salesforce 商機沒有記錄類型,建議您與 Salesforce 合作停用所有記錄類型或創建一個新的記錄 類型

要解決缺失或無效機會階段錯誤,請確保 Salesforce 機會階段值存在於 HubSpot 管道中。

屬性對應

屬性對應錯誤範例

  • 類型不匹配
  • 缺少 Salesforce ID
  • 無效的 Salesforce ID

錯誤的意思

由於 HubSpot 屬性和 Salesforce 欄位之間的對應存在差異,因此記錄無法同步。這可能表示屬性和欄位類型不相容、屬性或欄位不再存在,或需要建立 Salesforce 參考欄位對應。

如何解決錯誤

要解決類型不匹配錯誤,請確保 HubSpot 中的屬性類型與 Salesforce 中的欄位類型相容。進一步瞭解可同步至 Salesforce 的 HubSpot 屬性欄位類型

當 HubSpot 嘗試同步一個非現有 Salesforce ID 的值到 Salesforce 中的參考/查詢欄位時,會發生Missing SalesforceID 錯誤。

要解決Invalid Salesforce ID錯誤,建議您檢查在 Salesforce 中設定的自訂驗證規則

屬性值

屬性值錯誤範例

  • 字串太長
  • 無效電子郵件
  • 缺少必填國家/地區
  • 無效值
  • 業主指派
  • 限制唯一值
  • 缺少必填值

錯誤的意義

記錄無法在 HubSpot 和 Salesforce 之間同步,因為其中包含的屬性值無效。這些錯誤通常需要更新個別受影響的記錄以修正錯誤。

如何解決錯誤

要解決字串太長錯誤,請縮短 Salesforce 或 HubSpot 中的欄位值,或增加 Salesforce 中欄位的字元限制。

要解決無效電子郵件 錯誤,請更新嘗試同步到 HubSpot 的 Salesforce 記錄上的電子郵件地址格式。

要解決缺少所需國家/地區錯誤,建議您檢查是否滿足以下要求:

  • HubSpot 中Country屬性選項的內部值必須與 Salesforce 中State and Country/Territory picklist 設定中的現有Country 選項相符。
  • 在 Salesforce 中,State值必须作为记录的Country值的可用州/省 选项存在。此外,HubSpot 中State屬性選項的內部值必須與 Salesforce 中現有的State選項相符。

要解決無效值錯誤,建議您更新 Salesforce 記錄上的屬性值,以符合 HubSpot 對屬性值的要求。

在大多數情況下,當 HubSpot 活動作為 Salesforce 任務同步到 Salesforce,且 HubSpot 嘗試將任務指派給 Salesforce 佇列擁有者 時,會發生擁有者 指派錯誤。

要解決限制唯一值錯誤,建議您檢查在 Salesforce 中設定的重複資料刪除的匹配規則

要解決缺少必填值錯誤,請為在 HubSpot 中標記為必填的任何屬性在 Salesforce 記錄中添加值。

其他

由於未知錯誤,記錄無法同步。請聯絡 HubSpot 支援以取得有關這些錯誤的進一步協助。

請注意:一次可以大量重新同步 100 個 Salesforce 錯誤。若要同步超過 100 個錯誤,請從 Salesforce匯入記錄更新映射的屬性

設定同步錯誤通知

  • 在連接的應用程式清單中,按一下Salesforce
  • 按一下同步健康索引標籤。
  • 同步錯誤下,按一下管理通知
  • 在對話方塊中,切換開啟通知開關
  • 選取Instantly(立即)Daily(每日)或Weekly(每週)旁邊的單選按鈕,以設定通知的頻率。
  • 按一下儲存