ใช้เว็บฮุคกับเวิร์กโฟลว์ HubSpot

ใช้เว็บฮุกในเวิร์กโฟลว์เพื่อส่งหรือเรียกดูข้อมูลระหว่าง HubSpot และเครื่องมือภายนอกอื่นๆ มีการใช้งานเว็บฮุคที่หลากหลายตัวอย่างกรณีการใช้งานเว็บฮุคที่ได้รับความนิยมได้แก่:

• การโพสต์ข้อมูลผู้ติดต่อ HubSpot ไปยังระบบอื่นเช่น CRM เมื่อผู้ติดต่อนั้นกรอกแบบฟอร์มเฉพาะบนไซต์ของคุณ

• การส่งข้อมูลข้อตกลงไปยังระบบจัดการการจัดส่งภายนอกเพื่อสร้างใบสั่งซื้อ

• กำลังดึงข้อมูลจากระบบอื่นเพื่ออัปเดตระเบียน HubSpot ของคุณ 

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

โปรดทราบ: HubSpot จะลองใช้เว็บฮุคที่ล้มเหลวอีกครั้งเป็นเวลาสูงสุดสามวันโดยเริ่มต้นหลังจากล้มเหลวหนึ่งนาที ความล้มเหลวที่ตามมาจะถูกลองอีกครั้งในช่วงเวลาที่เพิ่มขึ้นโดยมีช่องว่างสูงสุดแปดชั่วโมงระหว่างการลอง เวิร์กโฟลว์จะไม่ลองอีกครั้งหลังจากได้รับรหัสสถานะการตอบกลับชุด 4xx
ข้อยกเว้นประการหนึ่งของกฎนี้คือข้อผิดพลาดในการจำกัดอัตรา 429 ขั้นตอนการทำงานจะลองอีกครั้งโดยอัตโนมัติหลังจากได้รับการตอบกลับ 429 ครั้งและจะเคารพส่วนหัวของการลองอีกครั้งหลังจากที่มีอยู่ ลองอีกครั้งหลังจากนั้นจะถูกบันทึกเป็นมิลลิวินาที เรียนรู้เกี่ยวกับข้อยกเว้นรหัสข้อผิดพลาดเฉพาะในเอกสารสำหรับนักพัฒนาของ HubSpot

เรียนรู้เพิ่มเติมเกี่ยวกับเว็บฮุคในเอกสารประกอบเว็บฮุคสำหรับนักพัฒนาซอฟต์แวร์ หากคุณมีคำถามเกี่ยวกับการใช้งานเว็บฮุคเฉพาะของคุณกับ HubSpot โปรดติดต่อ HubSpot Developers Forums

ตั้งค่าคำขอโพสต์

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

• คลิกเมนูดรอปดาวน์วิธีการและเลือก โพสต์ 
• ป้อน URL เว็บฮุก
  • URL ของ Webhook ถูกจำกัดไว้ที่โปรโตคอลที่ปลอดภัยและต้องเริ่มต้นด้วย HTTPS
  • หากต้องการขอข้อมูลเฉพาะคุณสามารถเพิ่มพารามิเตอร์การสืบค้นเช่น?queryparameter=abc ไปยัง URL ของ Webhook
  • หากไม่มีการเพิ่มพารามิเตอร์การสืบค้นโพสต์ทั่วไปหรือคำขอ GET จะถูกส่ง 
• ตั้งค่าประเภทการตรวจสอบสิทธิ์เพื่อตรวจสอบสิทธิ์คำขอไปยังเว็บฮุคของคุณ คุณสามารถใช้ลายเซ็นคำขอในส่วนหัวเว็บฮุกของคุณหรือใช้คีย์ API:
  • วิธีใช้ลายเซ็นคำขอในส่วนหัวเว็บฮุกของคุณ:
    • คลิกเมนูแบบเลื่อนลงประเภทการตรวจสอบสิทธิ์ จากนั้นเลือกรวมลายเซ็นคำขอในส่วนหัว
    • จากนั้นป้อน ID แอป HubSpot ของคุณ ดูวิธีตรวจสอบลายเซ็นคำขอ

• • วิธีใช้คีย์ API หรือแอปสาธารณะที่สร้างผ่านบัญชีนักพัฒนาซอฟต์แวร์เพื่อตรวจสอบสิทธิ์:

• • • เมื่อใช้คีย์ API สำหรับการตรวจสอบสิทธิ์ชื่อคีย์ API และตำแหน่งคีย์ API ที่ใช้จะขึ้นอยู่กับวิธีการกำหนดค่าเว็บฮุก ด้วยเหตุผลด้านความปลอดภัยคีย์ API จะไม่แสดงในคำขอทดสอบใดๆ วิธีใช้คีย์ API:
      • คลิกเมนูแบบเลื่อนลงประเภทการตรวจสอบสิทธิ์ จากนั้นเลือกคีย์ API 

