Setting up webhooks

Article Number:040600

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

เว็บฮุกทำงานอย่างไร

โดยใช้เครื่องมือบูรณาการที่ช่วยให้ใช้เว็บฮุกได้ คุณสามารถเชื่อมต่อ Kintone เข้ากับบริการที่รองรับโดยเครื่องมือได้
ตัวอย่างของเครื่องมือดังกล่าว ได้แก่ Zapier, Microsoft Power Automate และ IFTTT

Figure: How webhooks work

การตั้งค่าเว็บฮุกบนแอป Kintone ช่วยให้คุณสามารถตั้งค่าการแจ้งเตือนสำหรับการดำเนินการแอปต่อไปนี้ได้

  • การเพิ่มบันทึก
  • การแก้ไขบันทึก
  • การลบข้อมูล
  • การโพสต์ความคิดเห็น
  • การอัพเดตสถานะ (เมื่อสถานะการจัดการกระบวนการได้รับการอัพเดต)

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

ภาพรวมของการตั้งค่าเว็บฮุก

คุณสามารถตั้งค่าเว็บฮุกได้โดยทำตามขั้นตอนต่อไปนี้

  1. ตั้งค่าทริกเกอร์โดยใช้เครื่องมือการรวม (เช่น Zapier)
  2. ตั้งค่าเว็บฮุกบน Kintone
  3. ตั้งค่าการดำเนินการโดยใช้เครื่องมือการรวม

ตัวอย่างการกำหนดค่าการตั้งค่า

หัวข้อนี้ให้ตัวอย่างการใช้ Zapier ในการตั้งค่าเว็บฮุกที่ส่งการแจ้งเตือนไปยังบัญชี Gmail เมื่อมีการเพิ่มระเบียนใหม่บน Kintone

การตระเตรียม

ก่อนที่จะตั้งค่าเว็บฮุก ให้ทำการเตรียมการดังต่อไปนี้

  • สร้าง บัญชี Gmail
  • สร้าง แอป Kintone

เมื่อบัญชี Gmail และแอป Kintone ของคุณพร้อมแล้ว ให้ทำตามขั้นตอนที่อธิบายไว้ด้านล่าง

1) การตั้งค่าทริกเกอร์บน Zapier

  1. เข้าถึงเว็บไซต์ Zapier และลงทะเบียน
    หากคุณไม่มีบัญชี Zapier โปรดสร้างบัญชีใหม่หรือลงทะเบียนด้วยบัญชีประเภทอื่น (เช่น บัญชี Google)

  2. คลิก สร้าง Zap บนเว็บไซต์ Zapier

  3. บนหน้าจอเพื่อเลือกทริกเกอร์ ให้ป้อน "Webhook" ในช่องค้นหาแล้วคลิก Webhook โดย ZapierScreenshot: Selecting a webhook trigger

  4. เลือก Catch Hook ภายใต้ Event จากนั้นคลิก ดำเนินการต่อScreenshot: Selecting "Catch hook"

  5. ในหน้าจอถัดไป คลิก ดำเนินการต่อScreenshot: The screen that appears after selecting an event

  6. เมื่อสร้าง URL เว็บฮุค ให้คลิก คัดลอก
    วาง URL ที่คัดลอกไว้ที่ใดที่หนึ่งในมือ เช่น โปรแกรมแก้ไขข้อความScreenshot: The "Export" button is highlighted

ขั้นต่อไป คุณจะตั้งค่าเว็บฮุกบน Kintone และเปิดเว็บไซต์ Zapier เอาไว้

