Before you begin
- ✓NIVA botmaster account with a bot configured
- ✓Meta Business Account (verified)
- ✓Meta Developer account
- ✓A phone number to register for WhatsApp Business
Step-by-step setup
- 1
Create a Meta Developer App
- Go to https://developers.facebook.com → My Apps → Create App
- Select Business type
- Enter a name and contact email → Create App
- Add the WhatsApp product from the dashboard
- 2
Set Up WhatsApp Business Account
- In your app → WhatsApp → API Setup
- Create or connect a WhatsApp Business Account (WABA)
- Add and verify your Phone Number
- Note the Phone Number ID (shown in API Setup · not the phone number itself)
- 3
Generate a Permanent Access Token
- In Meta Business Suite → Settings → Business Assets → System Users
- Create a System User with Admin role
- Click Generate New Token → select your app → add
whatsapp_business_messagingpermission - Copy the generated token · this is your permanent access token
System User tokens do not expire unlike regular user tokens. - 4
Get App Secret
- App dashboard → Settings → Basic
- Copy the App Secret
- 5
Configure in NIVA Botmaster
- Open your NIVA botmaster → Omnichannel
- Click Configure on the WhatsApp (Meta Cloud API) card
- Paste Permanent Access Token, Phone Number ID, App Secret
- Enter a Verify Token · any secret string you choose
- Click Save & Activate
- Copy the Webhook URL
- 6
Configure Webhook in Meta
- App dashboard → WhatsApp → Configuration
- Under Webhook click Edit
- Paste your NIVA Webhook URL and your Verify Token
- Click Verify and Save
- Under Webhook fields, subscribe to
messages
- 7
Test the Integration
- Send a WhatsApp message to your registered business number
- The bot should reply within 2–3 seconds
During development, only numbers added as testers in Meta can message your bot.
Troubleshooting
Webhook verification fails
Verify Token mismatch · paste the exact same token in both places.
No reply
Check messages is subscribed in webhook fields. Check phone number is verified.
Token expired error
Use a System User token · regular user tokens expire.
Message not delivered
Outside of 24h window · you need a pre-approved message template.