95 lines
2.3 KiB
Markdown
95 lines
2.3 KiB
Markdown
|
# Twilio WhatsApp Setup Guide
|
||
|
|
|
||
|
|
## 🔑 **Step 1: Get Twilio Credentials**
|
||
|
|
|
||
|
|
1. **Sign up for Twilio:**
|
||
|
|
- Go to https://console.twilio.com/
|
||
|
|
- Create a free account
|
||
|
|
|
||
|
|
2. **Get Account SID and Auth Token:**
|
||
|
|
- In Twilio Console, go to Dashboard
|
||
|
|
- Copy your Account SID (starts with `AC...`)
|
||
|
|
- Copy your Auth Token
|
||
|
|
|
||
|
|
3. **Enable WhatsApp Business API:**
|
||
|
|
- Go to Messaging → WhatsApp
|
||
|
|
- Follow the setup instructions
|
||
|
|
- Get your WhatsApp number
|
||
|
|
|
||
|
|
## 📱 **Step 2: WhatsApp Group ID**
|
||
|
|
|
||
|
|
### **Option A: Using Twilio Console**
|
||
|
|
1. In Twilio Console, go to Messaging → WhatsApp
|
||
|
|
2. Look for your group in the list
|
||
|
|
3. Copy the Group ID (format: `g.1234567890@group`)
|
||
|
|
|
||
|
|
### **Option B: Manual Discovery**
|
||
|
|
1. Open WhatsApp Web
|
||
|
|
2. Go to your target group
|
||
|
|
3. Check the URL or use browser dev tools
|
||
|
|
4. Look for group ID in the page source
|
||
|
|
|
||
|
|
### **Option C: Test with Sample Group**
|
||
|
|
For testing, you can use a sample group ID:
|
||
|
|
```
|
||
|
|
g.1234567890@group
|
||
|
|
```
|
||
|
|
|
||
|
|
## ⚙️ **Step 3: Environment Configuration**
|
||
|
|
|
||
|
|
Add these to your `.env` file:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Twilio Credentials
|
||
|
|
TWILIO_ACCOUNT_SID=AC...your_account_sid_here
|
||
|
|
TWILIO_AUTH_TOKEN=your_auth_token_here
|
||
|
|
|
||
|
|
# WhatsApp Configuration
|
||
|
|
TWILIO_WHATSAPP_NUMBER=+1234567890
|
||
|
|
WHATSAPP_GROUP_ID=g.1234567890@group
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🧪 **Step 4: Test the Setup**
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Test WhatsApp integration
|
||
|
|
python test_whatsapp.py
|
||
|
|
|
||
|
|
# Test complete system
|
||
|
|
python test_real_ai.py
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🔍 **Troubleshooting**
|
||
|
|
|
||
|
|
### **Common Issues:**
|
||
|
|
|
||
|
|
1. **"Invalid Account SID"**
|
||
|
|
- Check your Account SID starts with `AC`
|
||
|
|
- Verify it's copied correctly
|
||
|
|
|
||
|
|
2. **"Authentication failed"**
|
||
|
|
- Check your Auth Token
|
||
|
|
- Make sure it's the correct token
|
||
|
|
|
||
|
|
3. **"WhatsApp number not found"**
|
||
|
|
- Verify your WhatsApp number is activated
|
||
|
|
- Check the number format (+1234567890)
|
||
|
|
|
||
|
|
4. **"Group not found"**
|
||
|
|
- Verify the group ID format
|
||
|
|
- Make sure the group exists
|
||
|
|
- Check if you have permission to send to the group
|
||
|
|
|
||
|
|
## 📞 **Support**
|
||
|
|
|
||
|
|
- **Twilio Documentation:** https://www.twilio.com/docs/whatsapp
|
||
|
|
- **WhatsApp Business API:** https://developers.facebook.com/docs/whatsapp
|
||
|
|
- **Twilio Support:** https://support.twilio.com/
|
||
|
|
|
||
|
|
## 🎯 **Next Steps**
|
||
|
|
|
||
|
|
Once configured:
|
||
|
|
1. Test with mock data first
|
||
|
|
2. Send a test alert to your group
|
||
|
|
3. Monitor the alerts in your WhatsApp group
|
||
|
|
4. Fine-tune the alert timing and content
|