# WhatsApp Cloud API

Drop-in Convex component for the WhatsApp Cloud API — send & receive messages, track delivery, and manage conversations reactively

This is an upstream package. It has not been adapted or qualified for Bijection.

- Package: convex-whatsapp
- Source: https://github.com/david-potgieter/convex-whatsapp
- npm: https://www.npmjs.com/package/convex-whatsapp
- Directory: https://bijection.com/components/convex-whatsapp

Read the upstream README for setup, license, and compatibility before using it.

## Upstream package documentation

Recorded 2026-10-23. This describes convex-whatsapp; check the Bijection adaptation separately.

A Convex component that wraps the WhatsApp Cloud API to enable messaging functionality within your Convex application. It provides reactive message handling, delivery tracking, and conversation management through Convex functions and database integration. The component eliminates the need to manually handle WhatsApp webhook integrations and API authentication.

### Use cases

• Build customer support chat systems with automated responses and human handoff workflows
• Create notification systems that send order updates, appointment reminders, or shipping alerts via WhatsApp
• Implement two-way messaging for booking confirmations, survey collection, or feedback gathering
• Add WhatsApp integration to existing Convex apps without managing webhook infrastructure
• Track message delivery status and conversation state reactively in your database

### How it works

The component integrates with WhatsApp Cloud API through Convex actions that handle outbound messaging and webhook processing for inbound messages. It stores conversation data and message history in your Convex database, making all WhatsApp interactions queryable through standard Convex queries.

Incoming messages trigger Convex functions that can process content, update conversation state, and trigger automated responses. The reactive nature of Convex ensures your UI stays synchronized with message status changes and new incoming messages without additional polling or websocket management.

Setup involves configuring your WhatsApp Business API credentials and webhook endpoints through the component's configuration system. The component handles API authentication, rate limiting, and error handling while exposing clean Convex function interfaces for sending messages and querying conversation data.