WhatsApp Setup
Connect your WhatsApp Business number to Nexvox using the Meta WhatsApp Cloud API.
Prerequisites
- Meta for Developers account
- Meta Business Manager account
- A phone number not currently registered on WhatsApp, WhatsApp Business, or any WhatsApp Cloud API provider
1Create a Meta App
- Go to developers.facebook.com and sign in
- Click My Apps → Create App
- Select Business as the app type
- Enter an app name (e.g. "Nexvox – Acme Corp")
- Attach your Business Manager account
- Click Create App
2Add WhatsApp as a product
- On your app dashboard, scroll to Add Products to Your App
- Find WhatsApp and click Set Up
- Connect your WhatsApp Business Account (WABA) or create a new one
- Click Continue
3Collect your credentials
Navigate to WhatsApp → API Setup in the left sidebar. You'll find three values you need:
| Field | Where to find it |
|---|---|
Phone Number ID | Listed under "From" in the API Setup panel |
WABA ID | Shown at the top of the API Setup panel |
Access Token | Shown as "Temporary access token" — valid for 24 hours |
For production use: Generate a permanent System User access token instead of the 24-hour temporary token. Go to Business Settings → System Users → Generate Token and grant
whatsapp_business_messaging and whatsapp_business_management permissions.4Enter credentials in Nexvox
- In Nexvox, go to Settings → WhatsApp
- Paste your Phone Number ID, WABA ID, and Access Token
- Click Save
Nexvox encrypts and stores your access token securely.
5Configure the webhook
- In Meta, go to WhatsApp → Configuration → Webhook
- Click Edit
- Set the Callback URL to:
https://app.nexvox.co/api/webhook/whatsapp- Set the Verify Token — copy it from Nexvox → Settings → WhatsApp → Webhook Verify Token
- Click Verify and save
Meta sends a GET request to verify the token. Nexvox handles the challenge response automatically.
6Subscribe to webhook events
- Still in WhatsApp → Configuration → Webhook, click Manage
- Subscribe to these two events:
messagesReceives all incoming WhatsApp messagesmessage_template_status_updateTracks template approval status- Click Done
7Test the connection
Send a WhatsApp message to your connected number. It should appear in the Nexvox inbox within a few seconds.
If you don't see it:
- –Verify your webhook subscription is active in Meta
- –Check that your access token hasn't expired — switch to a System User token for production
- –Confirm the phone number is in production mode, not sandbox mode, in Meta
Still stuck? support@nexvox.co or WhatsApp us ↗