WA-contact: Unlock Your WhatsApp Network

Overview 💬

WA-contact is a project aimed at providing users with a seamless way to export and manage their WhatsApp contacts. By extracting contact information from both personal chats and groups, users can gain insights into their network and utilize this data for various applications, such as marketing campaigns, personal networking, or data analysis.

Features 🫧

• Comprehensive Contact Export: Export contacts from both personal chats and all groups where the user is a participant.
• Data Cleaning and Formatting: Automatically cleans and formats contact data for easy analysis and utilization.
• Multi-format Export: Provides contact data in JSON, CSV, and PDF formats for flexibility in usage.
• Categorization: Automatically categorizes groups and contacts based on predefined keywords.
• User-friendly Output: Generates well-structured JSON, CSV, and PDF files for easy access and interpretation.

Note: This project is currently in development, some features might not work as expected like, categorization & PDF layout.

Usage 🔥

1. Git clone the repository and install the dependencies:

git clone https://github.com/yesbhautik/WA-contact.git
cd WA-contact
npm install

2. Export your WhatsApp chat history to get contacts using the following steps:

npm run dev

Process: After running the above command, wait for few secconds then enter country code in the terminal, then enter your phone number, and you will get notification on your WhatsApp to enter authentication code. After entering the code, wait for couple of minutes to get all the contacts & press Ctrl + C to stop the process.

3. Data cleaning and formatting:

npm run data-clean

You can find the cleaned data in the clean-data folder in JSON, CSV, and PDF formats.

Future Enhancements 📦

• Real-time Data Sync: Implement features to sync data directly from WhatsApp in real-time.
• Advanced Analytics: Incorporate data analytics tools to provide insights into contact patterns and group dynamics.
• Customizable Categories: Allow users to define their own categories for contacts and groups.

Contributing 🤝

Contributions are welcome! Please follow these steps to contribute to the project:

Fork the repository🍴

Create a new branch for your feature or bug fix 🌿

Make your changes and commit them 💻

Push your changes to your fork 🚀

Create a pull request to the main repository 📥

Show some support | Donation 🔥

If you find this repository helpful, show your support by giving it a 🌟! Your support means a lot to me and helps me keep contributing to the open-source community.

Also, if you'd like to support & motivate me for hard work, you can do so via my donation link: https://rzp.io/l/Whatsapp-Ai-BOT

Let's Connect 💬

Feel free to reach out to us if you have questions, ideas, or simply want to chat. We're here to help and connect with the community.

Website | YesbhautikX | LinkedIn | GitHub

License 📜

This repository is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. For more information, see the LICENSE file.