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

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

調整 API 呼叫限制

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

檢視 Salesforce 同步錯誤

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「設定圖示」。在左側邊欄選單中，前往「整合功能」>「已連結的應用程式」。
2. 在已連線的應用程式清單中，點選Salesforce。 
3. 導航至「資料同步」分頁。 
4. 在「同步狀態」分頁的「同步錯誤 」區段中，查看各錯誤類型的卡片，其中包含當前錯誤數量及受影響的記錄。點擊某個錯誤類型的卡片，即可在右側面板中查看錯誤詳情。進一步了解各錯誤類型及解決方案建議。 

5. 若要查看錯誤的更多詳細資訊，請點擊「錯誤類型 」欄位 中的資訊圖示 。
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 中設定的去重匹配規則。 接著，在嘗試於 HubSpot 重新同步之前，請 合併、更新或刪除任何衝突的 Salesforce 記錄，或調整 Salesforce 中的去重規則。

權限

權限錯誤範例

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

錯誤的含義

由於已連線的使用者無權存取 Salesforce 中的必要欄位或物件，因此在 HubSpot 所做的變更無法同步至 Salesforce。

如何解決錯誤

在大多數情況下，當整合嘗試以不正確的值更新 Salesforce 欄位，或建立不正確的關聯時，便會發生「存取權限不足」或「缺少 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 使用者在 Salesforce 中的「使用者類型」已設定為「標準」、「Power Partner」或「訪客」。 

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

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

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

針對 Salesforce 任務欄位錯誤，請將 Salesforce 中的「任務優先級」、「狀態」或「類型」值與 HubSpot 中的對應任務屬性選項進行比對。「任務優先級」僅支援「高」、「中」、「低」及「無」四種值。至於「狀態」和「類型」，請將 Salesforce 中的值更新為與 HubSpot 可用選項完全一致，或在 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 中「州」屬性選項的內部值必須與 Salesforce 中現有的「州」選項相符。 

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

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

若要解決「受限唯一值」錯誤，建議您檢查在 Salesforce 中設定的去重匹配規則。 

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

其他

由於發生未知錯誤，記錄無法同步。請聯絡 HubSpot 支援團隊以獲取進一步協助。

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

設定同步錯誤通知

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