จัดการ Incoming Webhooks

ภาพรวม

นี้ จัดการ Webhook ขาเข้า ทริกเกอร์นี้ใช้เริ่ม Flow เมื่อมีการส่งข้อมูลไปยัง Zaapi จากระบบภายนอก เช่น แพลตฟอร์มอีคอมเมิร์ซ, CRM หรือเครื่องมือของบุคคลที่สาม

เมื่อระบบภายนอกส่ง คำขอ POST ไปยัง URL webhook ของ Flow Zaapi จะรับข้อมูลนั้น ทำให้ใช้งานเป็นตัวแปรภายใน Flow ได้ และดำเนินขั้นตอนถัดไปต่อโดยอัตโนมัติ (เช่น ส่งข้อความ หรือค้นหาติดต่อ)

เหมาะอย่างยิ่งสำหรับการทำงานอัตโนมัติของเวิร์กโฟลว์ที่ขึ้นอยู่กับเหตุการณ์ภายนอก — เช่น เมื่อมีการสั่งซื้อ ยืนยันการชำระเงิน หรืออัปเดตทิกเก็ตซัพพอร์ต

---

ทำงานอย่างไร

1. URL ของ Webhook ทุก Flow ที่ใช้ทริกเกอร์นี้จะได้รับ webhook URL เฉพาะของตัวเอง ตัวอย่าง:

   https://webhooks.zaapi.co/triggers/g8Yvbr0paWV9Fi5lWbEQ

   สามารถส่งคำขอ คำขอ POST ไปยัง URL นี้จากระบบภายนอกได้

2. ข้อมูลตัวอย่าง สามารถกำหนดตัวอย่าง JSON payload เพื่อระบุว่าต้องให้ Zaapi ดึงตัวแปรใดบ้าง ตัวอย่าง:

   {
     "customer_name": "Jane Doe",
     "phone_number": "[phone]",
     "order_number": "ORD12345",
     "total_amount": 2500
   }

   เมื่อบันทึกแล้ว ช่องข้อมูลเหล่านี้จะแสดงเป็น ตัวแปร ที่สามารถอ้างอิงได้ในขั้นตอนถัดไปของ Flow

3. การแมปตัวแปร หลังจากกำหนด JSON ตัวอย่างแล้ว Zaapi จะตรวจจับชื่อตัวแปร (keys) อัตโนมัติ และเปิดให้ใช้งานในเวิร์กโฟลว์ ตัวอย่างการใช้งาน:

   • {{customer_name}}

   • {{order_number}}

   • {{total_amount}}

4. โหนดค้นหาติดต่อ Zaapi ยังมี ค้นหาติดต่อ โหนดที่ช่วยค้นหาลูกค้าที่มีอยู่ในบัญชีจากข้อมูล webhook ขาเข้า (เช่น อีเมลหรือหมายเลขโทรศัพท์) ช่วยเชื่อมเหตุการณ์ภายนอก (เช่น คำสั่งซื้อใหม่) ไปยังลูกค้าที่ถูกต้องใน Zaapi อัตโนมัติ

---

ตัวอย่างการใช้งาน: ส่งข้อความ WhatsApp หลังมีการสั่งซื้อ

ตัวอย่างการใช้ทริกเกอร์นี้:

1. ในแพลตฟอร์มอีคอมเมิร์ซ, ตั้งค่า webhook เพื่อส่งข้อมูลคำสั่งซื้อไปยัง Zaapi ทุกครั้งที่มีการสั่งซื้อใหม่ payload อาจมีลักษณะดังนี้:

   {
     "customer_name": "Jane Doe",
     "phone_number": "[phone]",
     "order_number": "ORD12345",
     "total_amount": 2500
   }

2. ใน Zaapi Flow Builder:

   • เพิ่ม Webhook ที่ได้รับ ทริกเกอร์.

   • วาง JSON payload ตัวอย่างด้านบนเพื่อกำหนดค่าตัวแปร.

   • เพิ่ม ค้นหาติดต่อ โหนดเพื่อค้นหาลูกค้าใน Zaapi จาก phone_number.

   • จากนั้นเพิ่ม ส่งข้อความ WhatsApp โหนด และเลือกข้อความเทมเพลต WhatsApp สามารถปรับแต่งข้อความด้วยตัวแปร เช่น:

     สวัสดี {{customer_name}} ขอบคุณสำหรับคำสั่งซื้อ! 🎉  
     หมายเลขคำสั่งซื้อคือ {{order_number}} และมียอดรวม {{total_amount}} THB.  
     จะอัปเดตให้เมื่อจัดส่งแล้ว!

3. ทดสอบและเผยแพร่ Flow. ทุกครั้งที่ร้านค้าส่ง order webhook, Zaapi จะเริ่ม Flow นี้อัตโนมัติ และส่งข้อความเฉพาะบุคคลไปยังลูกค้าที่ถูกต้อง

---

เคล็ดลับ

• ตรวจสอบให้แน่ใจเสมอว่า webhook URL ถูกเก็บไว้ ส่วนตัว — ผู้ที่มีลิงก์สามารถส่งข้อมูลไปยัง Flow ได้.

• สามารถ ทดสอบ webhook ได้โดยส่งคำขอ POST จากเครื่องมือ เช่น Postman หรือ cURL.

• เก็บข้อมูลตัวอย่างให้เรียบง่ายและสอดคล้องกับ payload จริง เพื่อให้การแมปตัวแปรทำงานได้ถูกต้อง.

• สามารถต่อขั้นตอนเพิ่มเติมหลังรับ webhook ได้ เช่น อัปเดตระเบียน CRM ติดแท็กรายการติดต่อ หรือแจ้งเจ้าหน้าที่ซัพพอร์ต.