ข้ามไปที่เนื้อหา
โปรดทราบ:: บทความนี้จัดทำขึ้นเพื่อความสะดวกของคุณ ได้รับการแปลโดยอัตโนมัติโดยใช้ซอฟต์แวร์การแปลและอาจไม่ได้รับการพิสูจน์อักษร บทความฉบับภาษาอังกฤษนี้ควรถือเป็นฉบับทางการที่คุณสามารถค้นหาข้อมูลล่าสุดได้มากที่สุด คุณสามารถเข้าถึงได้ที่นี่

จัดการการเรียก API ของการผสานรวม Salesforce และข้อผิดพลาดในการซิงค์

อัปเดตล่าสุด: 27 พฤษภาคม 2025

สามารถใช้ได้กับการสมัครใช้บริการใดๆ ต่อไปนี้ ยกเว้นที่ระบุไว้:

การตลาด Hub   Professional , Enterprise
การขาย Hub   Professional , Enterprise
Service Hub   Professional , Enterprise
Operations Hub   Professional , Enterprise
เนื้อหา Hub   Professional , Enterprise

การผสานรวม HubSpot-Salesforce อาจพบข้อผิดพลาดในการซิงค์ซึ่งป้องกันไม่ให้ข้อมูลซิงค์คุณสามารถระบุและแก้ไขข้อผิดพลาดในการซิงค์เหล่านี้ได้ในการตั้งค่าการผสานรวม Salesforce ของคุณ

ปรับขีดจำกัดการเรียก API

  • ในบัญชี HubSpot ของคุณ คลิกsettings ไอคอนการตั้งค่าในแถบการนำทางด้านบน ในเมนูแถบด้านข้างทางซ้าย ไปที่การผสานการทำงาน > แอปที่เชื่อมต่อ
  • ในรายการแอปที่เชื่อมต่อให้คลิก Salesforce 
  • ในแท็บสถานะการซิงค์ในส่วนการใช้การเรียก API ให้ดูจำนวนการเรียก API ที่คุณใช้ในช่วง 24 ชั่วโมงที่ผ่านมา หมายเลขจำกัดโดย Salesforce คือจำนวนการโทร API ที่คุณสามารถทำได้ตามการตั้งค่า Salesforce ของคุณ หากต้องการปรับจำนวนสายที่สามารถจัดสรรให้กับ HubSpot ได้ให้แก้ไขช่องจัดสรรให้กับ HubSpot  

sync-health-api-call-use

ดูข้อผิดพลาดในการซิงค์ Salesforce

  • ในบัญชี HubSpot ของคุณ คลิกsettings ไอคอนการตั้งค่าในแถบการนำทางด้านบน ในเมนูแถบด้านข้างทางซ้าย ไปที่การผสานการทำงาน > แอปที่เชื่อมต่อ
  • ในรายการแอปที่เชื่อมต่อให้คลิก Salesforce 
  • ในแท็บการซิงค์สุขภาพภายใต้ข้อผิดพลาดในการซิงค์ให้ดูการ์ดสำหรับแต่ละประเภทข้อผิดพลาดพร้อมจำนวนข้อผิดพลาดปัจจุบันและบันทึกที่ได้รับผลกระทบ คลิกการ์ดประเภทข้อผิดพลาดเพื่อดูรายละเอียดของข้อผิดพลาดในแผงด้านขวา ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทข้อผิดพลาดและคำแนะนำในการแก้ไขปัญหาแต่ละประเภท 

