Hainrixz/whatsapp-agentkit

Construye tu agente de WhatsApp con IA en menos de 30 minutos. Claude Code te entrevista y escribe todo el código. Zernio o Meta Cloud API. Sin saber programar.

What it solves

WhatsApp AgentKit simplifies the creation and deployment of AI-powered WhatsApp customer service agents. It removes the "plumbing" work—handling webhooks, signatures, tokens, and deployment—allowing business owners to create a functional agent by simply answering questions about their business rather than writing code.

How it works

The project uses Claude Code to automate the entire development lifecycle. After running a setup script, the user interacts with Claude Code via a /build-agent command, which executes five phases:

  1. Environment Setup: Verifies Python and installs dependencies.
  2. Interview: Claude asks the user about their business name, purpose, tone, hours, and pricing/menus.
  3. Construction: Claude generates a full project structure including a FastAPI server, a "brain" connected to Claude API, memory for client history, and provider adapters.
  4. Testing: The user tests the agent via a local terminal chat simulator.
  5. Deployment: Guides the user through hosting on GitHub and Railway.

It supports two WhatsApp connection methods: Zernio (a simplified wrapper) and the Meta Cloud API (direct official access). To prevent duplicate messages and timeouts, it implements an immediate webhook response pattern and event deduplication.

Who it’s for

Business owners and builders (specifically targeting the LATAM market) who want an AI agent to handle FAQs, appointments, or lead qualification on WhatsApp without needing deep programming knowledge.

Highlights

  • No-Code Setup: The agent is built through a natural language interview with Claude Code.
  • Provider Flexibility: Easily switch between Zernio and Meta Cloud API using a pattern adapter.
  • Reliable Messaging: Prevents duplicate responses via event ID deduplication and asynchronous processing.
  • Secure Webhooks: Implements HMAC-SHA256 signature verification to prevent unauthorized message injection.
  • Memory Persistence: Maintains individual conversation histories for every customer.

Related

  • Project
  • Project
  • Project
  • Dispatch
  • Project