convez.ai
AgenteAutomaçãoAvançado
Sushant6095

Voxa — Recepcionista IA com Voz Clonada

Sushant6095/voxa-stipeXelevenlabs

Recepcionista IA multilíngue que atende em SUA voz clonada

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent IA que atende ligações em voz clonada do proprietário, em hindi/tâmil/télugu/inglês. Integra agendamento via Cal.com, confirmações por WhatsApp e faturamento por minuto via Stripe. Solução end-to-end para PMEs indianas que perdem clientes por falta de atendimento após o horário.

Instalação

$npx convez-ai Sushant6095/voxa-stipeXelevenlabs

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
2
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Clínicas e consultórios: atender pacientes fora do horário em língua local
  • Salões e beleza: agendamentos automáticos com confirmação via WhatsApp
  • Tutoria e educação: filtrar consultas e marcar aulas sem intermediários

Veredito

Solução madura e pronta para produção com arquitetura robusta (ElevenLabs + Twilio + Stripe + n8n + Claude). Reduz perda de clientes por falta de atendimento; monetização clara via Stripe Meter Events. Excelente para PMEs indianas com barreiras linguísticas.

README

A tradução para o português deste README ainda está na fila.

Voxa

The AI receptionist that picks up — in your voice, in your customer's language.

Built for #ElevenHacks · ElevenLabs × Stripe · 2026

Live deploy Call the AI License

Next.js TypeScript Tailwind v4 Supabase Stripe ElevenLabs Twilio Anthropic n8n

A small clinic in Bengaluru. A salon in Pune. A tutor in Hyderabad. Every day they lose customers because nobody picks up the phone after hours. Voxa picks up — in the owner's cloned voice, in the caller's language, every time.


🎬 See it. Hear it. Call it.

📞 Live phone demo+1 (912) 912-6711 — call from any phone. The AI answers in Hindi/Tamil/Telugu/English.
🌐 Production sitehttps://voxa-inky.vercel.app
📚 API docshttps://voxa-inky.vercel.app/docs · with interactive React Flow architecture diagrams
🎙 Agent IDagent_1501ks3dxeg6f489ksmqvd9hs8gz (Sharma Dental Clinic persona, Hindi primary)
🎬 Demo video87s master · 1920×1080 · burned-in captions · see docs/demo-video-README.md

🪄 What Voxa does

Six capabilities, end-to-end

🎙 Voice cloningA 60-second sample of the owner's voice → ElevenLabs IVC. Every subsequent call sounds like them.
🌐 Multilingual auto-switchDetects the caller's language on the first utterance. Locks to it for the rest of the call. Tamil-only and Telugu-only rules baked into the prompt.
📞 Native Twilio importThe agent is plugged into the phone line via the ElevenLabs Phone Numbers API. No custom TwiML. Less than 60 seconds from Stripe Checkout to a ringing number.
📅 Cal.com bookingsThe agent calls real availability slots and creates real bookings via 6 webhook tools wired through n8n.
💬 WhatsApp confirmationsTwilio Business sandbox sends booking confirmations + hot-lead alerts.
💳 Stripe Meter billingThe new Stripe Meter Events API (2025-03-31 release) handles per-minute usage billing. Three tiers, flat licensed price + metered overage.

🏗 Architecture

High-level data flow

flowchart LR
    Caller([📞 Caller]) -->|"PSTN"| Twilio[Twilio Voice]
    Twilio -->|"Native import"| EL[ElevenLabs Conv AI]
    EL -->|"6 webhook tools"| n8n{{n8n W2 — Live Tools}}

    EL -.->|"post_call_transcription<br/>~5–15 s after hangup"| W3{{n8n W3 — Post-Call}}

    n8n --> Cal[Cal.com<br/>slots + bookings]
    n8n --> WA[WhatsApp Business<br/>confirmations]
    n8n --> KB[(Supabase<br/>knowledge_base)]
    n8n --> Twilio2[Twilio call-forward<br/>+ owner alert]

    W3 --> Stripe[Stripe Meter Events]
    W3 --> Claude[Anthropic<br/>opus-4-7 extraction]
    W3 --> DB[(Supabase<br/>calls / leads)]
    DB -->|"Realtime channel"| Dashboard[Next.js Dashboard]

    Stripe -.->|"checkout.session.completed"| W1{{n8n W1 — Onboarding}}
    W1 --> Twilio
    W1 --> EL

    classDef brand fill:#6366F1,stroke:#4F46E5,color:#fff
    classDef stripe fill:#635BFF,stroke:#4F46E5,color:#fff
    classDef voice fill:#EC4899,stroke:#DB2777,color:#fff
    classDef store fill:#3FCF8E,stroke:#22994E,color:#0f172a
    classDef ext fill:#F59E0B,stroke:#B45309,color:#0f172a
    class EL voice
    class Stripe stripe
    class DB,KB store
    class n8n,W1,W3 brand
    class Cal,WA,Twilio,Twilio2,Claude ext

