การใช้งาน Wait

เอกสารประกอบสำหรับ node Wait ใน n8n ซึ่งเป็นแพลตฟอร์มอัตโนมัติของ workflow รวมถึงคำแนะนำในการใช้งาน และลิงก์ไปยังตัวอย่าง

ใช้ node รอหยุดการดำเนินการ workflow ของคุณชั่วคราว เมื่อ workflow หยุดชั่วคราว ระบบจะถ่ายข้อมูลการดำเนินการไปยังฐานข้อมูล เมื่อตรงตามเงื่อนไขการกลับมาทำงานต่อ workflow จะโหลดข้อมูลซ้ำและดำเนินการต่อไป

การดำเนินงาน

node รอสามารถทำได้ Resume ภายใต้เงื่อนไขดังต่อไปนี้:

• After Time Interval : node จะรอเป็นระยะเวลาหนึ่ง
• At Specified Time : node รอจนถึงเวลาที่กำหนด
• On Webhook Call : node รอจนกว่าจะได้รับการเรียก HTTP
• On Form Submitted : node จะรอจนกว่าจะได้รับการส่งแบบฟอร์ม

โปรดดูส่วนรายละเอียดเพิ่มเติมด้านล่างสำหรับคำแนะนำโดยละเอียดเพิ่มเติม

After Time Interval

รอสักระยะหนึ่ง

parameter นี้มีฟิลด์เพิ่มเติมอีกสองฟิลด์:

• Wait Amount : กรอกระยะเวลาในการรอ
• Wait Unit : เลือกหน่วยวัดสำหรับ Wait Amount . เลือกจาก:
  • Seconds
  • Minutes
  • Hours
  • Days

อ้างถึง การดำเนินการตามเวลา สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการทำงานของช่วงเวลาเหล่านี้และเขตเวลาที่ใช้

At Specified Time

รอจนถึงวันที่และเวลาที่ระบุเพื่อดำเนินการต่อ ใช้ตัวเลือกวันที่และเวลาเพื่อตั้งค่า Date and Time.

อ้างถึง การดำเนินการตามเวลา เพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับเขตเวลาที่ใช้

On Webhook Call

parameter นี้ช่วยให้ workflow ของคุณดำเนินต่อเมื่อ node รอได้รับการเรียก HTTP

URL ของ webhook ที่ดำเนินการต่อเมื่อมีการเรียกนั้นถูกสร้างขึ้นที่รันไทม์ node รอจัดเตรียมไฟล์ $execution.resumeUrl ตัวแปรเพื่อให้คุณสามารถอ้างอิงและส่ง URL ที่ยังไม่ได้สร้างได้ทุกที่ที่จำเป็น เช่น ไปยังบริการของบุคคลที่สามหรือในอีเมล

เมื่อ workflow ดำเนินการ node รอจะสร้าง URL ดำเนินการต่อและ webhook ใน workflow ของคุณโดยใช้ $execution.resumeUrl . URL ที่สร้างขึ้นนี้ไม่ซ้ำกันในการดำเนินการแต่ละครั้ง ดังนั้น workflow ของคุณจึงสามารถมี node รอได้หลาย node และเมื่อมีการเรียก URL ของ webhook URL จะดำเนินการแต่ละ node รอต่อตามลำดับ

สำหรับสิ่งนี้ Resume style ตั้งค่า parameter เพิ่มเติมตามรายการด้านล่าง

Authentication

เลือกว่าจะส่งคำขอ resume-webhook-request เข้ามาหรือไม่และอย่างไร $execution.resumeUrl ควรได้รับการรับรองความถูกต้อง ตัวเลือกได้แก่:

• Basic Auth : ใช้การรับรองความถูกต้องขั้นพื้นฐาน เลือกหรือป้อนใหม่ Credential for Basic Auth ที่จะใช้
• Header Auth : ใช้การรับรองความถูกต้องส่วนหัว เลือกหรือป้อนใหม่ Credential for Header Auth ที่จะใช้
• JWT Auth : ใช้การรับรองความถูกต้อง JWT เลือกหรือป้อนใหม่ Credential for JWT Auth ที่จะใช้
• None : อย่าใช้การรับรองความถูกต้อง

การอ้างอิงการรับรองความถูกต้อง (Auth reference)

อ้างถึง node Webhook | เอกสารรับรองความถูกต้อง สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์แต่ละประเภท

HTTP Method

เลือกวิธี HTTP ที่ webhook ควรใช้ อ้างถึง node Webhook | เอกสารประกอบวิธี HTTP สำหรับข้อมูลเพิ่มเติม

Response Code

ป้อนรหัสตอบกลับที่ webhook ควรส่งคืน คุณสามารถใช้รหัสทั่วไปหรือป้อนรหัสที่กำหนดเองได้

Respond

กำหนดเวลาและวิธีตอบสนองต่อ webhook จากตัวเลือกเหล่านี้:

