> For the complete documentation index, see [llms.txt](https://help.zaapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zaapi.com/th/flow-builder/trigger-nodes/incoming-webhooks.md).

# จัดการ 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 ดึงตัวแปรใดบ้าง\
   ตัวอย่าง:

   ```json
   {
     "customer_name": "Jane Doe",
     "phone_number": "+66912345678",
     "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 อาจมีลักษณะดังนี้:

   ```json
   {
     "customer_name": "Jane Doe",
     "phone_number": "+66912345678",
     "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 ติดแท็กรายการติดต่อ หรือแจ้งเจ้าหน้าที่ซัพพอร์ต.