# 🤖 การตั้งค่า Telegram Bot - บอทน้องลา
### 🚀 **คู่มือการตั้งค่า Telegram Bot และ Webhook**
#### *สำหรับระบบจัดการการลาและ Work From Home แบบ Modern & Secure*
[]()
[]()
[]()
> 🎯 **ระบบที่ออกแบบมาเพื่อความง่าย ความปลอดภัย และการใช้งานจริงในองค์กร**
---
## ✨ **จุดเด่นของระบบ**
🔒
ความปลอดภัยสูง ⚡
รวดเร็ว
🎯
ใช้งานง่าย 🔧
Config-driven
---
## 📋 **สารบัญ**
| Section | Description | Time Required |
|---------|-------------|---------------|
| [🚀 สร้าง Telegram Bot](#-สร้าง-telegram-bot) | การสร้างบอทใหม่กับ BotFather | 5 นาที |
| [⚙️ ตั้งค่า Webhook](#️-ตั้งค่า-webhook) | เชื่อมต่อบอทกับเซิร์ฟเวอร์ | 3 นาที |
| [🔧 การกำหนดค่า](#-การกำหนดค่า) | Config files และการตั้งค่า | 5 นาที |
| [🧪 การทดสอบ](#-การทดสอบ) | ทดสอบการทำงานของระบบ | 2 นาที |
| [🛠️ การแก้ไขปัญหา](#️-การแก้ไขปัญหา) | Solutions สำหรับปัญหาที่พบบ่อย | - |
| [📊 การจัดการ](#-การจัดการ) | Monitoring และ Maintenance | - |
---
## 🚀 **สร้าง Telegram Bot**
📱 ขั้นตอนการสร้างบอทใหม่ (คลิกเพื่อดู)
ไฟล์/โฟลเดอร์
หน้าที่
สถานะ
webhook_handler.phpรับ/ประมวลผลข้อความจาก Telegram
🟢 Required
config/telegram_config.phpการตั้งค่า Bot Token
🟢 Required
config/db_config.phpการตั้งค่าฐานข้อมูล
🟢 Required
logs/เก็บ Log Files
🔵 Auto-created
src/Handlers/Logic การจัดการคำสั่ง
🟢 Required
### ขั้นตอนที่ 8: ตั้งค่าคำสั่งบอท
14. **ตั้งค่าเมนูคำสั่ง** 📋
```bash
curl -X POST "https://api.telegram.org/bot[YOUR_BOT_TOKEN]/setMyCommands" \
-H "Content-Type: application/json" \
-d '{
"commands": [
{"command": "start", "description": "เริ่มการสนทนา"},
{"command": "register", "description": "ลงทะเบียนเข้าใช้งาน"},
{"command": "help", "description": "แสดงคำสั่งที่ใช้ได้"},
{"command": "status", "description": "ตรวจสอบสถานะ"},
{"command": "leave", "description": "ขอลา"},
{"command": "wfh", "description": "ขอ Work From Home"},
{"command": "balance", "description": "เช็คยอดวันลา"},
{"command": "cancel", "description": "ยกเลิกการดำเนินการ"}
]
}'
```
---
## 🧪 **การทดสอบ**
🔍 ทดสอบการทำงานของระบบ (คลิกเพื่อดู)
Log Type
Command
หมายเหตุ
Webhook Activity
tail -f logs/webhook.logดูการทำงานของ Webhook
Security Events
tail -f logs/security.logดูเหตุการณ์ความปลอดภัย
Registration Activity
ls -la logs/registration_*.jsonดูกิจกรรมการลงทะเบียน
Rate Limiting
ls -la logs/rate_limit_*.jsonดูการจำกัดอัตรา
### ✅ **ตรวจสอบขั้นตอนสุดท้าย**
**1. ทดสอบคำสั่งพื้นฐาน:**
- [ ] ส่ง `/start` ไปยังบอท
- [ ] ลองลงทะเบียนด้วย `/register`
- [ ] ทดสอบ `/help` เพื่อดูคำสั่ง
**2. ทดสอบฟังก์ชันหลัก:**
- [ ] ขอลาด้วย `/leave`
- [ ] ขอ WFH ด้วย `/wfh`
- [ ] เช็คยอดด้วย `/balance`
**3. ตรวจสอบความปลอดภัย:**
- [ ] Rate Limiting ทำงานหรือไม่
- [ ] Input Validation ทำงานหรือไม่
- [ ] Log Files ถูกสร้างหรือไม่
---
## 🛠️ **การแก้ไขปัญหา**
❌ Solutions สำหรับปัญหาที่พบบ่อย (คลิกเพื่อดู)
อาการ
วิธีแก้ไข
❌ Bot ไม่ตอบเมื่อส่งข้อความ
ตรวจสอบ Webhook Status
```bash
# ดู Webhook Info
curl https://api.telegram.org/bot[TOKEN]/getWebhookInfo
# ตรวจสอบ SSL Certificate
curl -I https://yourdomain.com/webhook_handler.php
# ทดสอบ HTTP Response
curl -X POST -d '{}' https://yourdomain.com/webhook_handler.php
```
⚠️ SSL Certificate Error
อัปเดต SSL Certificate
```bash
# ตรวจสอบ SSL
openssl s_client -connect yourdomain.com:443
# อัปเดต Certificate (ใช้ Certbot)
sudo certbot renew
sudo systemctl reload apache2
```
🔒 Permission Error
ตั้งค่า File Permissions
```bash
# ตั้งค่า Permissions
chmod -R 755 /path/to/bot/
chmod -R 777 /path/to/bot/logs/
chown -R www-data:www-data /path/to/bot/
```
#### **2. 🤖 Bot ไม่ตอบ/Error**
อาการ
วิธีแก้ไข
💥 PHP Fatal Error
เปิด Debug Mode
```php
// เพิ่มในไฟล์ webhook_handler.php
error_reporting(E_ALL);
ini_set('display_errors', 1);
ini_set('log_errors', 1);
ini_set('error_log', __DIR__.'/logs/php_errors.log');
```
🗄️ Database Connection Error
ทดสอบการเชื่อมต่อ Database
```bash
# ทดสอบ Database Connection
php test_simple.php
# ตรวจสอบ MySQL Service
sudo systemctl status mysql
sudo systemctl restart mysql
```
📁 Missing Files
ตรวจสอบไฟล์ที่จำเป็น
```bash
# ตรวจสอบไฟล์สำคัญ
ls -la config/telegram_config.php
ls -la config/db_config.php
ls -la webhook_handler.php
ls -la src/Services/TelegramService.php
```
#### **3. 🔐 ปัญหาความปลอดภัย**
อาการ
วิธีแก้ไข
🚫 Rate Limiting Block
จัดการ Rate Limits
```bash
# ล้าง Rate Limit Files หมดอายุ
find logs/ -name "rate_limit_*.json" -mtime +1 -delete
# ตรวจสอบ Rate Limit Config
grep RATE_LIMIT config/db_config.php
```
🛡️ Input Validation Error
ตรวจสอบ Input Sanitization
```bash
# ดู Security Logs
tail -f logs/security.log
# ตรวจสอบ SecurityHelper
grep -n "sanitize" src/Core/SecurityHelper.php
```
### 🔧 **เครื่องมือช่วยแก้ปัญหา**
#### **Health Check Script**
สร้างไฟล์ `health_check.php`:
```php
getConnection();
echo "✅ Database Connection\n";
} catch (Exception $e) {
echo "❌ Database Connection - ERROR: " . $e->getMessage() . "\n";
}
// ตรวจสอบ Telegram API
try {
require_once 'config/telegram_config.php';
$url = "https://api.telegram.org/bot" . TELEGRAM_BOT_TOKEN . "/getMe";
$response = file_get_contents($url);
$data = json_decode($response, true);
if ($data['ok']) {
echo "✅ Telegram API - Bot: " . $data['result']['first_name'] . "\n";
} else {
echo "❌ Telegram API - ERROR\n";
}
} catch (Exception $e) {
echo "❌ Telegram API - ERROR: " . $e->getMessage() . "\n";
}
// ตรวจสอบ Log Directory
if (is_dir('logs') && is_writable('logs')) {
echo "✅ Logs Directory\n";
} else {
echo "❌ Logs Directory - Check permissions!\n";
}
echo "\n🎯 Health Check Complete!\n";
?>
```
รันการตรวจสอบ:
```bash
php health_check.php
```
#### **Quick Debug Commands**
```bash
# ดู Error Logs ทั้งหมด
tail -f /var/log/apache2/error.log
tail -f logs/webhook.log
tail -f logs/security.log
# ล้าง Cache และ Temp Files
rm -f logs/registration_*.json
rm -f logs/rate_limit_*.json
rm -f logs/user_*_state.txt
# รีสตาร์ท Services
sudo systemctl restart apache2
sudo systemctl restart mysql
```
#### **3. Database Connection Error**
```bash
# ทดสอบการเชื่อมต่อฐานข้อมูล
php test_simple.php
```
### ✅ วิธีแก้ไข
#### **SSL Issues:**
```bash
# ตรวจสอบ SSL
openssl s_client -connect yourdomain.com:443
# Update Certificate
certbot renew
```
#### **PHP Errors:**
```bash
# ตรวจสอบ PHP error log
tail -f /var/log/apache2/error.log
tail -f /var/log/php_errors.log
```
#### **File Permissions:**
```bash
# ตั้งค่า permissions
chmod -R 755 /path/to/bot/
chmod -R 777 /path/to/bot/logs/
```
---
## 📊 **การจัดการ**
🎛️ Monitoring และ Maintenance (คลิกเพื่อดู)
คำสั่ง
หน้าที่
ความถี่
```bash
curl https://api.telegram.org/bot[TOKEN]/getMe
```
ตรวจสอบข้อมูลบอท
🟢 เมื่อต้องการ
```bash
curl https://api.telegram.org/bot[TOKEN]/getWebhookInfo
```
ดูสถานะ Webhook
🟡 รายวัน
```bash
curl https://api.telegram.org/bot[TOKEN]/deleteWebhook
```
ลบ Webhook (เฉพาะเมื่อจำเป็น)
🔴 Emergency
```bash
curl -X POST "https://api.telegram.org/bot[TOKEN]/sendMessage" \
-d "chat_id=CHAT_ID&text=System Notification"
```
ส่งข้อความแจ้งเตือนระบบ
🟢 เมื่อต้องการ
### 📈 **Monitoring และการติดตาม**
#### **ตรวจสอบ Logs แบบ Real-time** 📊
```bash
# สำหรับ Production Monitoring
#!/bin/bash
echo "📊 Starting Real-time Monitoring..."
# Terminal 1: Webhook Activity
gnome-terminal --tab --title="Webhook Logs" -- bash -c "tail -f logs/webhook.log; exec bash"
# Terminal 2: Security Events
gnome-terminal --tab --title="Security Logs" -- bash -c "tail -f logs/security.log; exec bash"
# Terminal 3: System Errors
gnome-terminal --tab --title="Error Logs" -- bash -c "tail -f /var/log/apache2/error.log; exec bash"
echo "🎯 Monitoring terminals opened!"
```
#### **Dashboard สำหรับ Admin** 🎛️
สร้างไฟล์ `admin_dashboard.php`:
```php
🤖 Bot Admin Dashboard
🤖 Telegram Bot Dashboard
📊 Statistics
getConnection();
// จำนวนผู้ใช้งาน
$stmt = $pdo->query("SELECT COUNT(*) as count FROM employees");
$userCount = $stmt->fetch()['count'];
// จำนวนคำขอวันนี้
$stmt = $pdo->query("SELECT COUNT(*) as count FROM leave_requests WHERE DATE(created_at) = CURDATE()");
$todayRequests = $stmt->fetch()['count'];
echo "
👥 ผู้ใช้งาน: {$userCount}
";
echo "
📝 คำขอวันนี้: {$todayRequests}
";
} catch (Exception $e) {
echo "
❌ Database Error: " . $e->getMessage() . "
";
}
?>
🔍 System Status
'Telegram Config',
'config/db_config.php' => 'Database Config',
'webhook_handler.php' => 'Webhook Handler',
'logs/' => 'Logs Directory'
];
foreach ($files as $file => $name) {
if (file_exists($file)) {
echo "
✅ {$name}
";
} else {
echo "
❌ {$name} - Missing!
";
}
}
// ตรวจสอบ Telegram API
try {
require_once 'config/telegram_config.php';
$url = "https://api.telegram.org/bot" . TELEGRAM_BOT_TOKEN . "/getMe";
$response = @file_get_contents($url);
if ($response) {
$data = json_decode($response, true);
if ($data['ok']) {
echo "
✅ Telegram API - Bot: " . $data['result']['first_name'] . "
";
} else {
echo "
❌ Telegram API Error
";
}
} else {
echo "
❌ Cannot connect to Telegram API
";
}
} catch (Exception $e) {
echo "
❌ Telegram API Error: " . $e->getMessage() . "
";
}
?>
📄 Recent Logs
";
echo htmlspecialchars(implode('', $logs));
echo "";
} else {
echo "
No logs found
";
}
?>
🛠️ Quick Actions
🔄 Refresh Dashboard
📁 View Logs Folder
```
### 🔄 **Maintenance และการบำรุงรักษา**
#### **รายวัน (Daily Maintenance)** 📅
```bash
#!/bin/bash
# daily_maintenance.sh
echo "🔄 Daily Maintenance Started"
# 1. ตรวจสอบ Disk Space
df -h | grep -E '(8[0-9]|9[0-9])%' && echo "⚠️ Disk space warning!"
# 2. ล้าง Temp Files
find logs/ -name "registration_*.json" -mtime +1 -delete
find logs/ -name "rate_limit_*.json" -mtime +1 -delete
find logs/ -name "user_*_state.txt" -mtime +1 -delete
# 3. Compress Old Logs
find logs/ -name "*.log" -mtime +7 -exec gzip {} \;
# 4. Database Cleanup (optional)
# php -r "require_once 'src/Core/Database.php'; Database::cleanup();"
echo "✅ Daily Maintenance Completed"
```
#### **รายสัปดาห์ (Weekly Maintenance)** 📊
```bash
#!/bin/bash
# weekly_maintenance.sh
echo "📊 Weekly Maintenance Started"
# 1. ล้าง Log Files เก่า
find logs/ -name "*.log.gz" -mtime +30 -delete
# 2. Database Optimization
mysql -u$DB_USER -p$DB_PASS $DB_NAME -e "OPTIMIZE TABLE employees, leave_requests, leave_balances;"
# 3. Backup Database
mysqldump -u$DB_USER -p$DB_PASS $DB_NAME > "backups/db_backup_$(date +%Y%m%d).sql"
gzip "backups/db_backup_$(date +%Y%m%d).sql"
# 4. Generate Weekly Report
php generate_weekly_report.php
echo "✅ Weekly Maintenance Completed"
```
#### **Health Check Automation** 🏥
```bash
#!/bin/bash
# health_check_cron.sh
HEALTH_STATUS=$(php health_check.php)
ERROR_COUNT=$(echo "$HEALTH_STATUS" | grep -c "❌")
if [ $ERROR_COUNT -gt 0 ]; then
echo "🚨 System Health Alert!"
echo "$HEALTH_STATUS"
# ส่งแจ้งเตือนไปยัง Admin (เพิ่ม Chat ID ของ Admin)
curl -X POST "https://api.telegram.org/bot[TOKEN]/sendMessage" \
-d "chat_id=[ADMIN_CHAT_ID]&text=🚨 Bot System Alert:%0A%0A$HEALTH_STATUS"
fi
```
#### **ตั้งค่า Cron Jobs** ⏰
```bash
# เพิ่มใน crontab
crontab -e
# Daily maintenance ทุกวันเวลา 02:00
0 2 * * * /path/to/bot/daily_maintenance.sh >> /path/to/bot/logs/maintenance.log 2>&1
# Weekly maintenance ทุกวันอาทิตย์เวลา 03:00
0 3 * * 0 /path/to/bot/weekly_maintenance.sh >> /path/to/bot/logs/maintenance.log 2>&1
# Health check ทุกชั่วโมง
0 * * * * /path/to/bot/health_check_cron.sh >> /path/to/bot/logs/health.log 2>&1
# Rate limit cleanup ทุก 15 นาที
*/15 * * * * php /path/to/bot/cleanup_rate_limits.php
```
---
## 🎉 **บอทพร้อมใช้งานแล้ว!**
### � **ขั้นตอนสุดท้าย - ทดสอบบอทของคุณ**
**1️⃣ ค้นหาบอท**
**2️⃣ เริ่มการสนทนา**
**3️⃣ ลงทะเบียน**
**4️⃣ เริ่มใช้งาน**
### � **คำสั่งหลักที่ควรจำ**
| คำสั่ง | หน้าที่ | ตัวอย่าง |
|--------|---------|----------|
| `/start` | เริ่มการใช้งาน | เริ่มสนทนากับบอท |
| `/register` | ลงทะเบียน | สำหรับผู้ใช้งานใหม่ |
| `/leave` | ขอลา | ลาป่วย, ลากิจ, ลาพักผ่อน |
| `/wfh` | ขอ WFH | Work From Home |
| `/balance` | เช็คยอดลา | ดูวันลาคงเหลือ |
| `/help` | คำสั่งทั้งหมด | ดูรายการคำสั่ง |
---
### 🎖️ **ระบบที่ได้มาตรฐาน**
### 📊 **คุณสมบัติเด่น**
✅ **Rate Limiting** - ป้องกันการใช้งานเกินขีดจำกัด
✅ **Input Validation** - ตรวจสอบข้อมูลนำเข้าทุกครั้ง
✅ **File Encryption** - เข้ารหัสไฟล์สำคัญ
✅ **Real-time Monitoring** - ติดตามการทำงานแบบเรียลไทม์
✅ **Auto Maintenance** - บำรุงรักษาอัตโนมัติ
✅ **Error Handling** - จัดการข้อผิดพลาดครอบคลุม
---
**🔖 เวอร์ชัน:** 1.0 | **📅 อัปเดต:** กรกฎาคม 2568 | **👨💻 สถานะ:** Production Ready
Made with ❤️ for **better workplace communication**
*ระบบนี้ออกแบบมาเพื่อความง่าย ความปลอดภัย และการใช้งานจริงในองค์กร*