Implementation of Whatsapp adapter

[hvpareja]

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