Telegram Bot API

Commercial

by Telegram

Free HTTP API for building Telegram bots, one of the most-used notification and community channels among Singapore developers, businesses and even government services. Instant setup with a single token from BotFather.

How to authenticate

  1. 1In Telegram, message @BotFather and send /newbot.
  2. 2Choose a name and username; BotFather replies with your bot token.
  3. 3Call methods as https://api.telegram.org/bot<TOKEN>/METHOD.
  4. 4Get your chat id by messaging the bot and calling getUpdates.

Example request

Request
curl 'https://api.telegram.org/botTOKEN/sendMessage?chat_id=123456789&text=Deploy+complete'

Example response

Response (truncated)
{"ok":true,"result":{"message_id":42,"chat":{"id":123456789,"type":"private"},"text":"Deploy complete"}}

Notes for AI agents

Zero-friction: no review, no billing, works in seconds, which is why SG teams default to it for internal alerts. Use webhooks (setWebhook) instead of polling in production.

Machine-readable version: /api/apis/telegram-bot-api

Related APIs