WhatsApp Integration
WhatsApp Integration enables your organization to send notifications directly to users' WhatsApp accounts. Deliver exam reminders, result alerts, announcements, and parent updates through the world's most popular messaging platform.
Setting Up WhatsApp
1
Choose a Provider
Select your WhatsApp Business API provider from the settings page: Twilio, Meta, or WATI. Each provider has different pricing and setup requirements.
2
Enter API Credentials
Enter your provider's Account SID (or API Key), Auth Token (or API Secret), and Phone Number ID. These credentials connect BeamEdUp to your WhatsApp Business account.
3
Configure Webhook
Copy the auto-generated webhook URL and register it in your provider's dashboard. This enables delivery status tracking (queued, sent, delivered, read).
4
Enable Notification Types
Toggle which notification types to send via WhatsApp: exam reminders, result notifications, announcements, assignment deadlines, and parent updates.
5
Submit Templates for Approval
WhatsApp requires message templates to be approved before use. Create templates for each notification type and submit them for review. Status is tracked as Pending, Approved, or Rejected.
Configuration Fields
| Field | Required | Type | Description |
|---|---|---|---|
Provider | Required | select | WhatsApp Business API provider: Twilio, Meta (Cloud API), or WATI. |
Account SID / API Key | Required | text | Authentication credentials for your chosen provider. |
Auth Token / API Secret | Required | password | Secret key for API authentication. Stored encrypted. |
Phone Number ID | Required | text | The WhatsApp Business phone number ID registered with the provider. |
Webhook URL | Optional | url | Auto-generated webhook URL for receiving delivery status callbacks. |
Notification Types
The following notification types can be sent via WhatsApp:
- Exam Reminders — Sent before scheduled exams with exam name, date, and time
- Result Notifications — Sent when exam results are published with score summary
- Announcements — Organization or branch announcements delivered via WhatsApp
- Assignment Deadlines — Reminders for upcoming assignment due dates
- Parent Updates — Progress summaries and exam results sent to guardians
Message Templates
WhatsApp requires pre-approved message templates. Each template supports dynamic variables that are filled in when the message is sent:
- Templates must be submitted for approval through the settings page
- Template status is tracked: Pending, Approved, or Rejected
- Each template supports a specific language and set of placeholder variables
- Only approved templates can be used for sending messages
User Opt-In/Out
Users control their WhatsApp notification preferences:
- Users must opt in to receive WhatsApp messages and provide their phone number
- Per-notification-type preferences let users choose which messages they receive
- Users can opt out at any time from their notification settings
Delivery Tracking
Track the delivery status of every message through the delivery log:
- Queued — Message is in the send queue
- Sent — Delivered to WhatsApp servers
- Delivered — Received on the user's device
- Read — User opened the message
- Failed — Delivery failed with error details