Integrations
Facebook Messenger
How to get your Facebook Messenger API key and connect it to Nova Admin.
Create a Meta app with Messenger product, connect a Facebook Page, get Page Access Token, App Secret, and set webhook verify token.
Prerequisites
- A Facebook Messenger account. Sign up at https://developers.facebook.com/docs/messenger-platform.
- An active Nova Admin workspace. Go to /agents/integrations to connect.
Steps
- Create a Meta app at developers.facebook.com and add the Messenger product.
- Connect a Facebook Page and generate a Page 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/messenger and subscribe to messages, messaging_postbacks, and message_deliveries.
- In Nova Admin > Integrations > Facebook Messenger paste Page Access Token, App Secret, Verify Token, and optional Page ID.
Credential fields
| Field | Required | Description |
|---|---|---|
| Page Access Token | Yes | Secret — stored encrypted, never exposed. |
| App Secret | Yes | Secret — stored encrypted, never exposed. |
| Webhook Verify Token | Yes | Secret — stored encrypted, never exposed. |
| Page ID | No | string |
Troubleshooting
- Invalid credentials: verify the key was copied in full with no trailing spaces.
- Key not working: check that your Facebook Messenger account has API access enabled and billing is active if required.
- Need help?: refer to the Facebook Messenger documentation.