จัดการการเรียก API ของการผสานรวม Salesforce และข้อผิดพลาดในการซิงค์
อัปเดตล่าสุด: 27 พฤษภาคม 2025
สามารถใช้ได้กับการสมัครใช้บริการใดๆ ต่อไปนี้ ยกเว้นที่ระบุไว้:
|
|
|
|
|
การผสานรวม HubSpot-Salesforce อาจพบข้อผิดพลาดในการซิงค์ซึ่งป้องกันไม่ให้ข้อมูลซิงค์คุณสามารถระบุและแก้ไขข้อผิดพลาดในการซิงค์เหล่านี้ได้ในการตั้งค่าการผสานรวม Salesforce ของคุณ
ปรับขีดจำกัดการเรียก API
- ในบัญชี HubSpot ของคุณ คลิกsettings ไอคอนการตั้งค่าในแถบการนำทางด้านบน ในเมนูแถบด้านข้างทางซ้าย ไปที่การผสานการทำงาน > แอปที่เชื่อมต่อ
- ในรายการแอปที่เชื่อมต่อให้คลิก Salesforce
- ในแท็บสถานะการซิงค์ในส่วนการใช้การเรียก API ให้ดูจำนวนการเรียก API ที่คุณใช้ในช่วง 24 ชั่วโมงที่ผ่านมา หมายเลขจำกัดโดย Salesforce คือจำนวนการโทร API ที่คุณสามารถทำได้ตามการตั้งค่า Salesforce ของคุณ หากต้องการปรับจำนวนสายที่สามารถจัดสรรให้กับ HubSpot ได้ให้แก้ไขช่องจัดสรรให้กับ HubSpot
ดูข้อผิดพลาดในการซิงค์ Salesforce
- ในบัญชี HubSpot ของคุณ คลิกsettings ไอคอนการตั้งค่าในแถบการนำทางด้านบน ในเมนูแถบด้านข้างทางซ้าย ไปที่การผสานการทำงาน > แอปที่เชื่อมต่อ
- ในรายการแอปที่เชื่อมต่อให้คลิก Salesforce
- ในแท็บการซิงค์สุขภาพภายใต้ข้อผิดพลาดในการซิงค์ให้ดูการ์ดสำหรับแต่ละประเภทข้อผิดพลาดพร้อมจำนวนข้อผิดพลาดปัจจุบันและบันทึกที่ได้รับผลกระทบ คลิกการ์ดประเภทข้อผิดพลาดเพื่อดูรายละเอียดของข้อผิดพลาดในแผงด้านขวา ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทข้อผิดพลาดและคำแนะนำในการแก้ไขปัญหาแต่ละประเภท
- หากต้องการดูรายละเอียดเพิ่มเติมสำหรับข้อผิดพลาดให้คลิกไอคอน infoในคอลัมน์ประเภทข้อผิดพลาด
- หากต้องการดำเนินการกับแต่ละระเบียนให้คลิก [#] ระเบียนในคอลัมน์บันทึกที่ได้รับผลกระทบจากนั้นคลิกการดำเนินการ > สร้างมุมมองชั่วคราวของระเบียน HubSpot เพื่อสร้างมุมมองที่กรองของระเบียนที่ได้รับผลกระทบ
- เมื่อคุณแก้ไขข้อผิดพลาดแล้วให้กลับไปที่รายการข้อผิดพลาด เลือกช่องทำเครื่องหมายทางด้านซ้ายของข้อผิดพลาดที่ได้รับการแก้ไขแล้วคลิกซิงค์อีกครั้ง
- หากต้องการส่งออกข้อผิดพลาดของคุณให้คลิกส่งออกข้อผิดพลาด (CSV) ที่ด้านบนซ้ายของรายการข้อผิดพลาด

ประเภทข้อผิดพลาดในการซิงค์ 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
- คลิกแท็บซิงค์สุขภาพ
- ภายใต้ข้อผิดพลาดในการซิงค์ให้คลิกจัดการการแจ้งเตือน
- ในกล่องโต้ตอบให้เปิดสวิตช์เปิดการแจ้งเตือน
- เลือกปุ่มตัวเลือกถัดจากทันทีรายวันหรือรายสัปดาห์เพื่อตั้งค่าความถี่ในการแจ้งเตือนของคุณ
- คลิก บันทึก