Integrations
How to get your WhatsApp API key and connect it to Nova Admin.
Create a Meta app with WhatsApp product, get Phone Number ID, WABA ID, System User Access Token, App Secret, and set webhook verify token.
Prerequisites
- A WhatsApp account. Sign up at https://developers.facebook.com/docs/whatsapp/cloud-api.
- An active Nova Admin workspace. Go to /agents/integrations to connect.
Steps
- Create a Meta app at developers.facebook.com and add the WhatsApp product.
- Under WhatsApp > API Setup copy Phone Number ID and generate a System User Access Token.
- Under App Settings > Basic copy App Secret. Choose a random Webhook Verify Token.
- Set your webhook URL to https://<your-host>/api/v1/webhooks/whatsapp and subscribe to messages.
- In Nova Admin > Integrations > WhatsApp paste all five values.
Credential fields
| Field | Required | Description |
|---|---|---|
| System User Access Token | Yes | Secret — stored encrypted, never exposed. |
| Phone Number ID | Yes | string |
| App Secret | Yes | Secret — stored encrypted, never exposed. |
| Webhook Verify Token | Yes | Secret — stored encrypted, never exposed. |
| WABA ID | No | string |
Troubleshooting
- Invalid credentials: verify the key was copied in full with no trailing spaces.
- Key not working: check that your WhatsApp account has API access enabled and billing is active if required.
- Need help?: refer to the WhatsApp documentation.