botsapi

Bot API — Platform for Developers

Nova Team

We're excited to announce the Nova Bot API — a platform for building bots that interact with users inside Nova Messenger.

What are Nova Bots?

Bots are automated accounts that can receive messages, respond to commands, and send rich content including inline keyboards. Unlike regular accounts, bots are identified by an ID ending with _bot and authenticated via a unique bot token.

Getting Started

Creating a bot is simple:

  1. Open a chat with NovaFather in Nova Messenger
  2. Send the /newbot command
  3. Choose a display name for your bot
  4. Receive your bot token — store it securely

Key Features

  • Webhook support — receive updates via HTTPS POST to your server
  • Long-polling — alternative to webhooks for simpler setups
  • Inline keyboards — add interactive buttons to bot messages
  • HMAC-SHA256 signatures — verify webhook payload authenticity
  • Zero metadata — bot communications respect Nova's privacy architecture

API Endpoints

The Bot API provides 9 endpoints for bot management and messaging:

  • POST /v1/bot/register — register a new bot
  • POST /v1/bot/send — send a message from your bot
  • GET /v1/bot/getUpdates — poll for new messages
  • POST /v1/bot/setWebhook — configure webhook delivery

Check the full Bot API Documentation for complete reference.

What's Next

We're working on expanding bot capabilities:

  • Media message support (images, files)
  • Group chat bot interactions
  • Bot-to-bot communication
  • Scheduled messages

Stay tuned for updates.