WhatsApp Integration

Send automated WhatsApp notifications and respond to subscriber messages.

Overview

Qserve integrates with the WhatsApp Business Platform (Meta Cloud API) to send automated messages to subscribers. You can send payment reminders, renewal notifications, and custom broadcasts — all from the Qserve dashboard. Subscribers can also reply, and you can respond from the built-in WhatsApp Chat interface.

Prerequisites

• A Meta Business Account
• A verified WhatsApp Business phone number (separate from your personal WhatsApp)
• The phone number must be enrolled in the WhatsApp Business Platform (not just the free WhatsApp Business App)

Step 1 — Get Your API Credentials

1. Go to developers.facebook.com → My Apps → Create App → Business.
2. Add the WhatsApp product to your app.
3. From WhatsApp → API Setup, note:
   • Phone Number ID — the ID of your WhatsApp Business number
   • Access Token — a permanent token (create a System User token for production)
   • Business Account ID (WABA ID)

Step 2 — Configure in Qserve

1. Go to Admin → WhatsApp.
2. Enter your Phone Number ID, Access Token, and WABA ID.
3. Enter your Verify Token — a random string you choose (e.g., qserve_whatsapp_2024).
4. Save. Qserve shows you a webhook URL to configure in your Meta app.

Step 3 — Set Up the Webhook in Meta

1. In your Meta app → WhatsApp → Configuration → Webhook.
2. Click Edit and enter:
   • Callback URL: https://qserve-isp.net/api/whatsapp/webhook
   • Verify Token: the same string you entered in Qserve
3. Click Verify and Save. Meta sends a verification request that Qserve handles automatically.
4. Subscribe to the messages webhook field.

Step 4 — Approve Message Templates

WhatsApp requires pre-approved templates for outbound messages to subscribers who haven't messaged you first. In Meta → WhatsApp → Message Templates, create templates for:

• Payment reminder (expiry warning)
• Package activated confirmation
• Account expired notification

Templates are reviewed by Meta within 24–48 hours. Conversational replies (within 24 hours of a subscriber message) do not need templates.

Using WhatsApp Chat in Qserve

Once configured, go to Admin → WhatsApp to see the conversation inbox. All inbound messages from subscribers appear here. Click a conversation to reply. You can also initiate a message to any subscriber from their profile page.