sync-health-sync-errors

  • หากต้องการดูรายละเอียดเพิ่มเติมสำหรับข้อผิดพลาดให้คลิกไอคอน infoในคอลัมน์ประเภทข้อผิดพลาด
  • หากต้องการดำเนินการกับแต่ละระเบียนให้คลิก [#] ระเบียนในคอลัมน์บันทึกที่ได้รับผลกระทบจากนั้นคลิกการดำเนินการ > สร้างมุมมองชั่วคราวของระเบียน HubSpot เพื่อสร้างมุมมองที่กรองของระเบียนที่ได้รับผลกระทบ 
  • เมื่อคุณแก้ไขข้อผิดพลาดแล้วให้กลับไปที่รายการข้อผิดพลาด เลือกช่องทำเครื่องหมายทางด้านซ้ายของข้อผิดพลาดที่ได้รับการแก้ไขแล้วคลิกซิงค์อีกครั้ง
  • หากต้องการส่งออกข้อผิดพลาดของคุณให้คลิกส่งออกข้อผิดพลาด (CSV) ที่ด้านบนซ้ายของรายการข้อผิดพลาด
screenshot showing the button to export Salesforce sync errors in HubSpot

ประเภทข้อผิดพลาดในการซิงค์ Salesforce

สมาคม

ตัวอย่างของข้อผิดพลาดในการเชื่อมโยง 

  • ถึงขีดจำกัดของสมาคมแล้ว
  • กำลังรอให้บัญชีซิงค์

ข้อผิดพลาดหมายถึงอะไร

เรคคอร์ดไม่ซิงค์เนื่องจากเชื่อมโยงกับบัญชี Salesforce ที่ยังไม่ได้ซิงค์กับบริษัท HubSpot หรือเชื่อมโยงกับเรคคอร์ดที่ถึงขีดจำกัดการเชื่อมโยงเรคคอร์ดของ HubSpot 

วิธีแก้ไขข้อผิดพลาด 

หากต้องการแก้ไขข้อผิดพลาดที่ถึงขีดจำกัดของสมาคมคุณสามารถลบบันทึกที่เกี่ยวข้องบางส่วนหรือเชื่อมโยงกับบันทึก Salesforce อื่นแล้วดำเนินการซิงค์ต่อ

ในการแก้ไขข้อผิดพลาดการรอให้บัญชีซิงค์ขอแนะนำให้คุณดำเนินการนำเข้าบัญชี Salesforce 

รหัสที่กำหนดเอง

ตัวอย่างข้อผิดพลาดของรหัสที่กำหนดเอง 

  • Salesforce automation
  • ID ผู้ติดต่อขาดหายไป
  • กฎการตรวจสอบฟิลด์ที่กำหนดเองของ Salesforce
  • กระแส Salesforce

ข้อผิดพลาดหมายถึงอะไร

บันทึกไม่ซิงค์เนื่องจากปัญหาที่เกิดจากระบบอัตโนมัติลำดับงานหรือกฎการตรวจสอบความถูกต้องในบัญชี Salesforce ของคุณ

วิธีแก้ไขข้อผิดพลาด

เนื่องจากข้อผิดพลาดเหล่านี้เกิดขึ้นใน Salesforce จึงขอแนะนำให้คุณทำงานร่วมกับผู้ดูแลระบบ Salesforce เพื่อแก้ไขปัญหาในรหัสที่กำหนดเองของคุณใน Salesforce 

ทำซ้ำ

ตัวอย่างของข้อผิดพลาดที่ซ้ำกัน

  • มีผู้ใช้อีเมลนี้แล้ว
  • กฎที่ซ้ำกันของ Salesforce

ข้อผิดพลาดหมายถึงอะไร

ลูกค้าเป้าหมายหรือผู้ติดต่อของ Salesforce ไม่สามารถซิงค์กับ HubSpot ได้เนื่องจากมีที่อยู่อีเมลอยู่แล้วในบันทึกผู้ติดต่อของ HubSpot หรือเนื่องจากกฎการทำสำเนาข้อมูลซ้ำซ้อนใน Salesforce 

วิธีแก้ไขข้อผิดพลาด

หากต้องการแก้ไขข้อผิดพลาดในการใช้อีเมลให้ลบที่อยู่อีเมลออกจากที่อยู่ติดต่อ HubSpot ที่มีอยู่

ในการแก้ไขข้อผิดพลาดของกฎซ้ำซ้อนของ Salesforce ขอแนะนำให้คุณตรวจสอบกฎที่ตรงกันสำหรับการตั้งค่าการทำซ้ำซ้อนใน Salesforce 

การอนุญาต

ตัวอย่างข้อผิดพลาดในการอนุญาต

  • การเข้าถึงไม่เพียงพอหรือไม่มีบันทึก Salesforce
  • การอนุญาตเขตข้อมูล Salesforce
  • การเข้าถึง Salesforce ไม่เพียงพอ

ข้อผิดพลาดหมายถึงอะไร

การเปลี่ยนแปลงที่ทำใน HubSpot ไม่สามารถซิงค์กับ Salesforce ได้เนื่องจากผู้ใช้ที่เชื่อมต่อไม่มีสิทธิ์เข้าถึงฟิลด์หรือวัตถุที่จำเป็นใน Salesforce

วิธีแก้ไขข้อผิดพลาด

ในกรณีส่วนใหญ่ข้อผิดพลาดในการเข้าถึงหรือไม่มีระเบียน Salesforce เกิดขึ้นเมื่อการผสานรวมพยายามอัปเดตฟิลด์ Salesforce ด้วยค่าที่ไม่ถูกต้องหรือสร้างการเชื่อมโยงที่ไม่ถูกต้อง 

ในการแก้ไขข้อผิดพลาดเกี่ยวกับ สิทธิ์ในฟิลด์ Salesforce ตรวจสอบให้แน่ใจว่าผู้ใช้ผสานรวม Salesforce มีสิทธิ์ในการอ่านและแก้ไขฟิลด์ใน Salesforce 

ข้อผิดพลาดการเข้าถึง Salesforce ไม่เพียงพอเกิดขึ้นเมื่อผู้ใช้ผสานรวม Salesforce ไม่สามารถดำเนินการใน Salesforce ได้เนื่องจากสิทธิ์ของผู้ใช้ใน Salesforce ขอแนะนำให้คุณตรวจสอบสิทธิ์ของผู้ใช้ที่ผสานรวมกับ Salesforce ใน Salesforce

รายการที่เลือก

ตัวอย่างของข้อผิดพลาดในรายการเลือก

  • ไม่มีตัวเลือก Salesforce Picklist
  • ค่ารัฐหรือประเทศที่ไม่ตรงกัน
  • ตัวเลือกไม่ตรงกัน
  • เจ้าของ Salesforce ที่ไม่ได้ใช้งาน
  • ค่ารายการเลือกที่จำกัด
  • ขั้นตอนโอกาสที่ไม่ได้ใช้งาน
  • ไม่ได้ซิงค์เจ้าของ Salesforce
  • ตัวเลือกเกินขีดจำกัดแล้ว
  • กระบวนการขายเริ่มต้นไม่พร้อมใช้งาน
  • ขั้นตอนโอกาสขาดหายไปหรือไม่ถูกต้อง

ข้อผิดพลาดหมายถึงอะไร

เรคคอร์ดไม่ซิงค์เนื่องจากความแตกต่างระหว่างค่าช่องรายการเลือกใน HubSpot และ Salesforce สิ่งนี้สามารถเกิดขึ้นได้เมื่อค่ารายการเลือกในระบบหนึ่งไม่ตรงกับค่าปัจจุบันใดๆในอีกระบบหนึ่งหากรายการเลือกถึงขีดจำกัดของค่าหรือหากค่าที่ส่งผ่านไม่ถูกต้อง

วิธีแก้ไขข้อผิดพลาด

ในการแก้ไขข้อผิดพลาดของค่าสถานะหรือประเทศที่ไม่ตรงกันขอแนะนำให้คุณตรวจสอบว่าตรงตามข้อกำหนดต่อไปนี้:

  • มูลค่าภายในของตัวเลือกพร็อพเพอร์ตี้ประเทศใน HubSpot ต้องตรงกับตัวเลือกประเทศที่มีอยู่ในการตั้งค่ารายการเลือกรัฐและประเทศ/เขตแดนของคุณใน Salesforce 
  • ค่าสถานะต้องมีอยู่เป็นตัวเลือกรัฐ/จังหวัดที่มีอยู่สำหรับค่าประเทศของระเบียนใน Salesforce นอกจากนี้มูลค่าภายในของตัวเลือกอสังหาริมทรัพย์ของรัฐใน HubSpot จะต้องตรงกับตัวเลือกของรัฐที่มีอยู่ใน Salesforce 

ในการแก้ไขข้อผิดพลาดของตัวเลือกที่ไม่ตรงกันขอแนะนำให้คุณอัปเดตชื่อภายใน/API ของตัวเลือกฟิลด์ Salesforce ให้ตรงกับค่าภายในของตัวเลือกคุณสมบัติใน HubSpot 

หากต้องการแก้ไขข้อผิดพลาดของเจ้าของ Salesforce ที่ไม่ได้ใช้งานให้กำหนดระเบียน HubSpot ใหม่ให้กับผู้ใช้ที่เป็นผู้ใช้ที่ใช้งานอยู่ใน Salesforce 

ข้อผิดพลาดค่าลิสต์แบบจำกัดจะเกิดขึ้นเมื่อคุณมีลิสต์แบบจำกัดตามค่าที่กำหนดไว้ในการตั้งค่าที่ตั้งไว้เปิดใช้งานสำหรับฟิลด์ใน Salesforce เมื่อเปิดใช้งานนี้ใน Salesforce มูลค่าที่คุณพยายามซิงค์จาก HubSpot ไปยัง Salesforce จะต้องมีอยู่เป็นตัวเลือกในรายการเลือก Salesforce ขอแนะนำให้คุณปิดรายการเลือกจำกัดตามค่าที่กำหนดไว้ในการตั้งค่าชุดค่าใน Salesforce เพื่อให้ค่าใดๆสามารถซิงค์จาก HubSpot ไปยัง Salesforce ได้ 

ข้อผิดพลาดขั้นตอนโอกาสที่ไม่ได้ใช้งานเกิดขึ้นเมื่อโอกาส Salesforce ที่มีขั้นตอนโอกาสที่ไม่ได้ใช้งานพยายามซิงค์กับ HubSpot หากต้องการแก้ไขข้อผิดพลาดนี้ให้เปลี่ยนขั้นตอนโอกาสใน Salesforce เป็นใช้งานอยู่หรือย้ายโอกาสไปยังขั้นตอนที่ใช้งานอยู่ 

ในการแก้ไขข้อผิดพลาดที่ไม่ได้ซิงค์กับเจ้าของ Salesforce ตรวจสอบให้แน่ใจว่าผู้ใช้ Salesforce มีการตั้งค่าประเภทผู้ใช้เป็น Standard, Power Partner หรือ Guest ใน Salesforce 

ในการแก้ไขข้อผิดพลาดเกินขีดจำกัดของตัวเลือกขอแนะนำให้คุณลบตัวเลือกคุณสมบัติเพิ่มเติมใน HubSpot และ Salesforce ที่ทีมของคุณไม่ได้ใช้นอกจากนี้ตรวจสอบให้แน่ใจว่าคุณสมบัติที่แม็ปทั้งหมดมีประเภทฟิลด์ที่สอดคล้องกัน 

ในกรณีส่วนใหญ่กระบวนการขายเริ่มต้นข้อผิดพลาดที่ไม่พร้อมใช้งานเกิดขึ้นเมื่อโอกาส Salesforce พยายามซิงค์กับ HubSpot ด้วยประเภทระเบียนที่ขาดหายไปหากคุณเปิดใช้งานประเภทระเบียนใน Salesforce แต่คุณไม่ได้ใช้งานหรือมีโอกาส Salesforce โดยไม่มีประเภทระเบียนขอแนะนำให้คุณทำงานร่วมกับ Salesforce เพื่อปิดใช้งานประเภทระเบียนทั้งหมดหรือสร้างประเภทระเบียนใหม่ 

ในการแก้ไขข้อผิดพลาดขั้นตอนโอกาสที่ขาดหายไปหรือไม่ถูกต้องตรวจสอบให้แน่ใจว่ามีค่าขั้นตอนโอกาสของ Salesforce อยู่ในไปป์ไลน์ HubSpot 

การแมปที่พัก

ตัวอย่างข้อผิดพลาดในการแม็ปที่พัก 

  • ประเภทไม่ตรงกัน
  • ไม่มีรหัส Salesforce
  • รหัส Salesforce ไม่ถูกต้อง

ข้อผิดพลาดหมายถึงอะไร

เรคคอร์ดไม่ซิงค์เนื่องจากความคลาดเคลื่อนในการแม็ประหว่างพร็อพเพอร์ตี้ HubSpot และฟิลด์ Salesforce ซึ่งอาจหมายความว่าคุณสมบัติและประเภทฟิลด์เข้ากันไม่ได้คุณสมบัติหรือฟิลด์ไม่มีอยู่แล้วหรือต้องสร้างการแมปฟิลด์อ้างอิงของ Salesforce

วิธีแก้ไขข้อผิดพลาด 

ในการแก้ไขข้อผิดพลาดประเภทไม่ตรงกันตรวจสอบให้แน่ใจว่าประเภทคุณสมบัติใน HubSpot และประเภทฟิลด์ใน Salesforce เข้ากันได้ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทช่องคุณสมบัติ HubSpot ที่สามารถซิงค์กับ Salesforce ได้ 

ข้อผิดพลาด Salesforce ID ที่หายไปเกิดขึ้นเมื่อ HubSpot พยายามซิงค์ค่าอื่นนอกเหนือจาก Salesforce ID ที่มีอยู่ไปยังฟิลด์อ้างอิง/การค้นหาใน Salesforce 

ในการแก้ไขข้อผิดพลาด Salesforce ID ไม่ถูกต้องขอแนะนำให้คุณตรวจสอบกฎการตรวจสอบที่กำหนดเองที่คุณได้ตั้งค่าไว้ใน Salesforce 

ค่าที่พัก

ตัวอย่างของข้อผิดพลาดค่าทรัพย์สิน

  • สตริงยาวเกินไป
  • อีเมลไม่ถูกต้อง
  • ไม่มีประเทศที่จำเป็น
  • ค่าไม่ถูกต้อง
  • การมอบหมายงานให้เจ้าของ
  • ค่าที่ไม่ซ้ำกันที่ถูกจำกัด
  • ไม่มีค่าที่ต้องการ

ข้อผิดพลาดหมายถึงอะไร

บันทึกจะไม่ซิงค์ระหว่าง HubSpot และ Salesforce เนื่องจากมีค่าที่พักที่ไม่ถูกต้องข้อผิดพลาดเหล่านี้มักกำหนดให้บันทึกที่ได้รับผลกระทบแต่ละรายการได้รับการอัปเดตเพื่อแก้ไขข้อผิดพลาด

วิธีแก้ไขข้อผิดพลาด

หากต้องการแก้ไขข้อผิดพลาดสตริงที่ยาวเกินไปให้ย่อค่าฟิลด์ใน Salesforce หรือ HubSpot หรือเพิ่มขีดจำกัดอักขระของฟิลด์ใน Salesforce 

หากต้องการแก้ไขข้อผิดพลาดอีเมลไม่ถูกต้องให้อัปเดตการจัดรูปแบบที่อยู่อีเมลในบันทึก Salesforce ที่พยายามซิงค์กับ HubSpot

ในการแก้ไขข้อผิดพลาดของประเทศที่ไม่จำเป็นขอแนะนำให้คุณตรวจสอบว่าตรงตามข้อกำหนดต่อไปนี้:

  • มูลค่าภายในของตัวเลือกพร็อพเพอร์ตี้ประเทศใน HubSpot ต้องตรงกับตัวเลือกประเทศที่มีอยู่ในการตั้งค่ารายการเลือกรัฐและประเทศ/เขตแดนของคุณใน Salesforce 
  • ค่าสถานะต้องมีอยู่เป็นตัวเลือกรัฐ/จังหวัดที่มีอยู่สำหรับค่าประเทศของระเบียนใน Salesforce นอกจากนี้มูลค่าภายในของตัวเลือกอสังหาริมทรัพย์ของรัฐใน HubSpot จะต้องตรงกับตัวเลือกของรัฐที่มีอยู่ใน Salesforce 

ในการแก้ไขข้อผิดพลาดของค่าไม่ถูกต้องขอแนะนำให้คุณอัปเดตค่าคุณสมบัติในบันทึก Salesforce เพื่อให้เป็นไปตามข้อกำหนดของ HubSpot สำหรับค่าคุณสมบัติ 

ในกรณีส่วนใหญ่ข้อผิดพลาดการกำหนดเจ้าของจะเกิดขึ้นเมื่อกิจกรรม HubSpot ซิงค์กับ Salesforce ในฐานะงาน Salesforce และ HubSpot พยายามกำหนดงานให้กับเจ้าของคิว Salesforce

ในการแก้ไขข้อผิดพลาดของค่าที่ไม่ซ้ำกันที่ถูกจำกัดขอแนะนำให้คุณตรวจสอบกฎการจับคู่สำหรับการทำซ้ำซ้อนที่คุณตั้งค่าไว้ใน Salesforce 

ในการแก้ไขข้อผิดพลาดของค่าที่ต้องการหายไปให้เพิ่มค่าลงในบันทึก Salesforce สำหรับคุณสมบัติใดๆที่ทำเครื่องหมายว่าจำเป็นใน HubSpot 

อื่นๆ

เรคคอร์ดไม่ซิงค์เนื่องจากเกิดข้อผิดพลาดที่ไม่ทราบสาเหตุโปรดติดต่อฝ่ายสนับสนุน HubSpot เพื่อขอความช่วยเหลือเพิ่มเติมเกี่ยวกับข้อผิดพลาดเหล่านี้

โปรดทราบ: เป็นไปได้ที่จะซิงค์ข้อผิดพลาด Salesforce จำนวนมากครั้งละ 100 รายการหากต้องการซิงค์ข้อผิดพลาดมากกว่า 100 รายการให้นำเข้าระเบียนจาก Salesforce หรืออัปเดตคุณสมบัติที่แมป

ตั้งค่าการแจ้งเตือนข้อผิดพลาดในการซิงค์

  • ในบัญชี HubSpot ของคุณ คลิกsettings ไอคอนการตั้งค่าในแถบการนำทางด้านบน ในเมนูแถบด้านข้างทางซ้าย ไปที่การผสานการทำงาน > แอปที่เชื่อมต่อ
  • ในรายการแอปที่เชื่อมต่อให้คลิก Salesforce 
  • คลิกแท็บซิงค์สุขภาพ 
  • ภายใต้ข้อผิดพลาดในการซิงค์ให้คลิกจัดการการแจ้งเตือน 
  • ในกล่องโต้ตอบให้เปิดสวิตช์เปิดการแจ้งเตือน  
  • เลือกปุ่มตัวเลือกถัดจากทันทีรายวันหรือรายสัปดาห์เพื่อตั้งค่าความถี่ในการแจ้งเตือนของคุณ 
  • คลิก บันทึก 

sync-health-error-notifications

บทความนี้มีประโยชน์หรือไม่
แบบฟอร์มนี้ใช้สำหรับคำติชมเอกสารเท่านั้น เรียนรู้วิธีขอความช่วยเหลือจาก HubSpot