Skip to main content

Telegram App Flow

This page explains how Telegram works with Nova.

User journey

  1. User starts the bot.
  2. User links account with the dashboard flow.
  3. User sends natural-language requests in Telegram.
  4. Nova runs the same runtime safety logic used in API/dashboard.
  5. For mutating actions, Nova asks for approval before execution.

Main endpoints

  • POST /v1/telegram/app/webhook
  • POST /v1/telegram/app/link/complete

Current experience

  • command support exists (/start, /help, etc.)
  • natural-language messages are supported and preferred
  • reconnect guidance is shown in-chat when integrations are missing

Safety notes

  • callback confirmations are ownership-checked
  • callback confirmations are replay-protected
  • callback paths are rate-limited