Paperplane
@paperplane_demo_bot
Built on Next.js · App Router

Your Telegram bot, served from your own domain

A minimal Telegram bot application: a landing page in front, a webhook route behind. Deploy it, attach a DNS record, and the bot answers in Telegram.

Open in TelegramCheck /api/health
connection
Bot username
@paperplane_demo_bot
Bot token
configured
Domain
localhost:3000
Webhook
http://localhost:3000/api/telegram/webhook

Webhook endpoint

POST /api/telegram/webhook receives updates, validates the secret header and replies through the Bot API.

Domain ready

One public HTTPS origin is all Telegram needs. Point an A/AAAA or CNAME record and the bot goes live.

Health probe

GET /api/health echoes back the host, protocol and forwarded headers as seen by the app.

Framework of choice

Next.js App Router, React Server Components and Tailwind CSS, ready for the real UI.

Go live in four commands

  1. 1
    npm install

    Install dependencies

  2. 2
    cp .env.example .env.local

    Add your bot token and domain

  3. 3
    npm run dev

    Start the app on :3000

  4. 4
    npm run webhook:set

    Register https://<domain>/api/telegram/webhook