The 5 n8n workflows

flowchart TD
    subgraph W1["W1 — Onboarding"]
        direction LR
        A1[checkout.session<br/>.completed] --> A2[Buy Twilio<br/>number]
        A2 --> A3[Clone voice]
        A3 --> A4[Create EL agent]
        A4 --> A5[Import number<br/>→ assign agent]
        A5 --> A6[WhatsApp<br/>activation msg]
    end

    subgraph W2["W2 — Live Tool Calls (&lt;2s p99)"]
        direction LR
        B1[Webhook<br/>/tool/:name] --> B2{Switch}
        B2 --> B3a[check_availability]
        B2 --> B3b[book_appointment]
        B2 --> B3c[get_business_info]
        B2 --> B3d[escalate_to_owner]
        B2 --> B3e[send_callback_link]
        B2 --> B3f[log_lead]
    end

    subgraph W3["W3 — Post-Call"]
        direction LR
        C1[EL post-call<br/>webhook] --> C2[Compute<br/>minutes]
        C2 --> C3[Stripe Meter<br/>event]
        C2 --> C4[Claude<br/>extraction]
        C4 --> C5[Supabase<br/>upsert]
        C5 --> C6{score &gt;= 7?}
        C6 -->|yes| C7[WhatsApp<br/>hot-lead alert]
    end

    classDef brand fill:#6366F1,stroke:#4F46E5,color:#fff
    class W1,W2,W3 brand

W4 — Stripe events (subscription deletes + invoice failures) and W5 — Daily Digest (6 PM IST cron, WhatsApp summary per business) round out the orchestration.


📞 The 6 webhook tools

The ElevenLabs agent calls these during a live call. Each branch must complete in <2s (EL's tool timeout is ~5s).

ToolArgsBackend action
check_availabilitydate, time_windowCal.com getSlots → returns 2 specific times
book_appointmentcustomer_name, customer_phone, datetime_iso, serviceCal.com createBooking + Twilio WhatsApp confirm + Supabase leads insert
get_business_infoqueryRAG over knowledge_base (URL-ingested content)
escalate_to_ownerreason, urgency: 'low' | 'high'Twilio call-forward TwiML update + WhatsApp owner alert
send_callback_linkcustomer_phone, link_typeTwilio WhatsApp deep-link
log_leadcustomer_name, customer_phone, intent, notesSupabase leads upsert

🖥 Product tour

Dashboard with live React Flow orchestration

The centerpiece of the demo video: a React Flow graph of every external service. Edges animate in real-time as Supabase Realtime pushes new calls, leads, and meter_events rows.

Stripe-style API docs

Three-column docs shell at https://voxa-inky.vercel.app/docs — sidebar nav with method badges, language-tabbed code samples (curl / Node / Python), interactive React Flow architecture diagrams. Built with the design philosophy of docs.stripe.com.

Live tool-call workflow visualisation

Pricing — 3 tiers × 2 prices each

TierFlat / monthIncluded minOverage / min
Starter₹999100₹15
Growth ⭐₹2,999500₹12
Scale₹7,9992,000₹10

All Stripe-side: 1 Meter (call_minutes, sum aggregation) + 3 Products + 6 Prices, created idempotently via pnpm setup:stripe.


🛠 Tech stack

LayerTools
FrontendNext.js 15 (App Router, RSC, server actions) · React 19 · TypeScript strict · Tailwind v4 · shadcn/ui (slate) · Magic UI (18 components) · Motion · React Flow · Tremor · cmdk · Vaul · Wavesurfer · react-parallax-tilt
DataSupabase Postgres (7 tables + RLS) · Supabase Realtime · Service-role + cookie-based clients
VoiceElevenLabs Conversational AI · Instant Voice Cloning · Native Twilio Phone Numbers API
BillingStripe Meter Events API (2025-03-31.basil) · Stripe Checkout · Stripe Customer Portal · Idempotency table
TelephonyTwilio Voice (Indian / US numbers with auto IN→US fallback) · Twilio WhatsApp Business sandbox
AIAnthropic claude-opus-4-7 for post-call lead extraction (intent, sentiment, lead score)
Orchestrationn8n self-hostable + cloud (5 production workflows) · Cal.com for booking slots
InfraVercel (production) · Supabase Cloud · Anthropic API · ElevenLabs API
BrandCal Sans (headlines) · Geist Sans (body) · Geist Mono (code) · indigo #6366F1 → pink #EC4899 gradient

🚀 Quick start

# Clone
git clone https://github.com/Sushant6095/voxa-stipeXelevenlabs.git voxa
cd voxa
pnpm install

# Add env vars (see docs/env-setup.md for the 25-min walkthrough)
cp .env.example .env.local
# Edit .env.local — paste keys from Supabase, Stripe, Twilio, EL, Anthropic, n8n

# Apply schema + provision Stripe + create EL agent + buy a phone number
pnpm setup:stripe          # Meter + 3 Products + 6 Prices
pnpm db:push               # 2 SQL migrations to Supabase
pnpm db:types              # regen lib/supabase/types.ts
pnpm setup:el-agent --business-name "Your Business" --language hi --voice-id <id> --n8n-url <url> --write-env
pnpm test:telephony <agent-id> --country=US   # buys + assigns a number

# Verify
pnpm smoke                 # 6 read-only checks across Supabase, Stripe, EL, Twilio, n8n, Anthropic

# Dev
pnpm dev                   # turbopack — http://localhost:4321

# Production
pnpm build && vercel --prod

Full walkthrough: docs/env-setup.md.


📦 Project structure

voxa/
├── app/
│   ├── (marketing)/pricing/       # 3-tier pricing page (parallax + BorderBeam)
│   ├── (app)/                     # App shell — dashboard, calls, leads, knowledge, voice, billing, settings
│   ├── docs/                      # Stripe-style API docs with React Flow diagrams
│   ├── onboarding/                # 6-step post-checkout wizard
│   ├── api/
│   │   ├── stripe/{checkout,portal,webhook}/
│   │   ├── elevenlabs/webhook/
│   │   ├── voice/clone/
│   │   ├── agent/create/
│   │   ├── knowledge/ingest/
│   │   └── onboarding/{business,scrape,status}/
│   ├── layout.tsx                 # Fonts + ThemeProvider + Toaster
│   ├── page.tsx                   # Landing — hero + bento + pricing + marquee + FAQ + footer
│   └── icon.svg                   # Crab favicon
├── components/
│   ├── brand/voxa-logo.tsx        # The gradient crab mascot
│   ├── landing/                   # Hero, Bento, AnimatedBeam, Marquee, Footer, mega-menu Navbar
│   ├── docs/                      # Stripe-style docs primitives + React Flow wrapper
│   ├── dashboard/                 # KPI cards, Live Orchestration, Leads kanban, Recent Calls drawer
│   ├── onboarding/                # 6 step components — progress dots, voice recorder, etc.
│   ├── app/                       # Sidebar, TopBar
│   ├── cmdk/                      # ⌘K command palette
│   └── ui/                        # shadcn primitives + 18 Magic UI components
├── lib/
│   ├── stripe.ts                  # Meter Events helpers, apiVersion 2025-03-31.basil
│   ├── elevenlabs.ts              # Agent CRUD, voice clone, phone number import
│   ├── telephony.ts               # IN→US fallback + orphan number cleanup
│   ├── twilio.ts                  # Number purchase + WhatsApp/SMS
│   ├── n8n.ts                     # Workflow trigger wrapper
│   ├── agent-template.ts          # The 800-word multilingual system prompt
│   ├── agent-tools.ts             # 6 webhook tool definitions
│   ├── dashboard-data.ts          # All Supabase queries
│   ├── realtime.ts                # Realtime hooks
│   ├── optimistic-leads.ts        # useOptimistic kanban
│   └── supabase/{server,client,middleware,types}.ts
├── supabase/migrations/
│   ├── 0001_initial_schema.sql    # 7 tables + RLS + Realtime publication + helper fns
│   └── 0002_stripe_webhook_events.sql
├── n8n/
│   ├── 01-onboarding.json         # W1
│   ├── 02-live-tools.json         # W2 (6 branches)
│   ├── 03-post-call.json          # W3
│   ├── 04-stripe-webhooks.json    # W4
│   ├── 05-daily-digest.json       # W5
│   └── README.md
├── scripts/
│   ├── setup-stripe.ts            # Idempotent Meter + Products + Prices
│   ├── setup-elevenlabs-template.ts
│   ├── test-telephony.ts
│   ├── smoke-test.ts              # 6-check live API verification
│   ├── record-demo-video.cjs      # Playwright 5-shot tour
│   └── generate-narration.mjs     # ElevenLabs TTS for the 3 narration clips
├── docs/
│   ├── architecture.md
│   ├── env-setup.md               # 25-min key-collection walkthrough
│   ├── runbook.md
│   ├── ui-spec.md
│   ├── demo-video-README.md
│   └── images/                    # Screenshots used in this README
└── middleware.ts

🧪 What ships

InventoryCount
Production routes (200)17 (8 marketing/docs · 7 app · 2 onboarding flows)
API routes11
Supabase tables8 (businesses, agents, subscriptions, knowledge_base, calls, leads, meter_events, stripe_webhook_events)
RLS policies15
Stripe resources provisioned1 Meter · 3 Products · 6 Prices
n8n workflow JSONs5 (80 nodes total, all validate)
ElevenLabs server tools6
TypeScript errors0 (strict mode, project-wide)
Source files150+

💳 Try the live demo

Three ways, in increasing order of "wow":

  1. Browse: open https://voxa-inky.vercel.app on any device. Tap "📞 Call AI demo" in the navbar.
  2. Call: dial +1 (912) 912-6711 from any phone, anywhere in the world. Try opening with Hindi, Tamil, or Telugu — the agent locks to your language.
  3. Inspect: open https://voxa-inky.vercel.app/docs/architecture for the interactive React Flow walk-through of every workflow.

🎬 Demo video

Recorded automatically via scripts/record-demo-video.cjs — a 5-shot Playwright tour of the live site at 1920×1080 with burned-in captions.

AspectFileUse for
16:9 mastervoxa-demo-master.mp4Hackathon submission, YouTube, X main, LinkedIn
9:16 verticalvoxa-demo-vertical.mp4TikTok, Reels, Shorts
1:1 squarevoxa-demo-square.mp4Instagram feed

See docs/demo-video-README.md for the FFmpeg mux command to add ElevenLabs voice narration.


🏆 Built for #ElevenHacks

50 hours. Two solo developers' worth of scope. Shipped.

This repository is the entire product — backend, frontend, infrastructure, n8n workflows, deployment scripts, documentation site, and demo video pipeline. Every line was written during the ElevenLabs × Stripe hackathon weekend.

Why this submission
Real product, real usersA small-business owner could subscribe via Stripe Checkout, get a working phone number, and have customers calling within an hour. Not a toy.
Deepest possible Stripe + EL integrationUses Stripe's brand-new (2025-03-31) Meter Events API for usage billing — and ElevenLabs' native Twilio import which is the recommended path, not a custom TwiML bridge.
Voice cloning that mattersThe agent sounds like the owner, not a generic TTS. For a regional SMB customer who calls a familiar voice, this is the whole product.
Multilingual is non-trivialThe agent detects language on the first utterance and locks to it — Tamil-only callers don't get Hinglish, Telugu-only callers don't get Hindi. The system prompt is 800 words of regional language rules.
Live, callable+1 (912) 912-6711. Judges can dial it from anywhere.

📜 License

MIT — see LICENSE.


Built by @Sushant6095 with help from Claude · 50 hours · ElevenHacks 2026

Live demo · Call the AI · API docs · Architecture

Ver o original no GitHub

Bom para

Relacionados