https://github.com/imohraz/telegram-chat-bot

A Telegram bot built with Pyrogram that bridges the gap between users and admins for seamless two-way communication. Includes features like user management, message broadcasting, and chat moderation, all within a secure and user-friendly environment.
https://github.com/imohraz/telegram-chat-bot

chatbot telegram telegram-bot

Last synced: 8 months ago
JSON representation

A Telegram bot built with Pyrogram that bridges the gap between users and admins for seamless two-way communication. Includes features like user management, message broadcasting, and chat moderation, all within a secure and user-friendly environment.

• Host: GitHub
• URL: https://github.com/imohraz/telegram-chat-bot
• Owner: Imohraz
• License: mit
• Created: 2024-08-16T17:59:05.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-08-24T17:53:30.000Z (almost 2 years ago)
• Last Synced: 2025-07-13T06:56:03.595Z (12 months ago)
• Topics: chatbot, telegram, telegram-bot
• Language: Python
• Homepage:
• Size: 9.77 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Pyrogram Telegram Bot

## Introduction

The Pyrogram Telegram Bot is a versatile and interactive bot designed for managing user interactions and handling messages within Telegram. Built using the `Pyrogram` library, this bot offers a comprehensive set of functionalities that cater to both users and administrators. It provides an intuitive interface for users to engage with the bot and robust tools for administrators to manage and oversee interactions.

## Features

- **User Commands:**

  - **`/start`**: Initializes interaction with the bot. Adds the user to the bot's list and forwards their initial message to the admin.

  - **`/cancel`**: Allows users to cancel the message sending process.

  - **`/help`**: Provides users with information on how to use the bot and its features.

  - **`/bug`**: Enables users to report issues directly to the admin.

  - **`/broadcast`**: Allows the admin to send a message to all users.

- **Message Management:**

  - **Forwarding Messages**: Forwards user messages to the admin, providing options to respond, block/unblock users, or view user information.

  - **Reply Handling**: Admin can reply to messages sent by users and manage their requests effectively.

- **Administrative Controls:**

  - **Toggle Bot Status**: Admin can turn the bot on or off using commands (`/on` and `/off`), controlling its availability for users.

  - **User Information**: Admin can view detailed user information, including profile photos and personal details.

  - **Blocking and Unblocking Users**: Admin can block or unblock users, managing who can send messages to the bot.

  - **Broadcasting Messages**: Admin can broadcast messages to all users, allowing for announcements and updates.

## Future Improvements

The bot is designed to provide essential functionalities for managing user interactions and administrative tasks. However, there are always opportunities for further enhancement. Some potential improvements include:

- **Advanced User Analytics**: Implementing more detailed analytics and reporting features for user interactions.

- **Enhanced User Management**: Adding more granular controls for user management and permissions.

- **Customizable Responses**: Allowing for customizable responses and interactions based on user profiles or message content.

To contribute to the project's development or to add new features, consider forking the repository and submitting your enhancements. Your contributions will help make the bot more robust and feature-rich for all users.

# Setting Up and Running the Pyrogram Telegram Bot

## Prerequisites

Before you begin, make sure you have the following:

- Python 3.7 or later installed on your system.

- A Telegram account to create a bot and get API credentials.

## Set Up the Bot

```bash

pip install pyrogram tgcrypto