วิธีตั้งค่า Webhook ใน Frappe/ERPNext เชื่อมต่อ Line, Shopee และระบบภายนอก

วิธี	ข้อดี	ข้อเสีย
Webhook (Push)	Real-time, ประหยัด resource	ต้องมี endpoint รับข้อมูล
API Polling (Pull)	ง่าย, ไม่ต้องมี server	ช้า, สิ้นเปลือง bandwidth

Field	คำอธิบาย	ตัวอย่าง
DocType	Document ที่ต้องการ track	`Sales Invoice`
Document Event	Event ที่ trigger webhook	`on_submit`
Request URL	URL ปลายทาง	`https://api.example.com/webhook`
Request Method	HTTP method	`POST`
Enabled	เปิด/ปิด webhook	✅

Event	เมื่อไหร่	Use Case
`after_insert`	หลังสร้าง document ใหม่	แจ้งเตือน Line เมื่อมี Lead ใหม่
`on_update`	หลังบันทึก (save)	Sync ข้อมูลลูกค้าไป CRM
`on_submit`	หลัง submit document	ส่ง invoice ไป accounting system
`on_cancel`	หลัง cancel document	ยกเลิก order ใน Shopee
`on_trash`	หลังลบ document	Cleanup ข้อมูลในระบบภายนอก
`on_update_after_submit`	หลังแก้ไข submitted doc	อัพเดทสถานะ delivery
`on_change`	เมื่อ field เปลี่ยน	Track status changes

python

# ส่งเฉพาะ invoice ที่มูลค่ามากกว่า 10,000 บาท
doc.grand_total > 10000
 
# ส่งเฉพาะ invoice ของลูกค้ากลุ่ม VIP
doc.customer_group == "VIP"
 
# ส่งเฉพาะเมื่อ status เปลี่ยนเป็น Paid
doc.status == "Paid"

Key	Fieldname
`invoice_name`	`name`
`customer`	`customer`
`total`	`grand_total`
`currency`	`currency`

Key	Value
`Content-Type`	`application/json`
`Authorization`	`Bearer your-api-token`
`X-Source`	`erpnext`

python

# ฝั่งรับ — verify webhook signature (Python example)
import hmac
import hashlib
import base64
 
def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = base64.b64encode(
        hmac.new(
            secret.encode(),
            payload,
            hashlib.sha256
        ).digest()
    ).decode()
    return hmac.compare_digest(expected, signature)

Field	Value
DocType	Sales Invoice
Document Event	on_submit
Request URL	`https://notify-api.line.me/api/notify`
Request Method	POST

Key	Value
`Authorization`	`Bearer YOUR_LINE_NOTIFY_TOKEN`
`Content-Type`	`application/x-www-form-urlencoded`

Key	Value
`message`	`\nใบแจ้งหนี้ใหม่: {{ doc.name }}\nลูกค้า: {{ doc.customer }}\nยอดรวม: ฿{{ doc.grand_total }}`

Status	สาเหตุ	วิธีแก้
400	JSON format ผิด	ตรวจ Jinja template, ใช้ `{{ doc.field \| tojson }}` สำหรับ string ที่มี special characters
401	Auth ไม่ถูกต้อง	ตรวจ Authorization header
403	IP ถูก block	เพิ่ม server IP ใน allowlist ฝั่งรับ
500	Server error ฝั่งรับ	ตรวจ log ฝั่งรับ
504	Timeout	ฝั่งรับ process นานเกินไป, ใช้ queue

json

{
  "event": "invoice_submitted",
  "invoice": "{{ doc.name }}",
  "customer": "{{ doc.customer }}",
  "grand_total": {{ doc.grand_total }},
  "currency": "{{ doc.currency }}",
  "items": [
    {% for item in doc.items %}
    {
      "item_code": "{{ item.item_code }}",
      "qty": {{ item.qty }},
      "rate": {{ item.rate }}
    }{% if not loop.last %},{% endif %}
    {% endfor %}
  ],
  "submitted_at": "{{ frappe.utils.now() }}"
}

typescript

// ฝั่งรับ — verify webhook signature (Node.js/TypeScript)
import crypto from "node:crypto";
 
function verifyWebhook(payload: string, signature: string, secret: string): boolean {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(payload)
    .digest("base64");
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature),
  );
}

json

{
  "action": "stock_update",
  "entry": "{{ doc.name }}",
  "stock_entry_type": "{{ doc.stock_entry_type }}",
  "posting_date": "{{ doc.posting_date }}",
  "items": [
    {% for item in doc.items %}
    {
      "item_code": "{{ item.item_code }}",
      "qty": {{ item.qty }},
      "warehouse": "{{ item.t_warehouse or item.s_warehouse }}"
    }{% if not loop.last %},{% endif %}
    {% endfor %}
  ]
}

วิธีตั้งค่า Webhook ใน Frappe/ERPNext เชื่อมต่อ Line, Shopee และระบบภายนอก | Bunchee

วิธีตั้งค่า Webhook ใน Frappe/ERPNext เชื่อมต่อ Line, Shopee และระบบภายนอก

Webhook คืออะไร? (What are Webhooks?)

Webhook vs API Polling

ขั้นตอนตั้งค่า Webhook (Setup Steps)

ขั้นตอนที่ 1: สร้าง Webhook ใน Frappe

ขั้นตอนที่ 2: เลือก Document Event

ขั้นตอนที่ 3: กำหนด Condition (เงื่อนไข)

ขั้นตอนที่ 4: กำหนด Data Format

แบบ Form URL Encoded

แบบ JSON (แนะนำ)

ขั้นตอนที่ 5: ตั้งค่า Headers

Webhook Security

Webhook Secret

ตัวอย่างจริง: แจ้งเตือน Line OA (Real Example)

Use Case

ตั้งค่า Webhook

Headers

Data (Form URL Encoded)

ตัวอย่าง: Sync ไป External API (JSON)

Use Case

Webhook JSON Body

Webhook Request Logs

Troubleshooting

Webhook ไม่ trigger

Response 4xx/5xx

Jinja Template Error

คำถามที่พบบ่อย (FAQ)

Webhook ส่งซ้ำได้ไหม?

ใช้ Webhook กับ Custom DocType ได้ไหม?

มี rate limit ไหม?

Webhook ทำงานกับ Background Jobs ไหม?

พร้อมเชื่อมต่อ ERPNext กับระบบอื่นแล้วหรือยัง?

อ้างอิง (References)

ความคิดเห็น