Inspiration
Small and medium service businesses (medical clinics, dental offices, beauty salons, wellness centers, and consultancies) lose up to 35% of potential bookings simply because they cannot answer WhatsApp messages after hours or while attending to in-person clients. Traditional appointment software requires customers to download apps or navigate complicated web portals, while basic chatbots frustrate users with rigid, robotic numeric menus.
We were inspired to build Whappify: a truly autonomous, empathetic, and context-aware AI receptionist that lives directly on WhatsApp—where customers already are. Powered by Google Gemini 2.5 Flash, Whappify transforms WhatsApp into a 24/7 revenue-generating front desk that converses naturally, checks real-time availability, schedules appointments, and synchronizes calendars without human intervention.
What it does
Whappify serves as an autonomous, multi-tenant AI receptionist for appointment-based businesses:
- 24/7 Conversational Booking: Customers chat naturally on WhatsApp to discover services, ask questions, and book appointments at any hour.
- Intelligent Skill Execution (Function Calling): Gemini autonomously invokes deterministic backend functions to:
- Fetch dynamic service catalogs and pricing (
obtenerCatalogoServicios). - Verify real-time slot availability (
consultarDisponibilidad). - Book, cancel, and manage appointments (
agendarCita,cancelarCita,obtenerMisCitas). - Check business operating hours (
obtenerHorariosAtencion).
- Fetch dynamic service catalogs and pricing (
- Real-time Google Calendar Sync: Automatically creates, updates, and releases calendar events with zero double-booking risk.
- Multi-Tenant Architecture: Securely isolates business data, staff schedules, and custom catalogs per enterprise via UUID tenant segregation.
- Instant Frictionless Communication: Eliminates app downloads and friction—appointments are confirmed with instant WhatsApp confirmation summaries.
- Dynamic Business Customization via Natural Prompts: Business owners can tailor the agent’s personality, policies, and active marketing campaigns (e.g., flash discounts, holiday schedules, package deals) on the fly through prompt injection, allowing the AI to organically cross-sell and inform customers.
How we built it
Whappify is built with a resilient, production-grade cloud architecture leveraging the Google Cloud and Gemini ecosystem:
- AI Core & Function Calling: Powered by Google Gemini 2.5 Flash using the official Google Cloud Vertex AI Java SDK (
com.google.cloud.vertexai). We engineered a declarative Tool Schema with 6 specialized business skills, allowing Gemini to intelligently orchestrate multi-step booking workflows. - Backend Microservice: Developed with Java / Spring Boot, implementing concurrent session management (
ConcurrentHashMap), unified REST transport, and robust business logic. - Cloud & Infrastructure:
- Google Cloud Run: Fully managed serverless container hosting for auto-scaling and ultra-low latency.
- Google Cloud SQL (PostgreSQL): High-availability relational database storing tenant catalogs, customer records, and appointment logs.
- Google Artifact Registry & Cloud Storage: Secure container image management and static asset hosting.
- External Integrations:
- WhatsApp Business Cloud API: Webhook-driven bi-directional messaging pipeline.
- Google Calendar API: Two-way programmatic event creation and calendar conflict validation.
- Hostinger: Domain and landing page deployment at whappify.com.mx.
Challenges we ran into
- State & Context Management over Asynchronous WhatsApp Messages: WhatsApp users often send disjointed, rapid-fire messages. We engineered an in-memory session caching layer that tracks context windows without incurring redundant LLM latency.
- Zero-Hallucination Booking Consistency: Preventing the model from inventing non-existent availability required strict system prompts combined with strict parameter validation schemas for Gemini Function Calling.
- Timezone & Concurrent Scheduling Conflicts: Synchronizing WhatsApp user local times with Google Calendar API and database timezones required rigorous timestamp normalization to ensure conflict-free bookings.
Accomplishments that we're proud of
- Real Paying Customers & Market Validation: During the hackathon period, we successfully acquired 2 paying business clients and sold 4 memberships ($350 MXN / ~$20.18 USD per month).
- Proven Financial Profitability (Positive P&L): $$\text{Total Revenue} = \$80.71 \text{ USD}$$ $$\text{Total Expenses} = \$34.62 \text{ USD} \quad (\text{including GCP Cloud SQL, Cloud Run, Vertex AI, Domain & Subscriptions})$$ $$\text{Net Profit} = \mathbf{+\$46.09 \text{ USD}} \quad (\mathbf{57.1\% \text{ Net Margin}})$$
- Unprecedented Token Efficiency with Gemini 2.5 Flash: Total Vertex AI token consumption across the entire 90-day period cost just $0.88 USD ($15.30 MXN), demonstrating that Gemini offers a marginal cost ratio of only: $$\frac{\text{Token Cost}}{\text{Total Revenue}} = \frac{\$0.88}{\$80.71} \approx \mathbf{1.09\%}$$
- End-to-End Autonomous Flow: Building a complete conversational loop from first greeting to confirmed Google Calendar event in under 2 seconds.
What we learned
- The Speed and Precision of Gemini 2.5 Flash: Gemini 2.5 Flash delivered the ideal balance of natural conversational empathy and near-instant JSON schema generation for function execution.
- Simplicity Wins for SMBs: Business owners don't want another dashboard to manage—they want tools that integrate seamlessly with the platforms they and their customers use every single day (WhatsApp & Google Calendar).
- Unit Economics of Agentic AI: By structuring deterministic tasks into Function Calls and letting the LLM act as the reasoning orchestrator, conversational agents can operate with exceptional unit economics.
What's next for Whappify
What's next for Whappify
- Dynamic Prompt-Based Agent Customization (Promotions & Tone): Empowering business owners to customize their AI receptionist's behavior, tone, and active marketing campaigns via intuitive natural language prompt configuration—such as injecting seasonal promotions (e.g., "Offer 20% off on teeth whitening this week"), upsell strategies, or custom FAQs without writing a single line of code.
- Integrated Inventory & Stock Control for Product Sales: Expanding beyond service appointments to enable conversational e-commerce and retail sales on WhatsApp. Businesses (salons, clinics, consultancies) will be able to sell physical products (aftercare products, cosmetics, supplies) with real-time stock tracking, automated inventory deduction, and out-of-stock alerts.
- In-Chat Payment Links: Direct integration with Stripe / Mercado Pago webhooks so clients can seamlessly pay deposits, prepay services, or purchase products directly inside WhatsApp before their appointment.
- Automated Smart Reminders & No-Show Reduction: Proactive WhatsApp follow-ups and confirmation pings 24 hours in advance to eliminate no-shows and optimize business occupancy.
- Multimodal Voice Note Booking: Leveraging Gemini's native audio capabilities to allow customers to book appointments or inquire about products simply by sending voice notes.
- Multi-Staff & Multi-Calendar Routing: Intelligent round-robin assignment across clinics and salons with multiple specialists and individual Google Calendars.
Built With
- angular.js
- antigravity
- docker
- function-calling
- gemini
- gemini-api
- google-calendar-api
- google-cloud
- google-cloud-sql
- java
- postgresql
- spring
- spring-boot
- typescript
- vertex-ai
- whatsapp-business-api
- whatsapp-cloud-api
Log in or sign up for Devpost to join the conversation.