• Immediately : ตอบสนองทันทีที่ node ดำเนินการ
• When Last Node Finishes : ส่งคืนโค้ดตอบกลับและ output ข้อมูลจาก node สุดท้ายที่ดำเนินการใน workflow หากคุณเลือกตัวเลือกนี้ ให้ตั้งค่า:
  • Response Data : เลือกข้อมูลที่ควรส่งคืนและรูปแบบที่จะใช้ ตัวเลือกได้แก่:
    • All Entries : ส่งคืนรายการทั้งหมดของ node สุดท้ายใน array
    • First Entry JSON : ส่งคืนข้อมูล JSON ของรายการแรกของ node สุดท้ายใน object JSON
    • First Entry Binary : ส่งคืนข้อมูลไบนารีของรายการแรกของ node สุดท้ายในไฟล์ไบนารี
    • No Response Body : กลับมาแบบไร้ร่าง
• Using 'Respond to Webhook' Node : ตอบสนองตามที่กำหนดไว้ใน Respond to Webhook node

Limit Wait Time

ตั้งค่าว่า workflow จะกลับมาดำเนินการโดยอัตโนมัติหลังจากประเภทขีดจำกัดเฉพาะ (เปิด) หรือไม่ (ปิด) หากเปิดอยู่ ให้ตั้งค่า:

• Limit Type : เลือกประเภทของขีดจำกัดที่จะบังคับใช้จากตัวเลือกเหล่านี้:
  • After Time Interval : รอสักระยะหนึ่ง
    • ป้อนขีดจำกัด Amount ของเวลา
    • เลือกขีดจำกัด Unit ของเวลา
  • At Specified Time : รอจนถึงวันที่และเวลาที่ระบุเพื่อดำเนินการต่อ
    • Max Date and Time : ใช้ตัวเลือกวันที่และเวลาเพื่อตั้งเวลาที่ระบุที่ node ควรดำเนินการต่อ

บนตัวเลือกการโทรของ Webhook (On Webhook Call options)

• Binary Property : ป้อนชื่อของคุณสมบัติไบนารี่เพื่อเขียนข้อมูลของไฟล์ที่ได้รับ ตัวเลือกนี้จะเกี่ยวข้องเฉพาะเมื่อได้รับข้อมูลไบนารีเท่านั้น
• Ignore Bots : ตั้งค่าว่าจะเพิกเฉยต่อคำขอจากบอท เช่น โปรแกรมดูตัวอย่างลิงก์และโปรแกรมรวบรวมข้อมูลเว็บ (เปิด) หรือไม่ (ปิด)
• IP(s) Whitelist : ป้อนที่อยู่ IP ที่นี่เพื่อจำกัดใคร (หรืออะไร) ที่สามารถเรียกใช้ URL ของ webhook ป้อนรายการที่อยู่ IP ที่อนุญาตโดยคั่นด้วยเครื่องหมายจุลภาค การเข้าถึงจาก IP นอกรายการที่อนุญาตทำให้เกิดข้อผิดพลาด 403 หากเว้นว่างไว้ ที่อยู่ IP ทั้งหมดจะเรียกใช้ URL ของ webhook ได้
• No Response Body : ตั้งค่าว่า n8n ควรส่งเนื้อหาในการตอบกลับ (ปิด) หรือป้องกันไม่ให้ n8n ส่งเนื้อหาในการตอบกลับ (เปิด)
• Raw Body : ตั้งค่าว่าจะส่งคืนเนื้อหาในรูปแบบ Raw เช่น JSON หรือ XML (เปิดอยู่) หรือไม่ (ปิดอยู่)
• Response Data : ป้อนข้อมูลที่กำหนดเองที่คุณต้องการส่งในการตอบกลับ
• Response Headers : ส่งส่วนหัวเพิ่มเติมในการตอบกลับของ webhook อ้างถึง เอกสารเว็บ MDN | ส่วนหัวของการตอบกลับ เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับส่วนหัวการตอบกลับ
• Webhook Suffix : ป้อนส่วนต่อท้ายเพื่อต่อท้าย URL ประวัติย่อ สิ่งนี้มีประโยชน์สำหรับการสร้าง URL ของ webhook ที่ไม่ซ้ำกันสำหรับแต่ละ node Wait เมื่อ workflow มี node Wait หลาย node โปรดทราบว่าที่สร้างขึ้น $resumeWebhookUrl จะไม่รวมส่วนต่อท้ายนี้โดยอัตโนมัติ คุณต้องเพิ่มต่อท้าย URL ของ webhook ด้วยตนเองก่อนที่จะเปิดเผย

บนข้อจำกัดการโทรของ Webhook (On Webhook Call limitations)

มีข้อจำกัดบางประการที่ควรคำนึงถึงเมื่อใช้ On Webhook Call:

• การดำเนินการบางส่วนของ workflow ของคุณเปลี่ยนแปลง $resumeWebhookUrl ดังนั้นโปรดตรวจสอบให้แน่ใจว่า node ที่ส่ง URL นี้ไปยังบุคคลที่สามที่คุณต้องการจะทำงานในการดำเนินการเดียวกันกับ node รอ

