Neurotech-HQ

heyoo: Connect Python Apps to WhatsApp Cloud API

heyoo is an unofficial Python wrapper for WhatsApp Cloud API, covering message sending and webhook payload handling. It suits Python developers building WhatsApp messaging or support workflows who want a library-level interface instead of assembling API requests themselves.

View on GitHub Compare
Stars
513
Forks
112
Stars, last 30 days
+3

Our take

Health score

29/100

How it is scored
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.

Selected snapshot

Stars

514

Forks

112

Change 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.
ProjectLanguageLicenseStarsStatus
heyooPythonMIT513Not checked yet
wa-jsTypeScriptApache-2.0817Active

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.

Comparisons