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

HubSpot 與 Salesforce 的整合可能發生同步錯誤，導致資料無法同步。您可在 Salesforce 整合設定中識別並解決這些同步錯誤。

調整 API 呼叫限制

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的settings「設定圖示」。在左側邊欄選單中，前往「整合功能」>「已連結的應用程式」。
2. 在已連接應用程式清單中，點擊Salesforce。
3. 導覽至「同步狀態」標籤頁。
4. 在「API呼叫使用」區段中 ，查看過去24小時內已使用的API呼叫次數。「Salesforce限制數值」代表根據您的Salesforce設定可執行的API呼叫次數上限。若需調整分配給HubSpot的呼叫配額，請編輯「分配給HubSpot」欄位。

檢視 Salesforce 同步錯誤

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的settings「設定圖示」。在左側邊欄選單中，前往「整合功能」>「已連結的應用程式」。
2. 在已連接應用程式清單中，點擊Salesforce。
3. 導覽至「同步狀態」標籤頁。
4. 在「同步錯誤」區塊中，檢視各錯誤類型的卡片，包含當前錯誤數量與受影響記錄數。點擊錯誤類型卡片即可在右側面板查看詳細錯誤資訊。深入了解各錯誤類型及解決建議。

5. 若需檢視錯誤詳細資訊，請點擊「錯誤類型」欄位的 「info 」資訊圖示 。
6. 若需針對個別記錄採取行動，請點擊 「 受影響記錄」 欄位的 [#] 記錄數， 再點擊「動作」＞「建立 HubSpot 記錄的臨時檢視」以建立 受影響記錄的篩選檢視。
7. 解決錯誤後，請返回錯誤清單。勾選已解決錯誤左側的核取方塊，然後點擊重新同步。
8. 若需匯出錯誤清單，請點擊錯誤清單左上角的「匯出錯誤（CSV）」 。

Salesforce 同步錯誤類型

關聯性

關聯錯誤範例

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

錯誤訊息解析

記錄無法同步的原因在於：它們關聯的 Salesforce 帳戶尚未同步至 HubSpot 企業，或關聯的記錄已觸及 HubSpot 的記錄關聯上限。

錯誤解決方法

若要解決「關聯限制已達上限 」錯誤 ，可移除部分關聯記錄，或將其關聯至其他 Salesforce 記錄，再繼續執行同步。

若要解決「等待帳戶同步」錯誤 ，建議執行Salesforce帳戶匯入作業。

自訂程式碼

自訂程式碼錯誤範例

• Salesforce 自動化
• 聯絡人 ID 缺失
• Salesforce 自訂欄位驗證規則
• Salesforce 流程

錯誤訊息解析

記錄無法同步是由於 Salesforce 帳戶中的自動化流程、流程或驗證規則引發的問題所致。

錯誤解決方法

重複記錄

重複記錄錯誤範例

• 電子郵件地址已被使用
• Salesforce 重複規則

錯誤訊息說明

Salesforce 的潛在客戶或聯絡人無法同步至 HubSpot，原因可能是該電子郵件地址已在 HubSpot 聯絡人記錄中存在，或受Salesforce 中的重複資料排除規則限制。

解決錯誤的方法

若要解決「電子郵件已存在」錯誤，請從現有 HubSpot 聯絡人記錄中移除該電子郵件地址。

若要解決Salesforce 重複規則錯誤 ，建議 檢查Salesforce 中設定的重複資料排除匹配規則。

權限

權限錯誤範例

• 權限不足或缺少 Salesforce 記錄
• Salesforce 欄位權限
• Salesforce 存取權限不足

錯誤訊息解析

由於連結使用者無權存取 Salesforce 中的必要欄位或物件，HubSpot 中的變更無法同步至 Salesforce。

錯誤解決方法

多數情況下，「權限不足或缺少 Salesforce 記錄」錯誤 發生於整合嘗試以錯誤值更新 Salesforce 欄位，或建立不正確關聯時。

解決Salesforce 欄位權限錯誤的方法 ：請確認 Salesforce 整合使用者具備該欄位的讀取與編輯權限。

當 Salesforce 整合用戶因其在 Salesforce 中的權限限制而無法執行操作時，將觸發「Salesforce 存取權限不足」錯誤 。建議您檢查 Salesforce 中的整合用戶權限設定。

下拉式選單

下拉清單錯誤範例

• Salesforce 下拉選單選項遺漏
• 州/省份值不匹配
• 選項不匹配
• Salesforce 擁有者狀態為非活動
• 受限的下拉清單值
• 機會階段已停用
• Salesforce 擁有者未同步
• 選項限制超出
• 預設銷售流程不可用
• 機會階段缺失或無效

錯誤含義說明

記錄無法同步是由於 HubSpot 與 Salesforce 中的下拉清單欄位值存在差異所致。此情況可能發生於：某系統的下拉清單值與另一系統的現有值不符、下拉清單已達值數限制，或傳遞的值無效。

錯誤解決方法

為解決「 州/省份值不匹配」錯誤，建議確認以下條件是否滿足：

• HubSpot 中「國家」屬性選項的內部值必須與 Salesforce州/省份及國家/地區下拉清單設定中的現有國家選項相符。
• 該州值必須作為 Salesforce 記錄國家值的可用州/省選項 存在。此外，HubSpot 中「州」屬性選項的內部值必須與 Salesforce 中的現有州選項相符。

若要解決選項不符錯誤，建議更新 Salesforce 欄位選項的內部/API 名稱，使其與 HubSpot 屬性選項的內部值相符。

解決「Salesforce 擁有者非活躍狀態」錯誤時，請將 HubSpot 記錄重新指派給 Salesforce 中的活躍使用者。

當 Salesforce 欄位啟用「限制下拉清單至值集定義值」設定時 ，將觸發 「受限下拉清單 值」錯誤 。若此設定在 Salesforce 中啟用，則從 HubSpot 同步至 Salesforce 的值必須存在於 Salesforce 下拉清單選項中。建議您關閉 Salesforce中的「限制下拉清單至值集定義值」設定，以便任何值皆可從 HubSpot 同步至 Salesforce。

當 Salesforce 中的商機處於非活動 階段 時嘗試同步至 HubSpot，將觸發 「非活動 商機階段」錯誤 。解決此問題需在 Salesforce 中將商機階段設為「活動」狀態，或將商機移至活動階段。

若要解決「Salesforce 擁有者未同步」錯誤，請確保 Salesforce 使用者的「使用者類型」設定為「標準」、「權限夥伴」或「訪客」。

解決「選項限制超出」錯誤時，建議刪除團隊未使用的 HubSpot 與 Salesforce 多餘屬性選項。此外，請確保所有映射屬性皆具備對應的欄位類型。

多數情況下，「預設銷售流程不可用 」錯誤 發生於 Salesforce 機會嘗試同步至 HubSpot 時缺少記錄類型。若您已在 Salesforce 啟用記錄類型但未使用，或存在未設定記錄類型的 Salesforce 機會，建議您與 Salesforce 合作停用所有記錄類型或建立新記錄類型。

為解決「商機階段缺失或無效」錯誤，請確認 Salesforce 商機階段值存在於 HubSpot 銷售管道中。

屬性對應

屬性對應錯誤範例

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

錯誤含義說明

記錄無法同步是因 HubSpot 屬性與 Salesforce 欄位間的對應存在差異所致。這可能表示屬性與欄位類型不相容、屬性或欄位已不存在，或需建立 Salesforce 參照欄位對應關係。

錯誤解決方法

解決類型不符錯誤時，請確保 HubSpot 屬性類型與 Salesforce 欄位類型相容。深入了解可同步至 Salesforce 的 HubSpot 屬性欄位類型。

當 HubSpot 嘗試將非現有 Salesforce ID 的值同步至 Salesforce 參考/查詢欄位時，將觸發「缺少 Salesforce ID」錯誤。

若要解決無效 Salesforce ID錯誤，建議檢查您在 Salesforce 中設定的自訂驗證規則。

屬性值

屬性值錯誤範例

• 字串過長
• 電子郵件無效
• 缺少必需的國家/地區
• 無效值
• 所有者指派
• 受限唯一值
• 缺少必需值

錯誤訊息解析

記錄因包含無效屬性值而無法在 HubSpot 與 Salesforce 之間同步。此類錯誤通常需手動更新受影響記錄以修正問題。

錯誤解決方法

若要解決「字串過長」錯誤，請縮短 Salesforce 或 HubSpot 中的欄位值，或提高 Salesforce 欄位的字元限制。

解決「電子郵件無效」錯誤 ：請更新嘗試同步至 HubSpot 的 Salesforce 記錄中的電子郵件格式。

解決「缺少必填國家/地區」錯誤時，建議確認以下要求是否符合：

• HubSpot 中「國家」屬性選項的內部值必須與 Salesforce 中「州/省」及「國家/地區」下拉清單設定中的現有國家選項相符。
• 該州值必須作為 Salesforce 中記錄國家值的可用州/省選項 存在。此外，HubSpot 中State屬性選項的內部值必須與 Salesforce 中現有的State選項相符。

解決「無效值」錯誤時，建議更新 Salesforce 記錄的屬性值以符合 HubSpot 的屬性值要求。

多數情況下，「擁有者指派錯誤 」發生於 HubSpot 活動同步至 Salesforce 作為 Salesforce 任務時，HubSpot 嘗試將任務指派給 Salesforce 佇列擁有者。

為解決「受限唯一值錯誤」，建議檢查您在 Salesforce 中設定的重複資料排除匹配規則。

若要解決「缺少必填值」錯誤，請為任何在 HubSpot 中標記為必填的屬性，在 Salesforce 記錄中新增對應值。

其他

記錄因未知錯誤未同步。請聯繫 HubSpot 支援團隊以獲取進一步協助。

請注意：每次最多可批次重新同步 100 筆 Salesforce 錯誤。若需同步超過 100 筆錯誤，請從 Salesforce匯入記錄或 更新已映射的屬性。

設定同步錯誤通知

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的settings「設定圖示」。在左側邊欄選單中，前往「整合功能」>「已連結的應用程式」。
2. 在已連接應用程式清單中，點擊Salesforce。
3. 導覽至「同步狀態」標籤頁。
4. 在「同步錯誤」區段下，點擊「管理通知」。
5. 於對話方塊中，開啟「啟用通知」開關。
6. 選取「立即」、「每日」或「每週」旁的單選按鈕，設定通知頻率。
7. 點擊儲存。