ระบบส่งประกาศ & บรอดแคสต์

คุณเป็นผู้เชี่ยวชาญด้านการเชื่อมต่อ API กำลังพัฒนาระบบแจ้งเตือน Discord ผ่าน "MyWellnetPTN Discord Gateway" ของกองสาธารณสุข องค์การบริหารส่วนจังหวัดปัตตานี ระบบของเราต้องส่งการแจ้งเตือนสองทาง (Two-Way Interactive Notification) ให้เจ้าหน้าที่ผ่าน Discord โดยมีข้อมูลทางเทคนิคดังนี้: 1. การยืนยันตัวตน (Authentication): - ส่งผ่าน Header: X-Client-ID: [ใส่ Client ID ที่ได้จากแอดมิน] X-Client-Secret: [ใส่ Client Secret ที่ได้จากแอดมิน] Content-Type: application/json 2. Endpoint สำหรับส่งแจ้งเตือน: - URL: [APP_BASE_URL]/api/v1/notify (ยึดตามตัวแปร APP_BASE_URL ในไฟล์ .env) - Method: POST - ระบุผู้รับผ่าน target_citizen_id (เลขบัตร ปชช. 13 หลัก) หรือ target_email หรือ target_discord_id - ระบบปลายทางจะแปลงข้อมูลเป็น Discord User ID ผ่านฐานข้อมูล SSO ให้อัตโนมัติ 3. โครงสร้าง JSON Payload ตัวอย่าง: { "target_citizen_id": "1949900123456", "bot_id": "default", "embed": { "title": "🚨 แจ้งเตือนเคสระบาดวิทยาใหม่ (Epitrack)", "description": "พบผู้ป่วยสงสัยโรคไข้เลือดออก 1 ราย ในพื้นที่ รพ.สต.บานา", "color": "#EF4444", "fields": [ { "name": "รหัสเคส", "value": "EPI-2026-0042", "inline": true }, { "name": "ความรุนแรง", "value": "ระดับ 3 (เฝ้าระวังพิเศษ)", "inline": true }, { "name": "ผู้ป่วย", "value": "ชายไทย อายุ 24 ปี", "inline": false } ], "footer": { "text": "ระบบระบาดวิทยา Epitrack • กองสาธารณสุข อบจ.ปัตตานี" } }, "actions": [ { "label": "รับเคสนี้", "style": "SUCCESS", "action_id": "accept_case_0042", "emoji": "✅" }, { "label": "กรอกบันทึกการรักษา (Modal)", "style": "PRIMARY", "action_id": "modal_treatment", "emoji": "📝", "modal": { "title": "บันทึกข้อมูลการรักษาเบื้องต้น", "fields": [ { "id": "staff_name", "label": "ชื่อผู้บันทึก", "placeholder": "ระบุชื่อ-สกุล", "required": true }, { "id": "treatment_note", "label": "ผลการวินิจฉัย/การรักษา", "paragraph": true, "placeholder": "ระบุอาการและยาที่จ่าย...", "required": true }, { "id": "fever_temp", "label": "อุณหภูมิร่างกาย (°C)", "placeholder": "เช่น 38.5", "required": false } ] } }, { "label": "เปิดดูรายละเอียดเคส", "style": "LINK", "url": "https://epitrack.mywellnetptn.org/cases/0042", "emoji": "🔗" } ], "select_menu": { "id": "select_hospital", "placeholder": "🏥 เลือกหน่วยบริการที่ส่งต่อ...", "options": [ { "label": "รพ.สต. บานา", "value": "rpost_bana", "emoji": "🏥" }, { "label": "รพ.สต. ปะกาฮะรัง", "value": "rpost_pakaharang", "emoji": "🏥" } ] } } 4. การรับผลลัพธ์ผ่าน Webhook Callback (2-Way Interactive): เมื่อเจ้าหน้าที่กดปุ่ม, เลือกเมนูดรอปดาวน์, หรือกรอกข้อมูลส่งฟอร์ม Modal เกตเวย์จะยิง HTTP POST กลับมายัง webhook_url ที่ผูกไว้ พร้อม Header `X-Signature-SHA256` = HMAC-SHA256(payload_string, client_secret) ตัวอย่าง Payload ที่ส่งกลับ: { "event": "interaction.modal_submit", // หรือ "interaction.action" "tracking_id": "...", "client_id": "...", "action_id": "modal_treatment", "interaction_type": "MODAL_SUBMIT", // หรือ BUTTON, STRING_SELECT, USER_SELECT, ROLE_SELECT, CHANNEL_SELECT "user": { "discord_id": "...", "discord_tag": "username#0000", "citizen_id": "1949900123456", "full_name": "นายอาฟิฟ เจ๊ะแอ", "department_name": "กองสาธารณสุข อบจ.ปัตตานี", "position": "นักวิชาการสาธารณสุขชำนาญการ" }, "values": ["rpost_bana"], // รายการที่เลือกใน Dropdown "form_data": { // ข้อมูลที่กรอกใน Modal Form "staff_name": "นายอาฟิฟ เจ๊ะแอ", "treatment_note": "ให้ยาลดไข้ พาราเซตามอล นัดตรวจซ้ำ 2 วัน", "fever_temp": "38.5" }, "timestamp": 1728300000000 } หน้าที่ของคุณ: โปรดเขียนฟังก์ชันส่งแจ้งเตือนในระบบของเรา พร้อมรองรับทั้งปุ่ม Action, Modal Forms, Dropdowns และเขียนฟังก์ชันรับ Webhook ตรวจสอบ HMAC Signature ให้สมบูรณ์แบบ