WPP_Whatsapp

WPP_Whatsapp is a powerful Python library built on top of WPPConnect, bringing WhatsApp Web automation to Python developers.

📚 Looking for documentation? Check out our Complete Documentation

✨ Features

Feature	Status
Automatic QR Refresh	✅
Send text, image, video, audio, documents	✅
Get contacts, chats, groups, group members	✅
Send contacts, stickers, locations	✅
Multiple Sessions Support	✅
Forward Messages	✅
Receive Messages with Callbacks	✅
Group Management	✅
Business Features	✅
Rate Limiting	✅

🚀 Quick Start

Installation

Using pip:

pip install wpp-whatsapp

Using uv (Recommended):

uv add wpp-whatsapp

Your First Bot (2 minutes)

from WPP_Whatsapp import Create

# Create and start client
creator = Create(session="mybot")

client = creator.start()
# Define message handler
def on_message(msg):
    if msg.get('body') and not msg.get('isGroupMsg'):
        # Auto-reply
        client.sendText(msg.get('from'), "Thanks for your message! 🤖")

# Register handler
client.on_message(on_message)

# Start bot
print("Bot started! Scan QR code...")
client.start()

That's it! Your WhatsApp bot is now running! 🎉

📚 Documentation

We've created comprehensive documentation to help you:

📘 Quick Start Guide - Get started in 5 minutes
📖 API Reference - Complete method documentation
🔧 Troubleshooting - Common issues and solutions
💡 Examples - Code examples for every use case
⚡ Advanced Examples - Advanced patterns and features

Start here: Complete Documentation Index

💡 Examples

Send Messages

from WPP_Whatsapp import Create

creator = Create(session="test")
client = creator.start()
# Send text
client.sendText("1234567890@c.us", "Hello!")

# Send image
client.sendImage("1234567890@c.us", "image.jpg", "Beautiful sunset!")

# Send file
client.sendFile("1234567890@c.us", "document.pdf", "Here's the document")

# Send location
client.sendLocation("1234567890@c.us", 40.7128, -74.0060, title="New York")

Receive Messages

from WPP_Whatsapp import Create

creator = Create(session="test")
client = creator.start()

def on_message(message):
    # Ignore group messages
    if message.get('isGroupMsg'):
        return
    
    # Process message
    chat_id = message.get('from')
    text = message.get('body')
    
    if 'hello' in text.lower():
        client.sendText(chat_id, "Hi there! 👋")

client.on_message(on_message)
client.start()

Group Management

from WPP_Whatsapp import Create

creator = Create(session="test")
client = creator.start()

# Create group
group = client.createGroup("My Group", ["123@c.us", "456@c.us"])

# Add participant
client.addParticipant(group['gid'], "789@c.us")

# Send message to group
client.sendText(group['gid'], "Hello everyone!")

More Examples

📂 Basic Examples - Core functionality
⚡ Advanced Examples - Complex patterns
🗂️ Archive - Additional examples

🎯 Use Cases

WPP_Whatsapp can be used for:

🤖 Chatbots - Customer service automation
📢 Broadcasting - Safe bulk messaging with rate limiting
👥 Group Management - Automated group administration
📊 Analytics - Message tracking and statistics
🔄 Integration - Connect WhatsApp with other services
📱 Auto-replies - Intelligent response systems

⚠️ Important Notes

Rate Limiting

Always use rate limiting for bulk operations to avoid bans:

import time

contacts = ["123@c.us", "456@c.us"]
for contact in contacts:
    client.sendText(contact, "Hello")
    time.sleep(2)  # 2 second delay

Best Practices

✅ Handle errors gracefully
✅ Use unique session names
✅ Implement reconnection logic
✅ Test with small groups first
✅ Respect WhatsApp's terms of service

🆘 Need Help?

Documentation

Community

📦 Project Structure

WPP_Whatsapp/
├── WPP_Whatsapp/      # Main package
├── docs/              # Documentation
├── examples/          # Basic examples
├── scripts/           # Advanced examples
├── archive/           # Additional examples
├── tests/             # Test suite
├── README.md          # This file
├── pyproject.toml     # Project configuration
└── CHANGELOG.md       # Version history

🤝 Contributing

We welcome contributions! Here's how you can help:

📝 Improve documentation
🐛 Report bugs
💡 Suggest features
🔧 Submit pull requests
📚 Add examples

See Contributing Guide for details.

📄 License

This project is licensed under the MIT License.

🙏 Acknowledgments

Built on top of WPPConnect
Powered by Playwright

Made with ❤️ by Ammar Alkotb

Happy Coding! 🎉

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wpp_whatsapp-1.0.2.tar.gz (111.5 kB view details)

Uploaded Apr 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

wpp_whatsapp-1.0.2-py3-none-any.whl (114.2 kB view details)

Uploaded Apr 14, 2026 Python 3

File details

Details for the file wpp_whatsapp-1.0.2.tar.gz.

File metadata

Download URL: wpp_whatsapp-1.0.2.tar.gz
Upload date: Apr 14, 2026
Size: 111.5 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for wpp_whatsapp-1.0.2.tar.gz
Algorithm	Hash digest
SHA256	`f8f7f439933922b2dc3abccc4997dbca8cdbf64ea49fd37644d39def886603fd`
MD5	`1cd853a723774beb58751c71e751bedf`
BLAKE2b-256	`978f15ddd43b37137c8689c0199e7d9421cceb6e2378580556904a92b450f5e6`

See more details on using hashes here.

File details

Details for the file wpp_whatsapp-1.0.2-py3-none-any.whl.

File metadata

Download URL: wpp_whatsapp-1.0.2-py3-none-any.whl
Upload date: Apr 14, 2026
Size: 114.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for wpp_whatsapp-1.0.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`87442e117e41e29beb893acad33ff4c2db61caa8fd69d863309c6fd0e069e598`
MD5	`95102c8ee7736fb4659a0f8fe348cabe`
BLAKE2b-256	`3004044bd7b236205a3257e76192f075fecef7f570ac5dc99748441a4ea010cd`