lexy-boa/whatsapp-agentic-crm — explained in plain English
Analysis updated 2026-05-18
Automate WhatsApp customer support for a retail business, including product search and order lookups.
Handle customer voice notes in South Indian regional languages and dialects.
Route sensitive requests like refunds or payment disputes to a human instead of letting the AI answer.
Study a real world example of a single tool-using AI call replacing a multi step AI pipeline.
| lexy-boa/whatsapp-agentic-crm | 0xallam/my-recipe | 0xhassaan/nn-from-scratch | |
|---|---|---|---|
| Stars | 0 | — | 0 |
| Language | Python | Python | Python |
| Last pushed | — | 2022-11-22 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 4/5 | 2/5 | 4/5 |
| Audience | developer | general | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires Docker Compose and AI API keys (Claude, OpenAI, Groq), a demo catalog lets you try it without a real Shopify store.
This project, called Avni, is a customer service assistant that runs on WhatsApp for a fashion retail business. Customers can text or send voice notes, including in South Indian languages like Malayalam, Tamil, Telugu, and Kannada, and Avni searches the product catalog, checks whether items are in stock, looks up past orders, and hands the conversation over to a real person when the situation calls for it, such as a refund or a payment dispute. The published version has all real client details replaced with a fictional demo brand called DemoBoutique. The core of the system is a single call to Claude, Anthropic's AI model, that has access to four tools: one for searching products, one for checking inventory, one for looking up orders, and one for escalating to a human. Rather than running the conversation through several separate AI steps that each had to agree with the others, the model itself decides in one pass which of these tools it needs during a given exchange. The author explains that an earlier version of this system used eleven separate steps across two AI calls, and switching to this single tool using approach cut it down to seven steps and made it simpler to add new capabilities later. Voice notes go through a pipeline that transcribes speech using a Whisper model run through Groq, cleans up transcription errors, and detects which regional dialect is being spoken. Product search uses AI generated embeddings stored in a vector database called Qdrant, while PostgreSQL holds the core business data such as orders and inventory. A dashboard called the Control Room gives the business owner a view of conversations, escalations, and system health. The project runs in Docker containers alongside Postgres, Redis, and Qdrant, and includes a demo catalog so it can be tried locally without a real Shopify store. It ships with over 80 automated tests covering the tool logic, voice pipeline, and privacy safeguards.
Avni is a WhatsApp customer service assistant for a fashion retailer that uses a single Claude AI call with tools to search products, check stock, look up orders, and hand off to a human when needed.
Mainly Python. The stack also includes Python, FastAPI, PostgreSQL.
The README does not state a license, so usage terms are unclear.
Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.