Integrations
Signal
How to get your Signal API key and connect it to Nova Admin.
Signal has no official bot API. Nova calls a persistent signal-cli-rest-api service that owns the registered number and receives webhooks.
Prerequisites
- A Signal account. Sign up at https://github.com/bbernhard/signal-cli-rest-api.
- An active Nova Admin workspace. Go to /agents/integrations to connect.
Steps
- Run signal-cli-rest-api with a registered Signal number.
- Configure its receive webhook to POST to /api/v1/webhooks/signal.
- Set the same shared webhook secret in signal-cli-rest-api and Nova Admin.
- Save the server URL, registered number, and webhook secret in Nova Admin.
Credential fields
| Field | Required | Description |
|---|---|---|
| Server URL | Yes | string |
| Registered number | Yes | string |
| 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 Signal account has API access enabled and billing is active if required.
- Need help?: refer to the Signal documentation.