This project is a WhatsApp automation bot developed using Selenium WebDriver. The bot provides various functionalities such as logging in, sending messages, sending media, and checking for new messages on WhatsApp Web.
- Login Automation: Automatically logs into WhatsApp Web and persists session data.
- Message Sending: Send text messages and media (images/videos) to specific contacts.
- Chat Management: Open chats by contact name and navigate through chats.
- QR Code Generation: Generates QR codes for WhatsApp Web login.
- Message Retrieval: Retrieve the last message from a chat.
- New Message Notifications: Check for new messages and handle notifications.
To use this bot, follow these steps:
-
Clone the Repository:
git clone https://github.com/marco0antonio0/py-connector-whatsapp-unofficial
cd py-connector-whatsapp-unofficial
-
Install Dependencies: Ensure you have Python installed. Then install the required Python packages:
pip install selenium webdriver-manager pillow
-
Start the code of the path main: for the start python script, so execute :
python3 main.py
-
Now to necessary login: The login is necessary for the use script where is execute in localhost when the your machine Now check if the bash console is if the show you an qrcode message
-
Now this code is Already complete start: The started progamme is sucessfull
- The guide thating is the main.py file
-
Initialize the Bot:
from services import automation # with interface = true #without interface = false // terminal acess bot = automation(gui=False)
-
Start the Bot:
# if gui= true so the show with interface # else so the without interface bot.start(gui=false)
-
Send a Message:
bot.openChatByContact("Contact Name") bot.sendMensage("Hello, this is a test message!")
-
Send an Image with Text:
bot.sendImageWithText("path/to/image.jpg", "Here is an image with a caption!")
-
Check for New Messages:
new_message = bot.VerificarNovaMensagem() if new_message: print("New message from:", new_message)
-
Retrieve Last Message:
last_message = bot.pegar_ultima_mensagem() print("Last message:", last_message)
-
Exit the Bot:
bot.exit()
py-connector-whatsapp-unofficial/
│
├──main.py
├── requirements.txt # List of dependencies
├── README.md # Project documentation
├── dados/ # Directory to store session data
└──servies/
├── bot.py # Main bot class and functionalities
└── generateQRcode.py # QR code generation module
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Commit your changes (
git commit -m 'Add new feature'
). - Push to the branch (
git push origin feature-branch
). - Open a Pull Request.
This project is licensed under the MIT License. See the LICENSE file for details.
- Selenium - WebDriver for browser automation.
- webdriver-manager - For managing WebDriver binaries.
- Pillow - Python Imaging Library for handling images.
For any questions or suggestions, feel free to open an issue or contact me at [email protected].