WhatsApp Integration

Send automated WhatsApp messages to your customers for payment reminders, expiration alerts, and custom broadcasts directly from ISPBills.

Overview

The WhatsApp integration module lets you:

• Connect a WhatsApp gateway for sending messages
• Broadcast bulk messages to customer groups
• Trigger automatic messages on events such as payments, invoice generation, and package expiration
• View full message history and delivery status

Setting Up WhatsApp Gateway

Navigate to the WhatsApp gateway settings to configure your provider.

1. Select your WhatsApp API provider from the supported list
2. Enter the API credentials (API key, instance ID, or token) provided by your gateway service
3. Configure the sender number that will appear on outgoing messages
4. Test the connection to verify messages are delivered

Broadcast Messages

Broadcast lets you send a single message to multiple customers at once.

Feature	Description
Recipient Filtering	Select customers by package, area, status, or custom filters
Message Templates	Use predefined templates with dynamic placeholders
Scheduling	Send immediately or schedule for a specific date and time
Delivery Report	Track sent, delivered, and failed messages

To send a broadcast:

1. Open the WhatsApp broadcast section
2. Compose your message or select a template
3. Choose the target audience using available filters
4. Review the recipient count and send or schedule the broadcast

Event-Based Messages

Automate WhatsApp notifications based on system events. Each event can have its own message template.

Common event triggers include:

• Payment Received — confirm payment to the customer
• Invoice Generated — notify when a new invoice is created
• Package Expiration — alert before or after a package expires
• Connection Suspended — inform the customer about service suspension
• Account Created — send a welcome message to new customers

To configure an event trigger:

1. Go to the WhatsApp event settings
2. Select the event you want to automate
3. Assign or create a message template with relevant placeholders (e.g., customer name, amount, due date)
4. Enable the trigger

Message History

All sent WhatsApp messages are logged in the message history section. You can:

• Search messages by customer name, phone number, or date range
• View delivery status for each message
• Resend failed messages individually
• Export message logs for record-keeping

Troubleshooting

Issue	Possible Cause	Solution
Messages not sending	Invalid API credentials	Re-check gateway configuration and test connection
Delayed delivery	Gateway provider queue	Contact your WhatsApp API provider
Template variables not replaced	Incorrect placeholder syntax	Verify placeholder names match system fields
Broadcast partially failed	Invalid phone numbers	Review failed entries in the delivery report