Our take
- Activity
- 19
- Community
- 56
- Issues
- 21
- Pull requests
- 20
+3 stars in the last 30 days
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
514Forks
112Change since Nov 17, 2026: 0 stars·0 forks
Overview
heyoo is an unofficial Python wrapper for the WhatsApp Cloud API. It provides methods for common messaging operations and helpers for interpreting incoming webhook data, reducing the amount of request and payload handling an application needs to implement directly.
It is intended for developers building Python services that send WhatsApp messages or respond to user messages. It is a wrapper for Meta's API, not a hosted messaging service: applications still need WhatsApp Cloud API credentials and their own webhook setup when handling incoming events.
Key Features
- Send text messages and mark messages as read.
- Send images, audio, video, documents, and locations.
- Upload local media and send it using the returned media ID.
- Send template messages, including templates with components.
- Send interactive list buttons and reply buttons.
- Parse incoming message types and retrieve message, contact, and media details from webhook data.
- Query and download media associated with incoming messages.
Use Cases
- A Python backend sending order updates or other approved template notifications to customers.
- A support team building a webhook handler that reads incoming text, interactive replies, or shared media.
- A service sending location or media messages as part of a customer communication flow.
- A developer prototyping a WhatsApp integration against a test number before using a production number.
Getting Started
Install from PyPI:
pip install --upgrade heyoo
Using the library requires a WhatsApp Cloud API token and phone_number_id. See the repository README for setup, usage examples, and webhook guidance.
Alternatives
- wa-js: wa-js automates WhatsApp Web through JavaScript, while heyoo wraps the official WhatsApp Cloud API in Python.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| heyoo | Python | MIT | 513 | Not checked yet |
| wa-js | TypeScript | Apache-2.0 | 817 | Active |
Considerations
- This is an unofficial wrapper, so developers should consult the official WhatsApp Cloud API documentation for platform requirements and behavior.
- Sending non-template messages depends on WhatsApp's messaging rules. The README notes that the recipient must first respond to a template or message, and that this allowance resets every 24 hours.
- Incoming-message handling requires configuring a webhook in the application; the package does not provide a hosted webhook service.
- The repository had 22 open issues in the supplied project data. Review current issues and API compatibility before relying on it in production.
Found this useful?
Share it with someone who would like heyoo.