Echobell Direct: แจ้งเตือนผ่าน Webhook ส่วนตัวโดยไม่ต้องตั้งค่าช่อง

สารบัญ

• Echobell Direct คืออะไร
• ตั้งค่าใน 3 ขั้นตอน
• ขั้นตอนที่ 1: สร้าง Direct key
• ขั้นตอนที่ 2: คัดลอก URL ของ webhook
• ขั้นตอนที่ 3: ส่งการแจ้งเตือนครั้งแรก
• ระดับความเร่งด่วน
• เพิ่มบริบทให้การแจ้งเตือน
• Direct เทียบกับช่อง
• แนวปฏิบัติด้านความปลอดภัย
• คำถามที่พบบ่อย
• เนื้อหาที่เกี่ยวข้อง

Echobell Direct คือโหมดแจ้งเตือนส่วนตัวที่ข้ามการตั้งค่าช่องไปทั้งหมด คุณสร้าง Direct key ขึ้นมา รับ URL ของ webhook แล้ว POST ค่า title + body เพื่อรับการแจ้งเตือนบนเครื่องของคุณทันที ไม่มีผู้ติดตาม ไม่มีเทมเพลต ไม่ต้องตั้งค่าเส้นทางการส่ง

คู่มือนี้ครอบคลุมว่า Direct คืออะไร ตั้งค่าอย่างไร และควรใช้แทนช่องเมื่อไร

Echobell Direct คืออะไร

Direct key แต่ละอันจะสร้าง URL ของ webhook เฉพาะตัว (/d/{token}) เมื่อส่งคำขอไปยัง URL นั้น การแจ้งเตือนจะมาถึงเครื่องของคุณทันที

ใช้ Direct เมื่อคุณต้องการ:

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

หากคุณต้องการการแจ้งเตือนที่แชร์ร่วมกัน เทมเพลตที่นำกลับมาใช้ซ้ำได้ หรือการส่งแบบมีเงื่อนไข ให้ใช้ช่องผ่าน Webhook แทน

ตั้งค่าใน 3 ขั้นตอน

ขั้นตอนที่ 1: สร้าง Direct key

เปิด Echobell แตะ Direct ในรายการช่องของคุณ แล้วสร้าง key ขึ้นมา ตั้งชื่อตามบริการที่มันสังกัดอยู่ (เช่น CI Server, Cron, AI Tasks)

ขั้นตอนที่ 2: คัดลอก URL ของ webhook

แต่ละ key จะมี URL ในรูปแบบนี้:

https://hook.echobell.one/d/YOUR_KEY_TOKEN

ให้ถือว่า URL นี้เป็นความลับ เพราะใครก็ตามที่มีมันสามารถส่งการแจ้งเตือนถึงคุณได้

ขั้นตอนที่ 3: ส่งการแจ้งเตือนครั้งแรก

curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy failed",
    "body": "api-service failed health check",
    "notificationType": "time-sensitive",
    "externalLink": "https://dashboard.example.com/deploys/123"
  }'

ดูรายการฟิลด์ทั้งหมดได้ที่: Direct API

ระดับความเร่งด่วน

Direct รองรับ notificationType เพื่อให้คุณจับคู่ความเร่งด่วนกับเหตุการณ์ได้:

• active — อัปเดตทั่วไป
• time-sensitive — การแจ้งเตือนสำคัญที่ทะลุโหมดโฟกัสได้
• calling — เหตุการณ์วิกฤต (ต้องมีการสมัครสมาชิก premium ที่ยังใช้งานอยู่ มิฉะนั้นจะลดระดับเป็น time-sensitive)

ดูรายละเอียดพฤติกรรมทั้งหมดได้ที่ประเภทการแจ้งเตือน

เพิ่มบริบทให้การแจ้งเตือน

ใส่ externalLink ลงใน body ของคำขอเพื่อแนบ URL ไปกับการแจ้งเตือน ซึ่งมีประโยชน์เมื่อต้องการลิงก์ตรงไปยังบันทึกการดีพลอย แดชบอร์ด หรือ pull request

สำหรับเอเจนต์ AI และงานแบบอะซิงโครนัสที่ใช้เวลานาน Direct เป็นวิธีตรงไปตรงมาในการรับแจ้งเมื่องานเสร็จ แทนที่จะคอยเช็กเอง ดูเพิ่มเติมที่: WebhookMCP + Echobell

Direct เทียบกับช่อง

ใช้ช่องเมื่อการแจ้งเตือนต้องไปถึงหลายคน หรือเมื่อคุณต้องการรูปแบบข้อความที่สม่ำเสมอทั้งบริการ เอกสารเทมเพลต · Echobell คืออะไร

แนวปฏิบัติด้านความปลอดภัย

• เก็บโทเคนของ Direct ไว้ในตัวแปรสภาพแวดล้อมหรือตัวจัดการ secret ไม่ใช่ในโค้ด
• สร้างหนึ่ง key ต่อหนึ่งบริการ เพื่อให้เพิกถอนแยกกันได้
• หมุนเปลี่ยนโทเคนทันทีหาก URL อาจรั่วไหล
• สงวน calling ไว้ให้เหตุการณ์จริง ๆ เพราะการใช้พร่ำเพรื่อทำให้เกิดอาการล้าจากการแจ้งเตือน

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

Direct มีไว้สำหรับนักพัฒนาเท่านั้นหรือเปล่า? ไม่ใช่ ใครก็ตามที่มีเครื่องมือที่ส่งคำขอ HTTP ได้ก็ใช้ได้

Direct รองรับคำขอ GET ไหม? รองรับ แต่แนะนำให้ใช้ POST พร้อม JSON

ถ้าการสมัครสมาชิกหมดอายุแล้วผมใช้ calling จะเกิดอะไรขึ้น? ระบบจะลดระดับเป็น time-sensitive ให้อัตโนมัติ

---

เริ่มต้นที่คู่มือ Direct และเมื่อเวิร์กโฟลว์ของคุณโตจนต้องทำงานร่วมกันหรือใช้เทมเพลต ช่องก็เป็นก้าวถัดไปที่ตรงไปตรงมา

เนื้อหาที่เกี่ยวข้อง

• เอกสาร Direct API — รายการฟิลด์และตัวอย่างทั้งหมด
• WebhookMCP + Echobell — การแจ้งเตือนเมื่องาน AI เสร็จ โดยใช้ Direct
• วิธีทะลุโหมดโฟกัสของ iOS — เลือกระดับความเร่งด่วนให้เหมาะสม
• การแจ้งเตือนผ่าน webhook ของ Zapier — เวิร์กโฟลว์อัตโนมัติสำหรับผู้ที่ไม่ใช่นักพัฒนา
• ประเภทการแจ้งเตือน — พฤติกรรมของแบบปกติ สำคัญตามเวลา และโทรเข้า