CallHarbor 📞

CallHarbor is a high-performance, AI-driven voice platform designed to automate lead capture and appointment booking for real estate and service-based businesses.

Powered by Vapi, DeepSeek, Next.js, and Supabase, CallHarbor acts as a 24/7 virtual assistant that answers missed calls, handles FAQs, and books showings directly into your calendar.

🚀 Key Features

• AI Voice Assistant: Professional, low-latency voice interactions powered by GPT-4o-mini/DeepSeek.
• Smart Booking: Automatically checks availability and books appointments via Google Calendar.
• Lead Dashboard: Real-time tracking of all inbound leads and call transcripts.
• Multi-Channel Notifications: Instant lead alerts via Email (Resend) and SMS (Twilio).
• SEO Optimized: Built with Next.js for maximum performance and visibility.

🛠️ Tech Stack

• Framework: Next.js 15 (App Router)
• Voice Engine: Vapi.ai
• LLM: DeepSeek / OpenAI
• Database: Supabase (PostgreSQL + Auth)
• Styling: Vanilla CSS / Tailwind (Modern Glassmorphism)
• Calendar: Google Calendar API

🏃 Getting Started

1. Prerequisites

• Node.js 18+
• Supabase Account
• Vapi.ai API Key
• Resend API Key

2. Environment Setup

Create a .env.local file with the following:

NEXT_PUBLIC_SUPABASE_URL=your_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_key
SUPABASE_SERVICE_ROLE_KEY=your_service_key

VAPI_API_KEY=your_vapi_key
VAPI_SECRET=your_vapi_webhook_secret

RESEND_API_KEY=your_resend_key

3. Install & Run

npm install
npm run dev

🧪 Testing

We have included a comprehensive test suite in the /scripts directory:

• npx tsx scripts/vapi-test-suite.ts: Run automated end-to-end integration tests.
• npx tsx scripts/test-assistant.ts: Test the AI's logic without placing a call.

📄 License

MIT