Integrations
Telegram
How to get your Telegram API key and connect it to Nova Admin.
Create a bot with @BotFather, point its webhook at /api/v1/webhooks/telegram with a secret token, then connect the bot token in Nova Admin. Once connected, Nova can receive messages and send text replies, media, typing indicators, message edits, and inline-keyboard approval cards. Per-agent bots can instead use the agent's Telegram invocations settings.
Prerequisites
- A Telegram account. Sign up at https://core.telegram.org/bots#how-do-i-create-a-bot.
- An active Nova Admin workspace. Go to /agents/integrations to connect.
Steps
- Message @BotFather on Telegram, run /newbot, and record the bot token it issues.
- Choose a webhook secret ([A-Za-z0-9_-] only — never reuse the bot token, which contains a colon).
- Call setWebhook: https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://nova-os.netlify.app/api/v1/webhooks/telegram&secret_token=<WEBHOOK_SECRET> (same path on your Nova host).
- In Nova Admin, open /agents/integrations, select Telegram, and enter the bot token and webhook secret.
Credential fields
| Field | Required | Description |
|---|---|---|
| Bot Token | Yes | Secret — stored encrypted, never exposed. (e.g. 123456789:ABC-DEF…) |
| Webhook Secret | Yes | Secret — stored encrypted, never exposed. (e.g. secret_token from your setWebhook call) |
Troubleshooting
- Invalid credentials: verify the key was copied in full with no trailing spaces.
- Key not working: check that your Telegram account has API access enabled and billing is active if required.
- Need help?: refer to the Telegram documentation.