• API
• Working with bots

Working with bots, using the MTProto API.

See here for more info about bots.

Please note that you can also use the simplified HTTP Bot API to use bots, see here for more info ».

Login

---functions---

auth.importBotAuthorization#67a3ff2c flags:int api_id:int api_hash:string bot_auth_token:string = auth.Authorization;

In order to log in as a bot, instead of using the standard login code flow, simply provide the bot token generated by @botfather.
You must still provide your API ID, as per user logins.

After successful authorization, you will be able to use most MTProto API methods, just as any normal user.
Methods that can be called by bots will have a Both users and bots can use this method or Only bots can use this method notice.

Managed bots

Users can create managed bots (which are controlled by a specific manager bot) directly through the MTProto API, without interacting with @BotFather.

AI features

Telegram bots offer a number of features for AI chatbots.

Edit bot information »

Users can edit and localize the profile picture, name, about text and description of bots they own; the same can be done by the bots themselves.

Commands »

Bots offer a set of commands that can be used by users in private, or in a chat.

Buttons »

Users can interact with your bot via buttons or even inline buttons, straight from inline messages in any chat.

Menu button »

Bots can choose the behavior of the menu button shown next to the text input field.

Suggested bot admin rights »

Bots can suggest a set of admin rights when being added to groups and channels.

Inline queries »

Users can interact with your bot via inline queries, straight from the text input field in any chat.

Guest mode »

Guest bots can be queried by username from any non-secret chat, posting their results into the chat on behalf of the user that invoked them.

Bot-to-bot communication »

Bots may receive and send messages to and from other bots in groups, private chats and chats, if Bot-to-Bot Communication Mode is enabled.

Games »

Bots can offer users HTML5 games to play solo or to compete against each other in groups and one-on-one chats; how to work with games in the MTProto API.

Web apps »

Bots can offer users interactive HTML5 web apps to completely replace any website.

Affiliate programs

Developers can open affiliate programs for their mini app – allowing content creators, other mini app developers and any Telegram user to promote it and earn commissions on purchases made by people they referred.

Attachment menu »

Bots can install attachment menu entries, offering conveniently accessible, versatile web apps.

Business bots »

Users can connect Telegram bots that will process and answer messages on their behalf. This allows them to seamlessly integrate any existing tools and workflows, or add AI assistants that manage their chats.

Bot API dialog IDs

How to convert MTProto peer IDs to bot API dialog IDs and vice versa.

Third-party verification

To further improve transparency on Telegram, official third-party services are able to assign extra verification icons to user accounts and chats — in order to prevent scams and reduce misinformation.