Skip to content
sultanxdevPublic

About

AI employee for clinics that automates WhatsApp and Calls conversations, lead capture, appointment management and human handoff.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Dermoai — 24/7 AI Employee for Modern Clinics

Dermoai Platform Banner

Tech Stack

Next.js 15 React 19 TypeScript PostgreSQL pgvector Better Auth Meta WhatsApp API Razorpay


📌 Executive Summary

Dermoai solves this by acting as an autonomous, always-on digital receptionist and patient coordinator. Operating directly over WhatsApp—the primary messaging channel for outpatient clinics worldwide—Dermo greets patients instantly, answers treatment and pricing questions from verified clinic knowledge, checks live physician calendars, collects reservation deposits via integrated payment links, and intelligently escalates complex or clinical inquiries to human staff.

✨ Core Capabilities

1. 💬 Omnichannel WhatsApp Automation

  • Native integration with the Meta WhatsApp Cloud API.
  • Handles multimedia, quick reply buttons, list messages, and natural conversational text.
  • Zero delay: Responds in under 2.5 seconds with warm, brand-tailored conversational tone.

2. 🧠 Context-Aware Healthcare RAG (pgvector)

  • Embeds and semantically indexes verified clinic documentation: services, doctor credentials, contraindications, preparation tips, and fee schedules.
  • Uses semantic distance thresholding: if confidence is below safety boundaries, the system transparently defers to clinic staff rather than guessing.

3. 🗓️ Deterministic Appointment & Calendar Engine

  • Strict two-phase reservation pipeline (Check Availability $\rightarrow$ Soft Hold $\rightarrow$ Payment Commit).
  • Enforces doctor shift times, room constraints, buffer windows, and procedure durations.
  • Completely immune to LLM hallucination: slots are fetched directly from PostgreSQL calendar tables.

4. 💳 Frictionless In-Chat Payment Collection

  • Automated Razorpay integration creates secure payment links inside the WhatsApp conversation.
  • Collects consultation deposits (e.g., ₹500) to deter no-shows.
  • Instant reconciliation via webhooks: slots are confirmed upon webhook verification.

5. 🤝 Seamless Human-in-the-Loop Takeover

  • One-click toggle (AI_MODE $\leftrightarrow$ HUMAN_TAKEOVER).
  • Receptionists can take over the conversation anytime from the web dashboard; the AI immediately pauses automated replies.
  • Once the staff finishes, the conversation can be handed back to AI mode seamlessly.

6. 🔐 Enterprise Authentication & Multi-Tenant Foundations

  • Built with Better Auth using server-side, HTTP-only secure cookie sessions.
  • Email/Password credential authentication with robust password hashing and rate limiting.
  • Social OAuth providers (Google, GitHub) pre-configured.
  • Strict tenant isolation boundaries (clinic_id) across all database queries.

👤 Author & Contact

Sultan
Full-Stack Engineer & AI Systems Developer


About

AI employee for clinics that automates WhatsApp and Calls conversations, lead capture, appointment management and human handoff.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages