Whatsappy is a Python library for interacting with WhatsApp Web using Selenium. With this library, you can automate WhatsApp tasks such as sending messages, creating groups, and more.
Whatsappy is a Python library for interacting with WhatsApp Web using Selenium. With this library, you can automate WhatsApp tasks such as sending messages, creating groups, and more.
You can install Whatsappy using pip:
pip install whatsappy-py
Here's an example of how you can use Whatsappy to send a message:
from whatsappy import Whatsapp
# Create a new instance of Whatsapp
whatsapp = Whatsapp()
# Create event handlers
@whatsapp.event
def on_ready():
print("WhatsApp Web is ready!")
@whatsapp.event
def on_message(chat):
print(f"New message from {chat.name}: {chat.message}")
# Open WhatsApp Web in Chrome
whatsapp.run()
# Select the chat you want to send a message to
chat = whatsapp.open("John Smith")
# Send a message
chat.send("Hello, John!")
# Close WhatsApp Web
whatsapp.close()
driver: webdriver.Chrome: The Chrome driver.unread_messages: List[UnreadMessage]: List of unread messages.me: Me: The current user.current_chat: str | None: The name of the current chat. Returns None if no chat is selected.run(): Opens WhatsApp Web in Chrome.close(): Closes the Chrome window.open(chat: str) -> (Chat | Group | None): Selects a chat by name and returns a Chat or Group instance. Returns None if the chat does not exist.name: str: The name of the user.about: str: The about of the user.profile_picture: JpegImageFile: The profile picture of the user.name: str: The name of the chat.number: str: The number of the chat.about: str: The about of the chat.profile_picture: JpegImageFile: The profile picture of the chat.last_message: Message | None: The last message of the chat.is_muted: bool: Whether the chat is muted or not.is_blocked: bool: Whether the chat is blocked or not.is_pinned: bool: Whether the chat is pinned or not.open(): Opens the chat.send(message: str, attachments: Optional[List[str]] = None, type: Optional[str] = "auto"): Sends a message to the chat.mute(): Mutes the chat.unmute(): Unmutes the chat.block(): Blocks the chat.unblock(): Unblocks the chat.clear(keep_starred: bool = False): Clears the chat messages.delete(): Deletes the chat.pin(): Pins the chat.unpin(): Unpins the chat.subject: str: The subject of the group.description: str: The description of the group.profile_picture: Optional[JpegImageFile]: The profile picture of the group.participants: int: The number of participants of the group.last_message: Message | None: The last message of the group.is_muted: bool: Whether the group is muted or not.is_pinned: bool: Whether the group is pinned or not.open(): Opens the group.send(message: str, attachments: Optional[List[str]] = None, type: Optional[str] = "auto"): Sends a message to the group.mute(): Mutes the group.unmute(): Unmutes the group.leave(): Leaves the group.clear(keep_starred: bool = False): Clears the group messages.pin(): Pins the group.unpin(): Unpins the group.promote(user: str): Promotes a user to admin.demote(user: str): Demotes a user from admin.chat: Chat | Group: The chat the message belongs to.author: str: The author of the message.content: str: The content of the message.timestamp: datetime.datetime: The timestamp of the message.attachments: List[str]: The attachments of the message.is_forwarded: bool: Whether the message is forwarded or not.is_reply: bool: Whether the message is a reply or not.reply(message: str, attachments: Optional[List[str]] = None, type: Optional[str] = "auto"): Replies to the message.name: str: The name of the chat.count: int: The number of unread messages in the chat.message: Optional[str]: The last message in the chat.reply(message: str, attachments: Optional[List[str]] = None, type: Optional[str] = "auto"): Replies to the unread chat with a message. and returns a Chat or Group instance.Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
If you like this project, please consider donating to help me continue working on it.
Whatsappy is licensed under the MIT License
FAQs
Whatsappy is a Python library for interacting with WhatsApp Web using Selenium. With this library, you can automate WhatsApp tasks such as sending messages, creating groups, and more.
We found that whatsappy-py demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.