Overview
The ITelegramBotInfo interface and TelegramBotInfo implementation provide access to bot metadata and user information retrieved from the Telegram API.
ITelegramBotInfo Interface
Interface for providing bot information and metadata.
public interface ITelegramBotInfo
Telegrator.Configuration
Properties
Gets the User object representing the bot. This contains information such as:
Id - The bot’s unique identifierUsername - The bot’s username (without the @ symbol)FirstName - The bot’s display nameIsBot - Always true for botsCanJoinGroups - Whether the bot can be added to groupsCanReadAllGroupMessages - Whether the bot can read all messages in groupsSupportsInlineQueries - Whether the bot supports inline queries
TelegramBotInfo Class
Implementation of ITelegramBotInfo that provides bot information.
public class TelegramBotInfo : ITelegramBotInfo
Telegrator
Implements: ITelegramBotInfo
Constructor
public TelegramBotInfo(User user)
user
Telegram.Bot.Types.User
required
The User object containing bot information.
Properties
Gets the user information for the bot.
Usage Examples
using Telegrator;
using System;
var bot = new TelegratorClient("YOUR_BOT_TOKEN");
// Access bot information
var botInfo = bot.BotInfo;
var user = botInfo.User;
Console.WriteLine($"Bot ID: {user.Id}");
Console.WriteLine($"Username: @{user.Username}");
Console.WriteLine($"Display Name: {user.FirstName}");
Console.WriteLine($"Can Join Groups: {user.CanJoinGroups}");
Console.WriteLine($"Can Read All Messages: {user.CanReadAllGroupMessages}");
Console.WriteLine($"Supports Inline: {user.SupportsInlineQueries}");
Using Bot Info in Handlers
using Telegrator.Handlers;
using Telegrator.Annotations;
using Telegram.Bot.Types;
[CommandHandler]
[CommandAllias("info")]
public class BotInfoHandler : CommandHandler
{
public override async Task Execute(
IAbstractHandlerContainer<Message> container,
CancellationToken cancellation)
{
var botInfo = container.Client.BotInfo;
var user = botInfo.User;
var infoMessage = $"""
Bot Information:
━━━━━━━━━━━━━━━━
Name: {user.FirstName}
Username: @{user.Username}
ID: {user.Id}
Can Join Groups: {(user.CanJoinGroups == true ? "Yes" : "No")}
Inline Support: {(user.SupportsInlineQueries == true ? "Yes" : "No")}
""";
await Reply(infoMessage, cancellationToken: cancellation);
}
}
Checking Bot Capabilities
using Telegrator;
using System;
var bot = new TelegratorClient("YOUR_BOT_TOKEN");
var user = bot.BotInfo.User;
// Check if bot can be added to groups
if (user.CanJoinGroups == true)
{
Console.WriteLine("This bot can be added to groups.");
}
// Check if bot can read all group messages
if (user.CanReadAllGroupMessages == true)
{
Console.WriteLine("This bot has privacy mode disabled.");
}
else
{
Console.WriteLine("This bot has privacy mode enabled (only sees commands and mentions).");
}
// Check inline support
if (user.SupportsInlineQueries == true)
{
Console.WriteLine("This bot supports inline queries.");
}
using Telegrator;
using Microsoft.Extensions.Logging;
var bot = new TelegratorClient("YOUR_BOT_TOKEN");
var logger = LoggerFactory.Create(builder => builder.AddConsole())
.CreateLogger<Program>();
var user = bot.BotInfo.User;
logger.LogInformation(
"Bot started - ID: {BotId}, Username: @{Username}, Name: {Name}",
user.Id,
user.Username,
user.FirstName
);
bot.Handlers.CollectHandlersDomainWide();
bot.StartReceiving();
Validating Bot Configuration
using Telegrator;
using System;
var bot = new TelegratorClient("YOUR_BOT_TOKEN");
var user = bot.BotInfo.User;
// Validate bot is configured correctly
if (string.IsNullOrEmpty(user.Username))
{
throw new InvalidOperationException("Bot must have a username.");
}
if (user.IsBot != true)
{
throw new InvalidOperationException("Token does not belong to a bot account.");
}
Console.WriteLine($"Bot validation successful: @{user.Username}");
// Add handlers based on bot capabilities
if (user.SupportsInlineQueries == true)
{
bot.Handlers.AddHandler<InlineQueryHandler>();
Console.WriteLine("Inline query handlers registered.");
}
if (user.CanJoinGroups == true)
{
bot.Handlers.AddHandler<GroupManagementHandler>();
Console.WriteLine("Group management handlers registered.");
}
bot.StartReceiving();
Custom Bot Info Display
using Telegrator.Handlers;
using Telegrator.Annotations;
using Telegram.Bot.Types;
using Telegram.Bot.Types.Enums;
[CommandHandler]
[CommandAllias("about")]
public class AboutBotHandler : CommandHandler
{
public override async Task Execute(
IAbstractHandlerContainer<Message> container,
CancellationToken cancellation)
{
var botInfo = container.Client.BotInfo;
var user = botInfo.User;
var aboutText = $"""
<b>About This Bot</b>
<b>Name:</b> {user.FirstName}
<b>Username:</b> @{user.Username}
<b>Bot ID:</b> <code>{user.Id}</code>
<b>Features:</b>
{(user.CanJoinGroups == true ? "✅" : "❌")} Can join groups
{(user.CanReadAllGroupMessages == true ? "✅" : "❌")} Reads all messages
{(user.SupportsInlineQueries == true ? "✅" : "❌")} Inline queries
Built with Telegrator Framework
""";
await Reply(
aboutText,
parseMode: ParseMode.Html,
cancellationToken: cancellation
);
}
}
User Object Properties
The User object contains the following properties:
Unique identifier for this bot.
Bot’s username (without @ symbol).
IETF language tag of the bot’s language.
true if the bot can be invited to groups.
true if privacy mode is disabled for the bot.
true if the bot supports inline queries.
Notes
The bot information is automatically retrieved when the TelegratorClient is instantiated. This is done by calling the GetMe API method.
Creating a TelegratorClient instance will make an API call to retrieve bot information. Ensure you have a valid token and internet connection.
The BotInfo.User object is the same type used throughout the Telegram.Bot library, making it easy to work with in any context.
See Also