# heyoo: An Open-Source Python Wrapper for WhatsApp Cloud API

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/neurotech-hq-heyoo
Generated for open source discovery and AI-assisted research.

heyoo is an open-source Python wrapper designed to simplify interactions with the WhatsApp Cloud API. This library enables developers to easily send various message types, including text, media, location, and interactive buttons. It also provides robust features for handling incoming messages via webhooks, making it a comprehensive solution for WhatsApp automation.

GitHub: https://github.com/Neurotech-HQ/heyoo
OSRepos URL: https://osrepos.com/repo/neurotech-hq-heyoo

## Summary

heyoo is an open-source Python wrapper designed to simplify interactions with the WhatsApp Cloud API. This library enables developers to easily send various message types, including text, media, location, and interactive buttons. It also provides robust features for handling incoming messages via webhooks, making it a comprehensive solution for WhatsApp automation.

## Topics

- Python
- WhatsApp API
- Cloud API
- Messaging
- API Wrapper
- Open Source
- Developer Tools

## Repository Information

Last analyzed by OSRepos: Sun Oct 12 2025 11:16:32 GMT+0100 (Western European Summer Time)
Detail views: 1
GitHub clicks: 1

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

**heyoo** is an open-source Python wrapper developed by Neurotech-HQ, designed to simplify interactions with the WhatsApp Cloud API. It provides a robust and easy-to-use interface for developers to integrate WhatsApp messaging capabilities into their Python applications. With over 500 stars and 100 forks, heyoo is a popular choice for automating WhatsApp communications.

This library supports a wide range of features, including sending various message types, managing media, handling locations, and implementing interactive buttons and template messages. It also facilitates parsing incoming messages and setting up webhooks for real-time communication. Licensed under MIT, heyoo encourages community contributions and offers a flexible solution for your WhatsApp integration needs.

## Installation

Getting started with heyoo is straightforward, with options for installation via pip, from source, or using Docker.

### Via pip

The recommended way to install heyoo is using pip:

bash
pip install --upgrade heyoo


### From Source

If you prefer to build from the source, you can clone the repository and install it manually:

bash
git clone https://github.com/Neurotech-HQ/heyoo
cd heyoo
python setup.py install


### Running on Docker

For containerized deployments, heyoo provides Docker support:

bash
docker compose build
docker compose up


## Examples

heyoo simplifies common WhatsApp Cloud API operations. Here are some examples to get you started.

### Authentication

First, you need to authenticate your application using your `TOKEN` and `phone_number_id` obtained from the Facebook Developer Portal:

python
from heyoo import WhatsApp
messenger = WhatsApp('YOUR_TOKEN', phone_number_id='YOUR_PHONE_NUMBER_ID')


### Sending a Text Message

Sending a simple text message is as easy as calling the `send_message` method:

python
await messenger.send_message('Hello from heyoo!', 'RECIPIENT_MOBILE_NUMBER')


### Sending Images

You can send images either by providing a direct URL or by uploading a local file first:

python
# Sending an image from a URL
await messenger.send_image(
    image="https://i.imgur.com/Fh7XVYY.jpeg",
    recipient_id="RECIPIENT_MOBILE_NUMBER",
)

# Uploading and sending a local image
media_id = await messenger.upload_media(
    media='path/to/your/image.jpg',
)['id']
await messenger.send_image(
    image=media_id,
    recipient_id="RECIPIENT_MOBILE_NUMBER",
    link=False # Important for uploaded media
)


### Sending Template Messages

Template messages are pre-approved messages that can be customized with variables:

python
await messenger.send_template("hello_world", "RECIPIENT_MOBILE_NUMBER", components=[], lang="en_US")


### Handling Webhooks

heyoo also provides utilities for handling incoming messages via webhooks. You can find a starter webhook example in the repository to customize:

python
# Example snippet for handling incoming text messages
# (Full example available in heyoo's hook.py)
if changed_field == "messages":
    new_message = messenger.get_mobile(data)
    if new_message:
        mobile = messenger.get_mobile(data)
        name = messenger.get_name(data)
        message_type = messenger.get_message_type(data)
        if message_type == "text":
            message = messenger.get_message(data)
            await messenger.send_message(f"Hi {name}, you said: {message}", mobile)


## Why Use heyoo?

heyoo stands out as an excellent choice for WhatsApp Cloud API integration due to several compelling reasons:

*   **Simplicity and Ease of Use**: It abstracts away the complexities of the WhatsApp Cloud API, offering a clean and intuitive Python interface.
*   **Comprehensive Features**: From basic text messages to rich media, interactive buttons, and location sharing, heyoo covers a wide array of messaging functionalities.
*   **Robust Webhook Support**: Easily process incoming messages and events, enabling dynamic and responsive WhatsApp bots and applications.
*   **Active Development and Community**: Being open-source, it benefits from community contributions and active maintenance by Neurotech-HQ.
*   **Flexible Deployment**: Supports standard pip installation, source build, and Docker for various deployment scenarios.

## Links

*   **GitHub Repository**: [Neurotech-HQ/heyoo](https://github.com/Neurotech-HQ/heyoo)
*   **PyPI Package**: [heyoo on PyPI](https://pypi.org/project/heyoo/)
*   **WhatsApp Cloud API Official Documentation**: [Developers Facebook](https://developers.facebook.com/docs/whatsapp/cloud-api/)
*   **Facebook Developer Portal**: [Create Your App](https://developers.facebook.com/apps/create/)
*   **Medium Article**: [Programming WhatsApp is now even easier for Python Developers](https://mr-collins-llb.medium.com/programming-whatsapp-is-now-even-easier-for-python-developers-e1a4343deed6)