sendio/FIXING_ERRORS.md

Fixing Campaign Errors - Quick Guide

Why Are Messages Failing?

Your campaign shows failed messages because of compliance checks that protect you from sending spam. This is a GOOD thing! 🛡️

Common Errors & Fixes

1. "Contact not opted in; must use approved template"

Problem: Contact hasn't given permission to receive messages.

Fix Option A (Recommended for testing):

1. Go to Contacts page
2. Find the contact(s) that failed
3. Click Edit (you'll need to add this feature OR recreate contact)
4. Check the "Opted In" checkbox ✅
5. Save

Fix Option B: Use approved WhatsApp template (see #2 below)

2. "No conversation window; must use approved template"

Problem: WhatsApp requires approved templates for cold outreach.

Fix: Mark your template as approved:

1. Go to Templates page
2. Edit your template
3. Check "Approved WhatsApp Template" checkbox ✅
4. Save

Note: In production, you'd actually submit templates to Meta for approval. For testing, just check this box.

3. Using Telegram for Easy Testing

Instead of dealing with WhatsApp compliance, use Telegram (100% free!):

1. Set in docker-compose.yml:

   WHATSAPP_PROVIDER: telegram
   TELEGRAM_BOT_TOKEN: <your-bot-token>
   

2. Follow TELEGRAM_TESTING.md guide

3. Add contacts with Telegram user IDs instead of phone numbers

4. Messages will actually be delivered to Telegram! 📱

Quick Test Checklist

Before sending campaigns:

• All contacts have "Opted In" checked
• Template has "Approved WhatsApp Template" checked (if not using Telegram)
• Contacts are in a list
• Campaign created with that list and template
• Worker triggered after clicking "Send"

Production Note

In production with real WhatsApp:

• Only send to contacts who explicitly opted in (GDPR compliance)
• Submit templates to Meta for approval (takes 24-48 hours)
• Use approved templates for first contact
• Free-form messages only for existing conversations

For now, just check the boxes for testing! ✅