Initial commit: Email alerts application

2025-07-25 11:31:36 +01:00
commit adfb625ae9
6322 changed files with 2882826 additions and 0 deletions
@@ -0,0 +1,95 @@
+# 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