On Form Submitted

รอการส่งแบบฟอร์มก่อนดำเนินการต่อ ตั้งค่า parameter เหล่านี้:

Form Title

ป้อนชื่อที่จะแสดงที่ด้านบนของแบบฟอร์ม

Form Description

ป้อนคำอธิบายแบบฟอร์มเพื่อแสดงใต้ชื่อ คำอธิบายนี้สามารถช่วยแจ้งให้ผู้ใช้ทราบถึงวิธีการกรอกแบบฟอร์ม

Form Fields

ตั้งค่าแต่ละฟิลด์ที่คุณต้องการให้ปรากฏในแบบฟอร์มของคุณโดยใช้ parameter เหล่านี้:

• Field Label : กรอกป้ายกำกับฟิลด์ที่คุณต้องการให้ปรากฏในแบบฟอร์ม
• Field Type : เลือกประเภทของฟิลด์ที่จะแสดงในแบบฟอร์ม เลือกจาก:
  • Date
  • Dropdown List : ป้อนตัวเลือกแบบเลื่อนลงแต่ละรายการใน Field Options.
    • Multiple Choice : เลือกว่าผู้ใช้สามารถเลือกตัวเลือกแบบเลื่อนลงเดียว (ปิด) หรือหลายตัวเลือกแบบเลื่อนลง (เปิด)
  • Number
  • Password
  • Text
  • Textarea
• Required Field : ตั้งค่าว่าผู้ใช้จะต้องกรอกข้อมูลในช่องนี้เพื่อส่งแบบฟอร์ม (เปิด) หรือผู้ใช้สามารถส่งแบบฟอร์มโดยไม่ต้องกรอกหรือไม่ (ปิด)

Respond When

กำหนดเวลาที่จะตอบกลับการส่งแบบฟอร์ม เลือกจาก:

• Form Is Submitted : ตอบกลับทันทีที่ node นี้ได้รับการส่งแบบฟอร์ม
• Workflow Finishes : ตอบสนองเมื่อ node สุดท้ายของ workflow นี้เสร็จสิ้น
• Using 'Respond to Webhook' Node : ตอบกลับเมื่อ Respond to Webhook node ดำเนินการ

Limit Wait Time

ตั้งค่าว่า workflow จะกลับมาดำเนินการโดยอัตโนมัติหลังจากประเภทขีดจำกัดเฉพาะ (เปิด) หรือไม่ (ปิด)

หากเปิดอยู่ ให้ตั้งค่า:

• Limit Type : เลือกประเภทของขีดจำกัดที่จะบังคับใช้จากตัวเลือกเหล่านี้:
  • After Time Interval : รอสักระยะหนึ่ง
    • ป้อนขีดจำกัด Amount ของเวลา
    • เลือกขีดจำกัด Unit ของเวลา
  • At Specified Time : รอจนถึงวันที่และเวลาที่ระบุเพื่อดำเนินการต่อ
    • Max Date and Time : ใช้ตัวเลือกวันที่และเวลาเพื่อตั้งเวลาที่ระบุที่ node ควรดำเนินการต่อ

ในตัวเลือกการตอบกลับแบบฟอร์ม (On Form Response options)

• Form Response : เลือกวิธีการและสิ่งที่คุณต้องการให้แบบฟอร์ม Respond With จากตัวเลือกเหล่านี้:
  • Form Submitted Text : แบบฟอร์มจะแสดงข้อความใดก็ตามที่ป้อน Text to Show หลังจากที่ผู้ใช้กรอกแบบฟอร์มแล้ว ใช้ตัวเลือกนี้หากคุณต้องการแสดงข้อความยืนยัน
  • Redirect URL : แบบฟอร์มจะเปลี่ยนเส้นทางผู้ใช้ไปยัง URL to Redirect to หลังจากที่กรอกแบบฟอร์มแล้ว นี่ต้องเป็น URL ที่ถูกต้อง
• Webhook Suffix : ป้อนส่วนต่อท้ายเพื่อต่อท้าย URL ประวัติย่อ สิ่งนี้มีประโยชน์สำหรับการสร้าง URL ของ webhook ที่ไม่ซ้ำกันสำหรับแต่ละ node Wait เมื่อ workflow มี node Wait หลาย node โปรดทราบว่าที่สร้างขึ้น $resumeWebhookUrl จะไม่รวมส่วนต่อท้ายนี้โดยอัตโนมัติ คุณต้องเพิ่มต่อท้าย URL ของ webhook ด้วยตนเองก่อนที่จะเปิดเผย

เทมเพลตและตัวอย่าง

เรียกดูเทมเพลตการรวม Wait หรือ ค้นหาเทมเพลตทั้งหมด

การดำเนินการตามเวลา

สำหรับการดำเนินการเรซูเม่ตามเวลา โปรดทราบว่า:

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