Handle Incoming Webhooks

บทความนี้อธิบายการใช้ Trigger Handle Incoming Webhook เพื่อเชื่อมต่อ Zaapi กับระบบภายนอก และเริ่ม Flow อัตโนมัติเมื่อมีข้อมูลถูกส่งเข้ามา

ภาพรวม

Trigger Handle Incoming Webhook ใช้สำหรับเริ่มต้น Flow เมื่อมีข้อมูลถูกส่งเข้ามาที่ Zaapi จากระบบภายนอก เช่น ระบบ eCommerce, CRM หรือเครื่องมือ Third-party อื่น ๆ

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

ฟีเจอร์นี้มีประโยชน์มากสำหรับงานอัตโนมัติที่ต้องอิงกับเหตุการณ์จากระบบอื่น เช่น เมื่อมีการสั่งซื้อใหม่, การยืนยันการชำระเงิน หรือการอัปเดต Ticket ซัพพอร์ต

---

วิธีการทำงาน

Webhook URL

ทุก Flow ที่ใช้ Trigger นี้จะมี Webhook URL เฉพาะของตัวเอง ตัวอย่าง:

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

คุณสามารถส่ง POST request มายังลิงก์นี้จากระบบภายนอกของคุณได้ทันที

ตัวอย่างข้อมูล (Example Data)

คุณสามารถกำหนด JSON payload ตัวอย่าง เพื่อบอก Zaapi ว่าต้องการดึงตัวแปรใดบ้าง ตัวอย่าง:

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

เมื่อบันทึกแล้ว ฟิลด์เหล่านี้จะกลายเป็นตัวแปรให้ใช้งานในขั้นตอนต่าง ๆ ของ Flow

---

Variables Mapping

หลังจากกำหนด JSON ตัวอย่าง Zaapi จะตรวจจับชื่อ key ให้อัตโนมัติ และทำให้คุณสามารถใช้เป็นตัวแปรใน Flow ได้ เช่น:

• {{customer_name}}

• {{order_number}}

• {{total_amount}}

---

Search Contact Node

Zaapi มี Search Contact Node เพื่อค้นหาลูกค้าที่มีอยู่ในระบบ ผ่านข้อมูลที่ส่งมาจาก webhook (เช่น email หรือเบอร์โทร) ช่วยให้เชื่อมโยงเหตุการณ์ภายนอก เช่น “มีออเดอร์ใหม่” กับลูกค้าคนที่ถูกต้องใน Zaapi โดยอัตโนมัติ

---

ตัวอย่างการใช้งาน: ส่ง WhatsApp หลังมีออเดอร์ใหม่

ตัวอย่าง Flow:

1. ตั้งค่าในระบบ eCommerce

ตั้ง Webhook ให้ระบบส่งข้อมูลออเดอร์มายัง Zaapi ทุกครั้งที่มีออเดอร์ใหม่ ตัวอย่าง payload:

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

2. ตั้งค่าใน Zaapi Flow Builder

• เพิ่ม Trigger: Webhook received

• วาง JSON ตัวอย่างเพื่อสร้างตัวแปร

• เพิ่ม Search Contact เพื่อค้นหาลูกค้าด้วย phone_number

• เพิ่ม Send WhatsApp Message และเลือก Template

• ใช้ตัวแปรเพิ่มความ Personal เช่น:

Hi {{customer_name}}, thanks for your order! 🎉  
Your order number is {{order_number}} with a total of {{total_amount}} THB.  
We'll update you once it’s shipped!

เมื่อทดสอบและ Publish แล้ว ทุกครั้งที่ร้านส่ง Order webhook — Zaapi จะ Trigger Flow และส่งข้อความไปหาลูกค้าที่ถูกต้องแบบอัตโนมัติ

---

เคล็ดลับ

• เก็บ Webhook URL ไว้เป็นความลับ — ใครที่มีลิงก์สามารถส่งข้อมูลเข้า Flow ได้

• สามารถทดสอบโดยส่ง POST ผ่าน Postman หรือ cURL

• ใช้ Example Data ที่เรียบง่ายและใกล้เคียงของจริง เพื่อให้ Mapping แม่นยำ

• คุณสามารถต่อยอด Flow ได้ เช่น อัปเดต CRM, ใส่ Tag ลูกค้า หรือแจ้งทีม Support