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

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

อัปเดตล่าสุด: 7 พฤศจิกายน 2025

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

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

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

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

Screenshot showing the API call use by the Salesforce integration in HubSpot.

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

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

Screenshot showing the Sync errors cards for each error type.

  1. หากต้องการดูรายละเอียดเพิ่มเติมสำหรับข้อผิดพลาดให้คลิกไอคอน infoในคอลัมน์ประเภทข้อผิดพลาด
  2. หากต้องการดำเนินการกับแต่ละระเบียนให้คลิก [#] ระเบียนในคอลัมน์บันทึกที่ได้รับผลกระทบจากนั้นคลิกการดำเนินการ > สร้างมุมมองชั่วคราวของระเบียน HubSpot เพื่อสร้างมุมมองที่กรองของระเบียนที่ได้รับผลกระทบ 
  3. เมื่อคุณแก้ไขข้อผิดพลาดแล้วให้กลับไปที่รายการข้อผิดพลาด เลือกช่องทำเครื่องหมายทางด้านซ้ายของข้อผิดพลาดที่ได้รับการแก้ไขแล้วคลิกซิงค์อีกครั้ง
  4. หากต้องการส่งออกข้อผิดพลาดของคุณให้คลิกส่งออกข้อผิดพลาด (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 หรืออัปเดตคุณสมบัติที่แมป

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

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