🟢 ZapScript
Transcrição automática de áudios do WhatsApp com IA — 99.8% de precisão em português.
📁 Estrutura do Projeto
zapscript/
├── apps/
│ ├── api/ → Servidor Fastify (autenticação, números, billing, webhooks)
│ ├── worker/ → Pipeline de transcrição (Whisper + Claude)
│ ├── web/ → Frontend Next.js 14
│ └── monitor/ → Health checker + alertas
├── packages/
│ └── database/ → Schema Prisma + migrations
└── infra/ → Scripts de deploy e configuração
✅ Pré-requisitos
Instale antes de começar:
# Node.js v20 LTS
https://nodejs.org
# pnpm
npm install -g pnpm
# ffmpeg (converte OGG/M4A/WAV → MP3)
# Mac: brew install ffmpeg
# Ubuntu: sudo apt install ffmpeg
# Windows: https://ffmpeg.org/download.html
🔑 Contas necessárias
🚀 Setup Local
1. Clonar e instalar
git clone https://github.com/foxtecnologiaonline/zapscript.git
cd zapscript
pnpm install
2. Configurar variáveis de ambiente
cp .env.example .env
# Abrir .env no editor e preencher TODAS as variáveis
Gerar secrets:
node infra/gen-secrets.js
3. Configurar banco de dados
cd packages/database
npx prisma migrate dev --name init
npx prisma generate
npx ts-node prisma/seed.ts # Seed: planos Free, Pro, Executive
cd ../..
4. Rodar em desenvolvimento
# API + Worker + Frontend simultâneo
pnpm dev
Acessar:
5. Testar fluxo completo
1. localhost:3000 → Cadastrar conta
2. Dashboard → Números → Conectar via QR (Evolution API)
3. Enviar áudio para o número no WhatsApp
4. Transcrição aparece no dashboard em ~10s
5. Testar pagamento: dashboard → Plano → Assinar Pro
🌐 Deploy em Produção
Vultr (API + Worker, Docker self-hosted)
O deploy é sempre manual — nada acontece sozinho quando o código chega em
master:
- Aba Actions → "Ops — Vultr / Migração" → Run workflow →
action: deploy
(.github/workflows/ops.yml). O workflow faz SSH no servidor, clona o
master mais recente e builda as imagens da API e do Worker direto no
próprio servidor (não usa imagens do ghcr.io), troca :latest sem
downtime (API primeiro, espera healthcheck, depois Worker) e mantém a
imagem anterior como :previous para rollback.
- Para reverter: mesma aba,
action: rollback.
- Guia de referência (histórico da migração Render→Vultr, ainda útil para
entender o servidor):
MIGRACAO_VULTR.md.
# Rodar migrations em produção (a partir de qualquer máquina com acesso ao DB):
DATABASE_URL=... npx prisma migrate deploy --schema=packages/database/prisma/schema.prisma
Vercel (Frontend)
Integração Git nativa — todo push em master builda e deploya automaticamente,
sem passo manual.
# Variáveis no Vercel dashboard:
# NEXT_PUBLIC_API_URL=https://api.zapscript.me
# NEXT_PUBLIC_SUPABASE_URL=...
# NEXT_PUBLIC_SUPABASE_ANON_KEY=...
🏗️ Stack Completa
| Camada | Tecnologia |
|---|
| Frontend | Next.js 14, Tailwind CSS |
| API | Fastify, TypeScript |
| WebSocket | Socket.io + Redis adapter |
| Worker/Filas | BullMQ + Redis (container local no Vultr) |
| WhatsApp | Evolution API (instâncias dedicadas) |
| Transcrição | Groq whisper-large-v3-turbo (primary) + OpenAI whisper-1 (fallback) |
| Resumos | Anthropic Claude Haiku (primary) + GPT-4o-mini (fallback) |
| Banco | PostgreSQL (Supabase) + Prisma |
| Pagamentos | Asaas (PIX + cartão) |
| E-mail | Resend API |
| Criptografia | AES-256-GCM (dados sensíveis) |
| Error tracking | Sentry |
| Deploy API | Vultr (Docker, self-hosted) |
| Deploy Web | Vercel |
💰 Planos
| Plano | Preço | Áudios/mês | Números | Inclui |
|---|
| Core | Grátis | 200 | 1 | Transcrição + resumo com IA |
| Profissional | R$49/mês (R$295/ano) | 500 | 1 | + Atende (atendimento 24/7 por IA) |
| Empresas | R$99/mês (R$595/ano) | 500 | 5 | + CRM, Tarefas |
Pro (R$37) e Executive (R$67) são planos legado — fora de linha para novos
assinantes, mantidos só para quem já assinava antes da revisão de tiers.
Fonte da verdade: apps/api/src/routes/billing.ts (PLAN_PRICES) e
packages/database/prisma/seed.ts.
🔒 Segurança & LGPD
- Áudios processados em memória e descartados após transcrição
- Textos e telefones criptografados com AES-256-GCM no banco
- Row Level Security (RLS) ativado no Supabase
- JWT com expiração de 30 dias
- HMAC-SHA256 em todos os webhooks (Asaas + Evolution + webhooks personalizados)
- Rate limiting global + proteção contra abusos
- Soft-delete + pseudonymização (direitos LGPD)
📞 Suporte
