Skip to content

The Telegram Phone Lookup Bot is a Telegram bot that allows you to query phone numbers through various services such as TrueCaller, Numberbook, Numverify, OpenCNAM, and a local database. The bot also provides administrative capabilities for viewing and managing user activities and searches.

License

Notifications You must be signed in to change notification settings

clonerdev/Telegram-Phone-Lookup-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Telegram Phone Lookup Bot - Telegram bot search phone number identity

🇺🇸 English 🇮🇷 Persian

Description (English)

Project Introduction

The Telegram Phone Lookup Bot is a Telegram bot that allows you to query phone numbers through various services such as TrueCaller, Numberbook, Numverify, OpenCNAM, and a local database. The bot also provides administrative capabilities for viewing and managing user activities and searches.

Features

  • Phone Number Lookup: Check phone numbers using TrueCaller, Numberbook, Numverify, OpenCNAM, and a local database.
  • User Management: Restrict and unrestrict users.
  • Admin Management: Add and view a list of admins.
  • Authorized Users: Add and view a list of authorized users.
  • Statistics and Reports: View reports and statistics of user searches.

Installation and Setup

  1. Clone the Repository

    git clone https://github.com/clonerdev/Telegram-Phone-Lookup-Bot.git
    cd Telegram-Phone-Lookup-Bot
  2. Create and Activate a Virtual Environment

    python -m venv venv
    source venv/bin/activate  # On Windows use `venv\Scripts\activate`
  3. Install Dependencies

    pip install -r requirements.txt
  4. Set Environment Variables

    Create a .env file in the project's root directory and configure the following variables:

    TELEGRAM_BOT_TOKEN=YOUR_TELEGRAM_BOT_TOKEN
    TRUECALLER_API_KEY=YOUR_TRUECALLER_API_KEY
    NUMBERBOOK_API_KEY=YOUR_NUMBERBOOK_API_KEY
    NUMVERIFY_API_KEY=YOUR_NUMVERIFY_API_KEY
    OPENCNAM_API_KEY=YOUR_OPENCNAM_API_KEY
    REDIS_HOST=localhost
    REDIS_PORT=6379
    REDIS_DB=0
    ADMIN_USER_ID=YOUR_TELEGRAM_USER_ID
  5. Initialize the Database

    python -c "from database import init_db; init_db()"
  6. Run the Bot

    python bot.py

Future Improvements

  • Add New Services: Integrate new services for phone number lookup.
  • Multi-language Support: Add support for multiple languages.
  • UI Enhancements: Add new features to the user interface and improve its appearance.
  • Rating System: Implement a rating system to limit the number of searches per user.

By following these instructions, you can set up and run the Phone Lookup Bot efficiently. The project can be extended and improved with additional features in future versions.

About

The Telegram Phone Lookup Bot is a Telegram bot that allows you to query phone numbers through various services such as TrueCaller, Numberbook, Numverify, OpenCNAM, and a local database. The bot also provides administrative capabilities for viewing and managing user activities and searches.

Topics

Resources

License

Stars

Watchers

Forks

Languages