# 🤖 دليل إعداد Telegram Bot — OTIS

## الخطوة 1: إنشاء البوت

1. افتح Telegram وتحدث مع **@BotFather**
2. أرسل: `/newbot`
3. أعطه اسماً مثل `OTIS Life Bot`
4. سيعطيك **Token** — احفظه

---

## الخطوة 2: اعرف Chat ID الخاص بك

1. تحدث مع **@userinfobot** على Telegram
2. سيعطيك رقم Chat ID الخاص بك

---

## الخطوة 3: تحديث ملف .env

افتح `config/.env` وعدّل:

```
TELEGRAM_BOT_TOKEN=1234567890:ABCDEFG...
TELEGRAM_ALLOWED_CHAT_ID=98765432
TELEGRAM_OTIS_USER_ID=1
```

---

## الخطوة 4: تسجيل Webhook (للسيرفر الحقيقي فقط)

بعد رفع الملفات على الاستضافة، افتح هذا الرابط في المتصفح:

```
https://api.telegram.org/bot<YOUR_TOKEN>/setWebhook?url=https://yoursite.com/otis/telegram/webhook.php
```

---

## الخطوة 5: الاختبار

أرسل للبوت:
```
مساعدة
```

ثم جرب:
```
صرفت 50 قهوة
مهمة جديدة مراجعة التقرير
وضعي
```

---

## الأوامر المدعومة

| الأمر | مثال |
|-------|------|
| تسجيل مصروف | `صرفت 50 قهوة` |
| إضافة مهمة | `مهمة جديدة الاتصال بالعميل` |
| إنجاز مهمة | `أنهيت مهمة المراجعة` |
| تسجيل عادة | `سجل عادة قراءة` |
| ملاحظة | `ملاحظة: فكرة للمشروع` |
| تقرير اليوم | `وضعي` |
| قائمة الأوامر | `مساعدة` |

---

## ⚠️ ملاحظات أمنية

- البوت يقبل فقط الرقم المسجل في `TELEGRAM_ALLOWED_CHAT_ID`
- أي شخص آخر يحصل على رسالة رفض فورية
- لا تشارك الـ Token مع أحد
