🤖 FB Messenger Bot (Python Version)

Chào mừng bạn đến với dự án Bot Messenger được xây dựng trên nền tảng Python. Đây là một dự án không chính thức về Facebook Chat API dành cho người thích python, đang trong giai đoạn phát triển sơ khởi, hứa hẹn sẽ mang lại nhiều tính năng thú vị và hữu ích cho người dùng.

---

🌟 Lời cảm ơn đặc biệt (Credits)

Dự án này được xây dựng dựa trên cốt lõi (core) là thư viện fbchat-v2. Chúng tôi xin gửi lời trân trọng cảm ơn tới tác giả của fbchat-v2 vì đã phát triển một bộ công cụ mạnh mẽ, giúp việc tương tác với giao diện Facebook Messenger trở nên khả thi cho cộng đồng lập trình viên Python. Dự án này cam kết tôn trọng và tiếp tục kế thừa những tinh hoa từ thư viện gốc.

---

🚀 Tính năng hiện có

• Hệ thống Lệnh (Commands): Dễ dàng mở rộng và thêm mới các lệnh thủ công.
  • /ping: Kiểm tra trạng thái hoạt động của bot.
  • /members: Liệt kê danh sách thành viên trong nhóm.
  • /xsmb: Tra cứu kết quả xổ số miền Bắc (Hỗ trợ -n để xem lại ngày cũ).
• Lập lịch tự động (Schedules):
  • Chào buổi sáng/chiều vào khung giờ cố định.
• Cào dữ liệu (Crawler): Tách biệt logic cào dữ liệu (XSMB) giúp code sạch sẽ và dễ bảo trì.
• Quản lý bảo mật: Sử dụng file .env để bảo vệ Cookie người dùng.
• **Sử dụng các biện pháp chống bị khóa tài khoản nhất có thể (delay, fake presence, fake user agent) **

---

🛠️ Cấu trúc dự án

├── fbchat-v2/          # Core thư viện gốc (Tôn trọng tác giả)
├── src/
│   ├── commands/       # Nơi chứa các lệnh thực thi (/ping, /xsmb,...)
│   ├── crawler/        # Logic cào dữ liệu từ các trang web
│   ├── schedules/      # Các tác vụ chạy tự động theo thời gian
│   ├── data/           # Nơi lưu trữ cấu hình Admin và Nhóm hoạt động
│   └── command_handler.py # Bộ điều hướng lệnh
├── .env                # Lưu trữ COOKIES bảo mật
└── mainBot.py          # File khởi chạy chính của hệ thống

---

📦 Hướng dẫn cài đặt

1. Clone dự án:

   git clone https://github.com/pillrock/bot-facebook
   cd bot-facebook

2. Tạo môi trường ảo:

   python -m venv venv
   venv\Scripts\activate

3. Cài đặt thư viện:

   pip install -r requirements.txt

4. Cấu hình Cookie: Tạo file .env tại thư mục gốc và dán cookie Facebook của bạn:

   COOKIES=datr=xxx;c_user=xxx;xs=xxx;|Mozilla/5.0...
   

5. Chạy Bot:

   python mainBot.py

---

📅 Lộ trình phát triển (Roadmap)

Dự án này mới chỉ là sự khởi đầu, trong tương lai sẽ hướng tới:

• Tích hợp AI (Gemini, ChatGPT) để trò chuyện thông minh.
• Hệ thống quản lý nhóm (Ban/Mute thành viên).
• Gửi media (Ảnh, Video, Voice) một cách ổn định hơn.
• Thêm nhiều lệnh giải trí: Simsimi, Bói toán, Game mini...

---

🤝 Đóng góp

Vì dự án còn phát triển dài dài, mọi ý kiến đóng góp hoặc báo lỗi đều được trân trọng

---

**Tác giả:**pillrock
Dựa trên: fbchat-v2 core AI generate README