Skip to main content

WhatsApp Messaging

Send WhatsApp messages to voters and citizens using the WhatsApp Business API integration.

Overview​

The PWA supports WhatsApp messaging through:

  • Meta WhatsApp Business API (Primary)
  • Gupshup WhatsApp API (Fallback)

Features​

  • Send individual WhatsApp messages
  • Broadcast to multiple recipients
  • Message templates
  • Media attachments (images, documents, videos)
  • Delivery status tracking
  • Read receipts
  • Message history

Sending Messages​

Individual Message​

  1. Navigate to Messaging → WhatsApp
  2. Click New Message
  3. Select recipient from voter list or enter phone number
  4. Compose message or select template
  5. Add media attachments (optional)
  6. Click Send

Broadcast Message​

  1. Navigate to Messaging → WhatsApp → Broadcast
  2. Select recipient segment or upload CSV
  3. Compose message or select template
  4. Schedule for later (optional)
  5. Click Send Broadcast

Message Templates​

Using Templates​

WhatsApp requires pre-approved message templates for business messaging.

  1. Navigate to Messaging → Templates
  2. Browse available templates
  3. Select template
  4. Fill in template variables
  5. Send message

Template Variables​

Templates support dynamic variables:

  • {{name}} - Recipient name
  • {{constituency}} - Constituency name
  • {{date}} - Current date
  • Custom variables

Media Attachments​

Supported Media Types​

  • Images: JPG, PNG, GIF, WebP (max 5MB)
  • Documents: PDF, DOC, DOCX, XLS, XLSX (max 10MB)
  • Videos: MP4 (max 16MB)
  • Audio: MP3, OGG (max 16MB)

Adding Media​

  1. Click Attach button
  2. Select media type
  3. Choose file from device
  4. Wait for upload
  5. Send message

Delivery Status​

Track message delivery status:

  • Sent: Message sent to WhatsApp
  • Delivered: Message delivered to recipient
  • Read: Recipient read the message
  • Failed: Message delivery failed

Best Practices​

  1. Use Templates: Always use approved templates for business messages
  2. Personalize: Use recipient names and relevant information
  3. Timing: Send messages during business hours (9 AM - 8 PM)
  4. Frequency: Don't spam - respect recipient preferences
  5. Content: Keep messages concise and clear
  6. Media: Optimize images and videos before sending

Troubleshooting​

Message Not Sending​

  • Check WhatsApp provider status
  • Verify recipient phone number format
  • Ensure template is approved
  • Check credit balance

Delivery Failed​

  • Recipient may have blocked your number
  • Phone number may be invalid
  • WhatsApp account may be restricted

Template Rejected​

  • Review template guidelines
  • Ensure compliance with WhatsApp policies
  • Contact support for assistance

Next Steps​

Need help? Check the FAQs or Contact Support