การแจ้งเตือน

@easy-cms/plugin-notify ส่งข้อความสั้น ๆ ไปยังแชตสำหรับ event ที่ผู้ดูแลเลือก พร้อมลิงก์ไปยังหน้านั้นใน admin เริ่มจาก Telegram และออกแบบไว้ให้เพิ่มช่องทางอื่น (LINE, Slack, Discord) ได้ภายหลัง

npm install @easy-cms/plugin-notify

pnpm add @easy-cms/plugin-notify

yarn add @easy-cms/plugin-notify

bun add @easy-cms/plugin-notify

import { notifyPlugin } from '@easy-cms/plugin-notify'
 
export default defineConfig({
  serverURL: 'https://example.com', // สำหรับลิงก์ไปยัง admin
  // …
  plugins: [notifyPlugin()],
})

plugin เพิ่ม collection notify-messages (คิวของมัน ไม่แสดงใน admin) และงานตั้งเวลาหนึ่งงาน ให้สร้าง migration (easy-cms migrate:create notify ดู Migrations) และต้องมีอะไรสักอย่างรันงานตั้งเวลา ไม่ว่าจะเป็นเซิร์ฟเวอร์หรือ cron (งานตั้งเวลา)

เชื่อม Telegram

1. ใน Telegram คุยกับ @BotFather: /newbot แล้วคัดลอก token ที่ได้
2. ส่งข้อความหาบอทใหม่ หรือเพิ่มบอทเข้ากลุ่มที่จะรับข้อความ
3. ใน admin ไปที่ Settings → การเชื่อมต่อ → Telegram → เชื่อมบัญชี วาง Bot token กด ค้นหา Chat ID แล้วเลือกแชต
4. เลือก ภาษา ของข้อความ (ถ้าว่าง: ภาษาของ admin) และ เหตุการณ์ (ถ้าไม่เลือก: ทั้งหมด) แล้ว บันทึก Easy CMS จะส่งข้อความทดสอบไปที่แชต และปุ่ม ทดสอบ ส่งอีกครั้งได้

เชื่อมได้หลายแชต (ทีมร้านค้าสำหรับคำสั่งซื้อ ทีมนักพัฒนาสำหรับข้อผิดพลาด) แต่ละแชตได้รับเฉพาะ event ที่ติ๊กไว้ TELEGRAM_BOT_TOKEN ใน environment จะใช้แทน token ที่กรอกใน admin

Event

event เหล่านี้คือ event ข้อผิดพลาด ที่ webhook รับได้ด้วย

การส่ง

ข้อความส่งทันที ถ้าส่งไม่สำเร็จ งาน notify:send จะลองใหม่หลัง 1, 5 และ 30 นาที หลังจากนั้นจะเลิกส่ง และการเชื่อมต่อจะแสดงข้อผิดพลาดในหน้าการเชื่อมต่อและแดชบอร์ด token ผิดหรือแชตที่บอทออกไปแล้วจะไม่ลองซ้ำ

การเชื่อมต่อหนึ่งส่งได้ไม่เกิน 60 ข้อความต่อชั่วโมง (limit) ข้อความที่เกินจะถูกนับไว้ แล้วแชตจะได้ข้อความเดียว บอกจำนวน เมื่อชั่วโมงถัดไปเปิดให้ส่งได้ ข้อความที่ส่งแล้วเก็บไว้ 7 วัน

ตัวเลือก

ขั้นต่อไป

• การเชื่อมต่อ: การเชื่อมต่อ secret และแดชบอร์ด
• Webhooks: cms.on และ listeners สำหรับ event ของคุณเอง