WhatsApp AI Bot for Nail Salons

What WhatsApp Co-Pilot Actually Does
✅ Understands any message

• Customers can write:
• “Tomorrow morning”
• “Next week”
• “Around 3pm”
• “Can I move my nails to 10am?”

The system interprets everything using natural language + real-time date logic ({{$now}}), then processes availability automatically.

🧠 A True Multi-Agent Brain
Instead of one overloaded bot, the system uses 5 specialized AI agents:

1. Intent Agent – Reads the incoming message, decides what the user wants
2. Booking Agent – Creates new appointments, checks availability
3. Cancellation Agent – Cancels appointments instantly
4. Update Agent – Modifies existing bookings
5. General Agent – Answers business questions (prices, services, hours)

This modular design prevents chaos and keeps responses accurate.

⚙️ The Real Magic — Reliability
Most “AI bots” break when one API fails.
This system doesn’t.
It includes a multi-layer backup and error handling system:

• If Gemini fails → switch to OpenAI
• If OpenAI fails → switch to Gemini
• If both fail →
• Customer receives: “Give me a moment 👍”
• Owner receives WhatsApp + email alert
• Owner can reply manually
• No customer is left hanging

This is how production AI should work.

📨 Smart Message Batching
Customers rarely send one clean message.
They send 6 messages in 10 seconds.
So the system:

• Stores messages in Redis
• Waits 8 seconds
• Resets the timer if the user sends more
• Combines everything into one clean input

This avoids confusion, saves tokens, and improves accuracy
.
📆 Live Availability + Calendar Sync
Every action updates:

• Google Calendar (primary source of truth)
• Airtable (customer & appointment database)

Your Co-Pilot never double books and always checks your schedule before confirming.

🔁 Admin Agent: For the Business OwnerThe owner can use WhatsApp to command the system:

• “Cancel Anna tomorrow”
• “Move Carlos to 11am”