2) ตั้งค่าเว็บฮุกบน Kintone

  1. คลิกไอคอน การตั้งค่าแอป (ไอคอนรูปฟันเฟือง) ที่ด้านขวาบนของหน้าจอ ดู
    Screenshot: The "App settings" icon is highlighted

  2. บนหน้าจอ การตั้งค่าแอป ให้เลือกแท็บ การตั้งค่าแอป จากนั้นคลิก Webhook ภายใต้ การกำหนดเอง และการรวม

  3. บนหน้าจอ Webhook คลิก เพิ่ม webhook

  4. บนหน้าจอ เว็บฮุกใหม่ ให้ป้อนคำอธิบายของเว็บฮุกที่จะตั้งค่า
    คำอธิบายที่คุณป้อนที่นี่จะแสดงอยู่ในรายการของเว็บฮุก คุณสามารถป้อนได้สูงสุด 64 อักขระ

  5. ในช่องอินพุต จุดสิ้นสุดของ Webhook ให้วาง URL ที่คุณคัดลอกไว้ในขั้นตอนที่ 6 ของส่วน "การตั้งค่าทริกเกอร์บน Zapier"
    ลบ "https://" ที่จุดเริ่มต้นของ URL
    คุณสามารถกรอกช่องป้อนข้อมูลได้ไม่เกิน 1,024 ตัวอักษรScreenshot: The "New webhook" screen is displayed

  6. ในส่วน เหตุการณ์ ให้ระบุการดำเนินการที่จะทริกเกอร์การแจ้งเตือนเว็บฮุก
    ในตัวอย่างนี้ ให้เลือก เพิ่มบันทึกแล้วScreenshot: The "Events" section is displayed

  7. ตรวจสอบให้แน่ใจว่าได้เลือกกล่องกาเครื่องหมาย เปิดใช้งาน Webhook นี้ แล้ว
    ช่องกาเครื่องหมายจะถูกเลือกไว้ตามค่าเริ่มต้น

  8. คลิก บันทึก ที่ด้านขวาล่างของหน้าจอ

  9. บนหน้าจอ Webhook ให้คลิก การตั้งค่าแอป ในข้อความที่แสดงที่ด้านบนของหน้าจอ หรือคลิก กลับไปที่การตั้งค่าแอป ที่แสดงที่ด้านซ้ายล่างของหน้าจอ

  10. บนหน้าจอ การตั้งค่าแอป คลิก อัปเดตแอป

  11. ในกล่องโต้ตอบ อัปเดตแอป คลิก อัปเดตแอป

  12. เพิ่มบันทึกใหม่ บนแอป Kintone เพื่อให้คุณสามารถทดสอบทริกเกอร์ที่คุณตั้งค่าไว้บน Zapier ได้

  13. กลับไปที่เว็บไซต์ Zapier และคลิก ทดสอบ ทริกเกอร์
    Screenshot: "Test trigger" is displayed

  14. ตรวจสอบว่าการทดสอบสําเร็จ จากนั้นคลิก ดำเนินการต่อ.
    หากการทดสอบล้มเหลว ให้ลอง ทริกเกอร์ ทดสอบ หลายๆ ครั้ง
    หากการทดสอบยังคงล้มเหลว ให้ตรวจสอบว่า URL ที่คุณคัดลอกและวางในช่องป้อนข้อมูล ปลายทาง Webhook ถูกต้อง

3) การตั้งค่าการดำเนินการบน Zapier

  1. เมื่อปรากฏหน้าจอสำหรับตั้งค่าการดำเนินการใน Zapier ให้เลือก Gmail
    Screenshot: "Gmail" is highlighted

  2. เลือก ส่ง อีเมล ภายใต้ กิจกรรม จากนั้นคลิก ดำเนินการต่อ
    Screenshot: "Send Email" is selected under "Event"

  3. เลือก บัญชี Gmail จากนั้นคลิก ดำเนินการต่อ
    หากคุณไม่ได้ลงชื่อเข้าใช้ Gmail จะปรากฏหน้าจอเพื่อให้คุณลงชื่อเข้าใช้ GmailScreenshot: Selecting a Gmail account

  4. ระบุข้อมูลที่จะส่งไปยังบัญชี Gmail
    ป้อนบัญชี Gmail ของผู้รับลงในส่วน ถึง และตั้งค่ารายการที่จำเป็นอื่นๆ รวมถึง หัวเรื่อง และ เนื้อหา จากนั้นคลิก ดำเนินการต่อ
    Screenshot: Setting up the notification to be sent to a Gmail account

  5. ยืนยันการตั้งค่าที่คุณได้ตั้งค่าไว้และคลิก ทดสอบ และ ดำเนินการต่อ

  6. คลิก เผยแพร่ Zap

  7. ตรวจสอบว่าอีเมลการแจ้งเตือนถูกส่งไปยังบัญชี Gmail ของผู้รับแล้วคลิก เผยแพร่และเปิดใช้งาน

ตอนนี้ Zap มีผลบังคับใช้แล้ว

การเปลี่ยนแปลงการตั้งค่าของเว็บฮุกใน Kintone

คุณสามารถเปลี่ยนการตั้งค่า Webhook ใน Kintone ได้ภายหลัง โดยทำตามขั้นตอนดังต่อไปนี้

  1. คลิกไอคอน การตั้งค่าแอป (ไอคอนรูปฟันเฟือง) ที่ด้านขวาบนของหน้าจอ ดู
    Screenshot: The "App settings" icon is highlighted

  2. บนหน้าจอ การตั้งค่าแอป ให้เลือกแท็บ การตั้งค่าแอป จากนั้นคลิก Webhook ภายใต้ การกำหนดเอง และการรวม

  3. บน Webhook หน้าจอให้คลิกที่ แก้ไข ไอคอนในคอลัมน์ด้านขวาสุดของเว็บฮุกที่คุณต้องการเปลี่ยนการตั้งค่า
    Screenshot: The "Edit" button is highlighted

  4. บนหน้าจอ แก้ไข webhook ให้แก้ไขการตั้งค่าแล้วคลิก บันทึก

  5. บนหน้าจอ Webhook ให้คลิก การตั้งค่าแอป ในข้อความที่แสดงที่ด้านบนของหน้าจอ หรือคลิก กลับไปที่การตั้งค่าแอป ที่แสดงที่ด้านซ้ายล่างของหน้าจอ

  6. บนหน้าจอ การตั้งค่าแอป คลิก อัปเดตแอป

  7. ในกล่องโต้ตอบ อัปเดตแอป คลิก อัปเดตแอป