npm package: @klongchu/n8n-nodes-budhosp-moph-alert
Description: BUDHOSP MOPH Alert Node for n8n
Author: Klongchu Dev
Latest version: 1.0.3

# @klongchu/n8n-nodes-budhosp-moph-alert

![n8n](https://img.shields.io/badge/n8n-community-FE47A1)
![npm](https://img.shields.io/npm/v/@klongchu/n8n-nodes-budhosp-moph-alert)
![License](https://img.shields.io/badge/license-MIT-blue.svg)

Node สำหรับ n8n ที่ใช้ในการส่งข้อความแจ้งเตือนผ่านระบบ BUDHOSP Moph Alert API

## 🌟 ความสามารถ

- 🚨 ส่งข้อความแจ้งเตือนผ่าน BUDHOSP Moph Alert API
- 🔐 รองรับการ Authentication ด้วย Bearer Token
- 📱 รองรับการส่งข้อมูลด้วยหมายเลขบัตรประชาชน (CID)
- ⚡ ตรวจสอบความถูกต้องของข้อมูลก่อนส่ง
- 🛡️ รองรับ CSRF Token เพื่อความปลอดภัย

## 📦 การติดตั้ง

### ติดตั้งผ่าน npm

```bash
npm install @klongchu/n8n-nodes-budhosp-moph-alert
```

### ติดตั้งใน n8n Cloud/Desktop

1. เข้าไปที่ **Settings** > **Community Nodes**
2. ใส่ `@klongchu/n8n-nodes-budhosp-moph-alert` ในช่อง **Package to install**
3. คลิก **Install**
4. รีสตาร์ท n8n

### ติดตั้งจาก Source Code

```bash
# Clone repository
git clone https://github.com/klongchu/n8n-nodes-budhosp-moph-alert.git
cd n8n-nodes-budhosp-moph-alert

# Install dependencies
npm install

# Build
npm run build

# Link for local development
npm link
```

## 🚀 การใช้งาน

### 1. การตั้งค่า Credentials

1. ไปที่ **Credentials** > **Create New**
2. เลือก **BUDHOSP Moph API**
3. กรอกข้อมูลต่อไปนี้:
   - **Bearer Token**: Token ที่ได้รับจากระบบ BUDHOSP
   - **API Base URL**: `https://api-gateway.budhosp.com/api/v1/moph/alert` (default)
   - **CSRF Token**: Token สำหรับความปลอดภัย (ถ้าจำเป็น)
4. **Test** และ **Save** credentials

### 2. การใช้งาน Node

1. เพิ่ม **BUDHOSP Moph Alert** node ใน workflow
2. เลือก **Operation**: `Send Alert`
3. เลือก **Credentials** ที่สร้างไว้
4. กรอกข้อมูล:
   - **หมายเลขบัตรประชาชน (CID)**: หมายเลข 13 หลัก
   - **ข้อความแจ้งเตือน**: ข้อความที่ต้องการส่ง
5. Execute node

## 📖 API Reference

### Endpoint
```
POST https://api-gateway.budhosp.com/api/v1/moph/alert
```

### Headers
```
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json
X-CSRF-TOKEN: {csrf_token}
```

### Request Body
```json
{
  "cid": "1234567890123",
  "message": "ข้อความที่จะส่งไป"
}
```

### Response
```json
{
  "success": true,
  "response": {
    // API response data
  },
  "timestamp": "2025-06-26T14:30:00.000Z"
}
```

## 💡 ตัวอย่างการใช้งาน

### ตัวอย่าง Workflow

```json
{
  "name": "BUDHOSP Alert Workflow",
  "nodes": [
    {
      "parameters": {
        "operation": "sendAlert",
        "cid": "1234567890123",
        "message": "มีการแจ้งเตือนสำคัญจากระบบ BUDHOSP"
      },
      "name": "BUDHOSP Moph Alert",
      "type": "n8n-nodes-budhosp-moph-alert.budhospMophAlert",
      "typeVersion": 1,
      "position": [800, 300],
      "credentials": {
        "budhospMophApi": {
          "id": "1",
          "name": "BUDHOSP API"
        }
      }
    }
  ]
}
```

### การใช้งานร่วมกับ Node อื่น

```javascript
// ตัวอย่างการดึงข้อมูลจาก Database แล้วส่ง Alert
// 1. HTTP Request Node - ดึงข้อมูลผู้ป่วย
// 2. Function Node - ประมวลผลข้อมูล  
// 3. BUDHOSP Moph Alert Node - ส่งแจ้งเตือน

// ใน Function Node
const patients = $input.all();

return patients.map(patient => ({
  json: {
    cid: patient.json.citizen_id,
    message: `แจ้งเตือน: ผู้ป่วย ${patient.json.name} มีนัดตรวจวันนี้`
  }
}));
```

## ⚠️ การตรวจสอบข้อมูล

Node จะตรวจสอบข้อมูลอัตโนมัติ:

- **CID**: ต้องเป็นตัวเลข 13 หลักเท่านั้น
- **Message**: ต้องไม่เป็นค่าว่าง
- **Credentials**: ต้องระบุ Bearer Token

## 🛠️ การพัฒนา

### ข้อกำหนดระบบ

- Node.js >= 20.15
- n8n >= 1.99.1

### การ Build

```bash
# Install dependencies
npm install

# Development mode
npm run dev

# Build for production
npm run build

# Run linting
npm run lint

# Fix linting issues
npm run lintfix

# Format code
npm run format
```

### การทดสอบ

```bash
# Build และ test
npm run build

# ตรวจสอบ package
npm pack
```

## 🐛 การแก้ไขปัญหา

### ปัญหาที่พบบ่อย

1. **Authentication Error**
   - ตรวจสอบ Bearer Token ให้ถูกต้อง
   - ตรวจสอบว่า Token ยังไม่หมดอายุ

2. **Invalid CID Error**
   - ตรวจสอบให้แน่ใจว่า CID เป็นตัวเลข 13 หลัก
   - ไม่มีเครื่องหมายหรือช่องว่าง

3. **Connection Error**
   - ตรวจสอบ Base URL ให้ถูกต้อง
   - ตรวจสอบการเชื่อมต่อ Internet

### การ Debug

เปิด Debug mode ใน n8n:
```bash
export N8N_LOG_LEVEL=debug
```

## 📄 License

MIT License - ดู [LICENSE.md](LICENSE.md) สำหรับรายละเอียด

## 📞 การติดต่อ

- **GitHub**: [klongchu/n8n-nodes-budhosp-moph-alert](https://github.com/klongchu/n8n-nodes-budhosp-moph-alert)
- **Email**: klongchu@gmail.com
- **Website**: [https://budhosp.go.th](https://budhosp.go.th)

## 🔗 ลิงก์ที่เกี่ยวข้อง

- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
- [n8n Node Development](https://docs.n8n.io/integrations/creating-nodes/)
- [BUDHOSP Official Website](https://budhosp.go.th)