https://github.com/xjectro/whatsapp-chatbot
🤖💬 Chatbot project delivering an AI-powered WhatsApp chat experience. Uses the Gemini AI model and Twilio API to provide real-time, intelligent responses.
https://github.com/xjectro/whatsapp-chatbot
gemini gemini-ai gemini-api python twilio twilio-api twilio-python twilio-whatsapp
Last synced: 9 months ago
JSON representation
🤖💬 Chatbot project delivering an AI-powered WhatsApp chat experience. Uses the Gemini AI model and Twilio API to provide real-time, intelligent responses.
- Host: GitHub
- URL: https://github.com/xjectro/whatsapp-chatbot
- Owner: Xjectro
- License: mit
- Created: 2025-05-18T00:01:19.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-11T12:59:30.000Z (12 months ago)
- Last Synced: 2025-06-22T20:42:15.809Z (11 months ago)
- Topics: gemini, gemini-ai, gemini-api, python, twilio, twilio-api, twilio-python, twilio-whatsapp
- Language: Python
- Homepage: https://xjectro.com
- Size: 7.81 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WhatsApp Chatbot 🤖💬
Chatbot project delivering an AI-powered WhatsApp chat experience. Uses the Gemini AI model and Twilio API to provide real-time, intelligent responses.
## ⚙️ Features
- AI-powered conversation 🧠
- WhatsApp integration via Twilio 📲
- Easy configuration 🔧
- Error handling & logging 📝
## 📋 Prerequisites
- Python 3.8 or higher 🐍
- Twilio account & WhatsApp-enabled number 📞
- OpenAI API key 🔑
## 🚀 Installation
```powershell
git clone https://github.com/Xjectro/whatsaap-chatbot.git
cd whatsaap-chatbot
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
```
## 🔧 Configuration
Update the variables in `app/config.py`:
```python
GEMINI_API_KEY = "your_gemini_ai_key"
TWILIO_ACCOUNT_SID = "your_twilio_sid"
TWILIO_AUTH_TOKEN = "your_twilio_token"
TWILIO_WHATSAPP_NUMBER = "whatsapp:+1234567890"
```
## 🏃 Usage
```powershell
python -m app
```
Webhook URL:
```
POST https:///whatsapp
```
## 🗂️ Project Structure
- `app/`
- `__init__.py` : Application entry point
- `config.py` : Configuration variables
- `routes/`
- `whatsapp.py` : Webhook route
- `services/`
- `chatbot.py` : OpenAI integration
- `twillio.py` : Twilio messaging
- `requirements.txt` : Dependencies
- `Makefile` : Helper commands
## 🤝 Contributing
Bug reports, ideas, or pull requests are welcome. Let's build together! 🌟
## 📝 License
This project is licensed under the MIT License.
© 2025