Skip to content

Implementation of Whatsapp adapter #242

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Draft
wants to merge 15 commits into
base: main
Choose a base branch
from
Draft

Implementation of Whatsapp adapter #242

wants to merge 15 commits into from

Conversation

hvpareja
Copy link

Adds a WhatsApp Business API integration for AG-UI, enabling conversational AI agents to interact with users through WhatsApp.

Features

✅ Basic WhatsApp message sending/receiving
✅ AI integration (OpenAI, Anthropic)
✅ Webhook signature verification
✅ Media message support
✅ Comprehensive documentation and examples

Usage

import { WhatsAppAgent } from "@ag-ui/community-whatsapp";

const agent = new WhatsAppAgent({
  phoneNumberId: "your-phone-number-id",
  accessToken: "your-access-token",
  webhookSecret: "your-webhook-secret",
});

await agent.handleWebhook(webhookBody, signature);

Documentation

README.md - Setup tutorial and usage examples
ARCHITECTURE.md - Technical architecture overview (perhaps this can be content for docs)

Testing

pnpm run typecheck
npx tsx src/tests/simple-test.ts

@hvpareja hvpareja marked this pull request as ready for review July 31, 2025 15:50
@hvpareja hvpareja marked this pull request as draft August 3, 2025 06:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@mme mme Awaiting requested review from mme mme is a code owner

@ranst91 ranst91 Awaiting requested review from ranst91 ranst91 is a code owner

@ataibarkai ataibarkai Awaiting requested review from ataibarkai ataibarkai is a code owner

@maxkorp maxkorp Awaiting requested review from maxkorp maxkorp is a code owner

@tylerslaton tylerslaton Awaiting requested review from tylerslaton tylerslaton is a code owner

@NathanTarbert NathanTarbert Awaiting requested review from NathanTarbert NathanTarbert is a code owner

At least 1 approving review is required to merge this pull request.

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
1 participant
@hvpareja