Integrations
iMessage
How to get your iMessage API key and connect it to Nova Admin.
Connect Sendblue for the managed webhook path. BlueBubbles is an optional self-hosted backend that needs an always-on Mac.
Prerequisites
- A iMessage account. Sign up at https://sendblue.co/docs.
- An active Nova Admin workspace. Go to /agents/integrations to connect.
Steps
- Create a Sendblue account and copy the API key ID and secret key.
- Choose a long random webhook shared secret and configure Sendblue to send webhooks to /api/v1/webhooks/imessage.
- Select BlueBubbles only when an always-on Mac hosts the BlueBubbles server.
- In Nova Admin, save the backend credentials and webhook shared secret.
Credential fields
| Field | Required | Description |
|---|---|---|
| Backend | Yes | string |
| Sendblue API key ID | No | Secret — stored encrypted, never exposed. |
| Sendblue API secret key | No | Secret — stored encrypted, never exposed. |
| BlueBubbles server URL | No | string |
| BlueBubbles password | No | Secret — stored encrypted, never exposed. |
| Webhook shared secret | Yes | Secret — stored encrypted, never exposed. |
Troubleshooting
- Invalid credentials: verify the key was copied in full with no trailing spaces.
- Key not working: check that your iMessage account has API access enabled and billing is active if required.
- Need help?: refer to the iMessage documentation.