🇺🇸 English | 🇮🇷 Persian |
---|
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.
- 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.
-
Clone the Repository
git clone https://github.com/clonerdev/Telegram-Phone-Lookup-Bot.git cd Telegram-Phone-Lookup-Bot
-
Create and Activate a Virtual Environment
python -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
-
Install Dependencies
pip install -r requirements.txt
-
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
-
Initialize the Database
python -c "from database import init_db; init_db()"
-
Run the Bot
python bot.py
- 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.