• • • • ป้อนชื่อคีย์ API ของคุณ
      • คลิกเมนูแบบเลื่อนลงของตำแหน่งคีย์ API จากนั้นเลือกพารามิเตอร์การค้นหาหรือส่วนหัวคำขอ เรียนรู้เพิ่มเติมเกี่ยวกับการใช้คีย์ API ใน HubSpot
    • หากคุณกำลังส่งคำขอไปยัง HubSpot API:
      • คลิกเมนูดร็อปดาวน์คีย์ API และเลือกความลับ ค่าลับต้องอยู่ในรูปแบบผู้ถือ [YOUR_TOKEN]
      • ตั้งค่าของชื่อคีย์ API เป็นการให้ สิทธิ์
      • ตั้งค่าตำแหน่งคีย์ API เป็นส่วนหัวคำขอ

• หากต้องการรวมคุณสมบัติทั้งหมดให้เลือกรวมคุณสมบัติ [object] ทั้งหมด 
• วิธีระบุเฉพาะที่พัก: 
  
  • เลือกปรับแต่งเนื้อหาคำขอ
  • หากต้องการปรับแต่งเนื้อหาคำขอโดยใช้คุณสมบัติ HubSpot ให้ป้อนคีย์และเลือก คุณสมบัติ หากต้องการเพิ่มที่พักอื่นให้คลิกเพิ่มที่พัก
  • หากต้องการปรับแต่งเนื้อหาคำขอโดยใช้ฟิลด์คงที่ให้ป้อนคีย์และ ค่า หากต้องการเพิ่มคุณสมบัติอื่นให้คลิกเพิ่มค่าคงที่

• • หากต้องการลบคุณสมบัติหรือค่าคงที่ให้คลิกไอคอนdelete ถังขยะ
• คลิก บันทึก 

โปรดทราบ: ในการเลือกเอาต์พุตหลายรายการการตอบสนองควรมีโครงสร้างเป็นออบเจ็กต์ JSON

ตั้งค่าคำขอ GET

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

• คลิกเมนูดร็อปดาวน์วิธีการและเลือก GET 
• ป้อน URL เว็บฮุก
  • URL ของ Webhook ถูกจำกัดไว้ที่โปรโตคอลที่ปลอดภัยและต้องเริ่มต้นด้วย HTTPS
  • หากต้องการขอข้อมูลเฉพาะคุณสามารถเพิ่มพารามิเตอร์การสืบค้นเช่น?queryparameter=abc ไปยัง URL ของ Webhook
  • หากไม่มีการเพิ่มพารามิเตอร์การสืบค้นโพสต์ทั่วไปหรือคำขอ GET จะถูกส่ง 
• ตั้งค่าประเภทการตรวจสอบสิทธิ์เพื่อตรวจสอบสิทธิ์คำขอไปยังเว็บฮุคของคุณ คุณสามารถใช้ลายเซ็นคำขอในส่วนหัวเว็บฮุกของคุณหรือใช้คีย์ API:
  • วิธีใช้ลายเซ็นคำขอในส่วนหัวเว็บฮุกของคุณ:
    • คลิกเมนูแบบเลื่อนลงประเภทการตรวจสอบสิทธิ์ จากนั้นเลือกรวมลายเซ็นคำขอในส่วนหัว
    • จากนั้นป้อน ID แอป HubSpot ของคุณ ดูวิธีตรวจสอบลายเซ็นคำขอ

• • วิธีใช้คีย์ API หรือแอปสาธารณะที่สร้างผ่านบัญชีนักพัฒนาซอฟต์แวร์เพื่อตรวจสอบสิทธิ์:

• • • เมื่อใช้คีย์ API สำหรับการตรวจสอบสิทธิ์ชื่อคีย์ API และตำแหน่งคีย์ API ที่ใช้จะขึ้นอยู่กับวิธีการกำหนดค่าเว็บฮุก ด้วยเหตุผลด้านความปลอดภัยคีย์ API จะไม่แสดงในคำขอทดสอบใดๆ วิธีใช้คีย์ API:
      • คลิกเมนูแบบเลื่อนลงประเภทการตรวจสอบสิทธิ์ จากนั้นเลือกคีย์ API 

• • • • ป้อนชื่อคีย์ API ของคุณ
      • คลิกเมนูแบบเลื่อนลงของตำแหน่งคีย์ API จากนั้นเลือกพารามิเตอร์การค้นหาหรือส่วนหัวคำขอ เรียนรู้เพิ่มเติมเกี่ยวกับการใช้คีย์ API ใน HubSpot
    • หากคุณกำลังส่งคำขอไปยัง HubSpot API:
      • คลิกเมนูดร็อปดาวน์คีย์ API และเลือกความลับ ค่าลับต้องอยู่ในรูปแบบผู้ถือ [YOUR_TOKEN]
      • ตั้งค่าของชื่อคีย์ API เป็นการให้ สิทธิ์
      • ตั้งค่าตำแหน่งคีย์ API เป็นส่วนหัวคำขอ

• วิธีใช้พร็อพเพอร์ตี้ HubSpot เป็นพารามิเตอร์การค้นหา:
  • ใต้ส่วนพารามิเตอร์การค้นหาให้ป้อนคีย์จากนั้นเลือก คุณสมบัติ
  • หากต้องการเพิ่มที่พักอื่นให้คลิกเพิ่มที่พัก
  • หากต้องการลบคุณสมบัติให้คลิกไอคอนdelete ถังขยะ 
