> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alphscan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram bot (admin)

> Webhook and admin management for the Alphscan Telegram bot

This page is for **administrators** who operate the Alphscan Telegram bot: webhook configuration and managing bot admins. For **user** features (getting an API key, using the bot), see [Telegram bot (user)](/telegram-bot-user) in the Introduction tab.

## Webhook

The API exposes the public webhook endpoint used by Telegram to send updates to the bot:

* **POST** `/telegram/webhook` — receives Telegram updates. Configure this URL as the bot's webhook in the Telegram Bot API.

This endpoint is **public** (no API key). Only Telegram's servers should post to it. In deployment, set `TELEGRAM_BOT_TOKEN` and the public API base URL so the bot Lambda or handler can validate and process updates.

## Admin management

With an **admin** API key you can manage who has Telegram bot admin rights:

* **GET** `/system/telegram/admins` — list current Telegram admins
* **POST** `/system/telegram/admins/add` — add an admin
* **POST** `/system/telegram/admins/remove` — remove an admin

See the **API reference** tab (Swagger) under the Telegram tag for request/response schemas.

## Related

* [Generate API key](/generate-api-key) — How to obtain or create API keys (admin portal, Telegram, or API).