agentconnect.agents.telegram.bot_manager module¶

Telegram bot lifecycle manager.

This module handles the initialization, startup, and shutdown of the Telegram bot, providing a clean interface for the agent to interact with the bot.

class TelegramBotManager(token, groups_file)¶

Bases: object

Manager for Telegram bot lifecycle and core functionality.

This class handles the initialization, startup, and shutdown of the Telegram bot, and provides methods for interacting with the bot.

Parameters:

token (str)
groups_file (str)

initialize_bot()¶

Initialize the bot and dispatcher.

Return type:: bool
Returns:: True if initialization was successful, False otherwise

initialize_tools()¶

Initialize Telegram-specific tools.

Return type:: bool
Returns:: True if initialization was successful, False otherwise

register_shutdown_handler(callback)¶

Register a shutdown handler with the dispatcher.

Parameters:: callback (Callable) – Async function to call on shutdown
Return type:: None

async start_polling()¶

Start the bot polling.

Return type:: bool
Returns:: True if polling started successfully, False otherwise

async stop_polling()¶

Stop the bot polling and clean up resources.

Return type:: None

async send_message(chat_id, text, reply_to_message_id=None)¶

Send a message to a Telegram chat.

Parameters:

chat_id (int) – Telegram chat ID
text (str) – Text to send
reply_to_message_id (Optional[int]) – Optional message ID to reply to

Return type:

Dict[str, Any]

Returns:

Dict with success status and message ID or error