• วิธีใช้ค่าคงที่เป็นพารามิเตอร์การค้นหา:
  • ภายใต้ส่วนพารามิเตอร์การค้นหาให้ป้อนคีย์จากนั้นป้อนค่า
  • หากต้องการเพิ่มคุณสมบัติอื่นให้คลิกเพิ่มค่าคงที่
  • หากต้องการลบคุณสมบัติให้คลิกไอคอนdelete ถังขยะ 
• คลิก บันทึก 

ทดสอบเว็บฮุกของคุณภายใน HubSpot

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

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

• ในบัญชี HubSpot ของคุณ ไปที่ ระบบอัตโนมัติ > เวิร์กโฟลว์
• คลิกชื่อเวิร์กโฟลว์ 
• ในตัวแก้ไขเวิร์กโฟลว์ให้คลิกการดำเนินการส่งเว็บฮุก
• ในแผงด้านซ้ายให้คลิกการดำเนินการทดสอบเพื่อขยายส่วน 
• หากคุณกำลังทดสอบคำขอโพสต์ให้คลิกเมนูแบบเลื่อนลง [object] จากนั้นเลือกระเบียนที่จะทดสอบ
• คลิก ทดสอบ 
• หากต้องการตรวจสอบรายละเอียดเว็บฮุกให้เลือกแท็บการตอบกลับหรือ คำขอ ในแต่ละแท็บคุณสามารถคลิกเปิดทั้งหมดเพื่อขยายทุกส่วนหรือยุบทั้งหมดเพื่อยุบทุกส่วน 
  
  • ในแท็บการตอบกลับให้คลิกส่วนหัว: หรือเนื้อหา: เพื่อขยายแต่ละส่วน 
  • ในแท็บคำขอให้คลิก httpHeaders: เพื่อขยายส่วน
    
    

ทดสอบเว็บฮุกของคุณภายนอก

หลังจากที่คุณสร้างเวิร์กโฟลว์ของคุณด้วยการกระทำเว็บฮุกคุณสามารถทำการทดสอบอย่างรวดเร็วด้วย URL เว็บฮุกดัมมี่:

• ในเบราว์เซอร์ของคุณไปที่ https://webhook.site และคัดลอก URL ที่ไม่ซ้ำกัน
• ในฟิลด์ URL ของ Webhook ในการดำเนินการ Webhook ของคุณให้วาง URL
• เมื่อเปิดเวิร์กโฟลว์ของคุณแล้วคุณสามารถลงทะเบียนผู้ติดต่อทดสอบได้ด้วยตนเอง 
  
  

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

โปรดทราบ: ค่าคุณสมบัติในอดีตจะถูกส่งกลับในเวิร์กโฟลว์แบบติดต่อเท่านั้น เว็บฮุคที่ใช้ในเวิร์กโฟลว์ประเภทอื่นๆทั้งหมดจะส่งกลับค่าล่าสุดเท่านั้น

ตรวจสอบลายเซ็นคำขอในเว็บฮุคของเวิร์กโฟลว์

ในกรณีที่คุณเลือกขอลายเซ็นในส่วนการตรวจสอบสิทธิ์สำหรับทริกเกอร์การดำเนินการเว็บฮุกของคุณ HubSpot จะเติมเว็บฮุกด้วยส่วนหัว X-HubSpot-Signature ที่มีแฮช SHA -256 ของการเชื่อมต่อความลับของแอปสำหรับแอปพลิเคชันของคุณวิธีการ HTTP, URI และเนื้อหาที่ไม่มีการแยกวิเคราะห์ เรียนรู้เพิ่มเติมเกี่ยวกับเรื่องนี้ในเอกสารสำหรับนักพัฒนา

ในการตรวจสอบว่าคำขอที่ได้รับที่ URL ของคุณมาจาก HubSpot:

• เป็นเจ้าของบัญชีนักพัฒนาซอฟต์แวร์ หากยังไม่มีให้ลงชื่อสมัครใช้บัญชีนักพัฒนาซอฟต์แวร์
• เป็นเจ้าของแอพหากไม่มีแอพดูวิธีสร้างแอพ
• ตรวจสอบค่าแฮชของลายเซ็น

เรียกใช้เวิร์กโฟลว์จากเว็บฮุก

เว็บฮุคสามารถใช้เพื่อกระตุ้นเวิร์กโฟลว์ เมื่อข้อมูลมีการเปลี่ยนแปลงในแอปของบุคคลที่สามสิ่งนี้จะทริกเกอร์เวิร์กโฟลว์ เรียนรู้เพิ่มเติมเกี่ยวกับการเรียกใช้เวิร์กโฟลว์จากเว็บฮุก

ใช้ข้อมูลเว็บฮุกในแผงข้อมูล

ข้อมูลจากเว็บฮุกที่เชื่อมต่อกับบัญชีของคุณสามารถใช้สำหรับการดำเนินการบางอย่างในแผงข้อมูล

วิธีใช้ข้อมูลจากเว็บฮุคที่เชื่อมต่อ:

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