🤖 Rasa Chatbot - Hoàng Hà Mobile

Chatbot hỗ trợ khách hàng cho cửa hàng Hoàng Hà Mobile, tích hợp với Zalo OA (Official Account). Chatbot được xây dựng trên nền tảng Rasa Open Source và Flask.

📋 Tính năng

• 💬 Trả lời tự động các câu hỏi của khách hàng
• 💰 Tra cứu giá sản phẩm từ database điện thoại
• 🎁 Thông tin khuyến mãi cho từng sản phẩm
• 🎨 Tra cứu màu sắc có sẵn của sản phẩm
• 🏪 Thông tin cửa hàng (địa chỉ, giờ mở cửa)
• 📱 Tích hợp Zalo OA - nhận và gửi tin nhắn qua Zalo

🛠️ Công nghệ sử dụng

• Rasa 3.1.0 - Framework chatbot AI
• Rasa SDK 3.1.0 - Custom actions
• Flask - Web server cho webhook Zalo
• Pandas - Xử lý dữ liệu sản phẩm
• Zalo OA API - Tích hợp Zalo

📁 Cấu trúc dự án

y/
├── app.py                 # Flask server - Webhook Zalo
├── config.yml             # Cấu hình Rasa pipeline
├── credentials.yml        # Credentials cho các kênh
├── domain.yml             # Intents, entities, responses
├── endpoints.yml          # Endpoints cấu hình
├── actions/
│   ├── actions.py         # Custom actions (tra cứu giá, khuyến mãi...)
│   └── hoanghamobile.csv  # Database sản phẩm
├── data/
│   ├── nlu.yml            # Training data cho NLU
│   ├── rules.yml          # Conversation rules
│   └── stories.yml        # Training stories
├── models/                # Trained models
├── templates/
│   └── xacthuc.html       # Template xác thực Zalo
└── tests/
    └── test_stories.yml   # Test cases

🚀 Cài đặt

1. Clone repository

git clone https://github.com/TLChuong14104/rasa-chatbot.git
cd rasa-chatbot/y

2. Tạo môi trường ảo (khuyến nghị)

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

3. Cài đặt dependencies

pip install -r requirements.txt

🎯 Hướng dẫn sử dụng

Train model

rasa train

Chạy Rasa Server

rasa run --enable-api --cors "*" --port 5005 --host 0.0.0.0 --debug

Chạy Action Server

rasa run actions

Chạy Flask Webhook (Zalo)

python app.py

Test chatbot trong terminal

rasa shell

Expose localhost ra internet (dùng ngrok)

ngrok http 5000

💡 Các Intent được hỗ trợ

Intent	Mô tả	Ví dụ
greet	Chào hỏi	"Xin chào", "Hi"
goodbye	Tạm biệt	"Bye", "Tạm biệt"
ask_product_price	Hỏi giá sản phẩm	"Giá iPhone 12 bao nhiêu?"
ask_product_promotion	Hỏi khuyến mãi	"Samsung A05s có ưu đãi gì?"
ask_product_colors	Hỏi màu sắc	"Nokia 3210 có màu gì?"
ask_shop_info	Thông tin cửa hàng	"Cửa hàng ở đâu?"

⚙️ Cấu hình Zalo OA

1. Đăng ký Zalo OA tại oa.zalo.me
2. Lấy Access Token từ Zalo Developer
3. Cập nhật ACCESS_TOKEN trong file app.py
4. Cấu hình Webhook URL trỏ đến /webhook/

📊 Database sản phẩm

Dữ liệu sản phẩm được lưu trong file hoanghamobile.csv với các cột:

• title - Tên sản phẩm
• current_price - Giá hiện tại
• product_promotion - Thông tin khuyến mãi
• color_options - Các màu có sẵn

🔧 Tùy chỉnh

Thêm sản phẩm mới

Thêm dữ liệu vào file actions/hoanghamobile.csv

Thêm intent mới

1. Thêm examples vào data/nlu.yml
2. Khai báo intent trong domain.yml
3. Thêm rules/stories tương ứng
4. Train lại model: rasa train

📝 License

MIT License

👤 Tác giả

TLChuong14104

---

⭐ Nếu project hữu ích, hãy cho một star nhé!