Odonto Premium: site, assistente virtual e painel
Plataforma digital da clínica: landing page, assistente virtual Dra. Sofia no site e no WhatsApp, agendamento integrado ao Google Calendar e painel administrativo para a equipe acompanhar conversas, leads, agenda e indicadores.
Visão geral
| Módulo | O que faz |
|---|---|
| Landing page | Site institucional (serviços, sobre, diferenciais, depoimentos) com formulário de contato e agendamento protegido contra spam e robôs. |
| Dra. Sofia — site | Chat com IA que cadastra o visitante, tira dúvidas, agenda consultas na agenda real e aplica a enquete de satisfação. |
| Dra. Sofia — WhatsApp | O mesmo motor de conversa no número +55 14 99875-7986, com transbordo para atendente humano. |
| Painel administrativo | Agendamentos (lista e calendário), histórico do bot, atendimento WhatsApp ao vivo, insights, leads, campanhas e métricas da equipe. |
| Operação | Docker numa VPS atrás do Traefik (HTTPS automático), watchdog do WhatsApp, keep-alive do banco e deploy em um comando. |
Stack
- Next.js 16 (App Router, Server Actions,
proxy.ts,instrumentation.ts), React 19, TypeScript - Tailwind CSS 4, Radix/Base UI, Framer Motion, Recharts, TanStack Query
- PostgreSQL (Supabase) via
postgres.js, validação com Zod - Groq (modelo
openai/gpt-oss-120b) para a IA, Google Calendar API, Gmail SMTP - Evolution API v2 (WhatsApp), Docker, Traefik e Let's Encrypt
Arquitetura
O app Next.js concentra toda a regra de negócio. A Evolution API é só o gateway do WhatsApp, o banco fica no Supabase, e IA, agenda e e-mail são serviços externos chamados exclusivamente pelo servidor.
flowchart LR
subgraph Usuarios[Usuários]
V[Visitante do site]
P[Paciente no WhatsApp]
E[Equipe da clínica]
end
subgraph VPS[VPS — Docker]
T[Traefik<br/>HTTPS]
APP[clinica-app<br/>Next.js 16]
EVO[evolution-api<br/>+ Postgres + Redis]
WD[watchdog<br/>a cada 5 min]
end
subgraph Externos[Serviços externos]
DB[(Supabase<br/>PostgreSQL)]
G[Groq — IA]
GC[Google Calendar]
GM[Gmail SMTP]
WA[WhatsApp]
end
V --> T --> APP
E -->|/admin| T
P <--> WA <--> EVO
EVO -->|webhook| T
APP -->|envio| EVO
APP --> DB
APP --> G
APP --> GC
APP --> GM
WD -.->|testa e reinicia| EVO
Camadas do código
| Camada | Pasta | Responsabilidade |
|---|---|---|
| Páginas e rotas | src/app | Landing page, admin, simulador e rotas HTTP (api/). |
| Server Actions | src/actions | Formulário do site: token anti-robô, horários ocupados, agendamento e e-mails. |
| Componentes | src/components | Site público, widget Chatbot.jsx e painéis do admin. |
| Regras de negócio | src/lib | Motor do bot, banco, autenticação, agenda, WhatsApp e segurança de entrada. |
| Infraestrutura | deploy/, Dockerfile | Imagem, Traefik, Evolution, watchdog e SSH. |
Módulos de src/lib
| Módulo | Função |
|---|---|
bot-engine.ts | Motor único de conversa (site e WhatsApp): estados, IA, agendamento, enquete, inatividade, despedida e privacidade. |
bot-shared.ts | Textos e regras compartilhados: prompt da IA, mensagens fixas, detecção de despedida e remoção de dados sigilosos. |
whatsapp-bot.ts | Adaptador do WhatsApp: entrega as ações do motor e roda a varredura de inatividade. |
whatsapp-client.ts | Envio de mensagens (Evolution, depois Meta, depois Twilio), com prazo e novas tentativas. |
db.ts | Acesso ao Postgres, sempre com consultas parametrizadas. |
auth.ts | Hash de senha (scrypt), sessão JWT em cookie e revogação. |
scheduling.ts | Grade de horários, dias úteis e feriados, busca e reserva no Google Calendar. |
conversation-summary.ts | Resumo de conversas por IA para o admin. |
input-security.ts | Sanitização de texto, nomes, ids de sessão e anexos. |
contact-form-security.ts | Token assinado anti-robô do formulário. |
validations.ts | Schemas Zod (formulário e política de senha). |
rate-limit.ts | Limitador em memória por chave (IP, e-mail). |
internal-auth.ts | Autorização das rotas /api/internal/*. |
Conversa no widget do site
sequenceDiagram
participant W as Widget (navegador)
participant API as POST /api/chat
participant M as bot-engine
participant DB as Postgres
participant IA as Groq
W->>API: sessionId, text
API->>M: processIncomingMessage (canal bot)
M->>M: sanitiza e remove dados sigilosos
M->>DB: grava mensagem e estado
M->>IA: últimas 20 mensagens + prompt
IA-->>M: resposta
M-->>API: ações (texto ou opções)
API-->>W: actions, step, patientName
O widget não guarda regra de negócio: só exibe as ações devolvidas e espelha o estado para a interface (placeholder, máscara de telefone).
Conversa no WhatsApp
sequenceDiagram
participant P as Paciente
participant EVO as Evolution API
participant WH as Webhook do app
participant M as bot-engine
P->>EVO: mensagem
EVO->>WH: messages.upsert (com token)
WH->>WH: valida token, deduplica, extrai telefone/texto/mídia
WH->>M: processIncomingMessage (canal whatsapp)
M-->>WH: ações
WH->>EVO: envio (até 3 tentativas)
EVO->>P: resposta
Formulário do site
contact-form.tsx pede um token assinado (getContactFormToken) e envia pela Server Action scheduleAppointment: validação Zod, token, limites por IP e por e-mail, criação do lead, reserva no Google Calendar (quando é agendamento) e dois e-mails (notificação interna e confirmação ao paciente).
Tarefas periódicas
| Tarefa | Intervalo | Rota interna |
|---|---|---|
| Varredura de inatividade do WhatsApp | 1 min | POST /api/internal/inactivity-sweep |
| Keep-alive do Supabase | ao subir e a cada 6 h | POST /api/internal/keepalive |
Decisões técnicas
- Um motor, dois canais.
bot-engine.tsdecide o que dizer e devolveBotAction[]; cada canal decide como entregar. Antes, site e WhatsApp tinham implementações separadas que divergiam. - Google Calendar como fonte da verdade. Não há tabela de consultas; o banco guarda só as anotações do dentista.
- Estado do bot persistido em
conversations.bot_state, porque cada mensagem chega como requisição isolada. - Transições atômicas no banco para a inatividade, permitindo mais de uma instância sem mensagens duplicadas.
- Regras antes da IA. Despedida, dados sigilosos, agendamento e transbordo são detectados por regras; a IA cuida da conversa livre.
- Fuso fixo
America/Sao_Pauloem todo cálculo de dia e horário. - Servidor persistente (Docker), o que permite limitadores em memória e tarefas periódicas.
Assistente virtual Dra. Sofia
Atende no widget do site (canal bot) e no WhatsApp (canal whatsapp) com o mesmo motor, src/lib/bot-engine.ts. Textos fixos, prompt e regras compartilhadas ficam em src/lib/bot-shared.ts.
Caminho de uma mensagem
flowchart TD
A[Mensagem recebida] --> B[Sanitização<br/>controle, bidi, 2000 caracteres]
B --> C{Foto ou documento<br/>no WhatsApp?}
C -- sim, sem atendente --> C1[Orientação de privacidade]
C -- não --> D[Remoção de dados sigilosos<br/>CPF, cartão, senha...]
D --> E[Máquina de estados]
E --> F[Ações: texto ou opções]
D -. algo removido .-> G[Aviso de privacidade]
| Entrada | Descrição |
|---|---|
conversationId | Site: UUID da sessão do widget. WhatsApp: whatsapp:<telefone>. |
channel | bot ou whatsapp. |
text | Texto da mensagem (pode ser vazio). |
channelPhone | WhatsApp: telefone já conhecido pelo canal. |
knownContact | Site: nome e telefone de uma sessão anterior, para não pedir de novo. |
media | WhatsApp: image ou document quando chega um arquivo. |
A saída é uma lista de ações: texto ou opções. No site, as opções viram botões; no WhatsApp, uma lista numerada que o paciente responde com o número.
Máquina de estados
stateDiagram-v2
[*] --> name: primeira mensagem
name --> phone: nome (site)
name --> chat: nome (WhatsApp)
phone --> chat: telefone válido
chat --> scheduling_time: quer agendar
scheduling_time --> scheduling_choice: horários encontrados
scheduling_choice --> awaiting_more_help: consulta reservada
awaiting_more_help --> chat: Sim
awaiting_more_help --> awaiting_rating: Não
chat --> awaiting_rating: despedida
awaiting_rating --> closed: nota
chat --> handoff: pede atendente
handoff --> closed: finalizar
chat --> awaiting_inactivity_reply: 5 min parado
awaiting_inactivity_reply --> chat: Sim
awaiting_inactivity_reply --> awaiting_rating: Não
awaiting_inactivity_reply --> closed: mais 5 min
closed --> chat: nova mensagem
| Estado | Significado |
|---|---|
name / phone | Cadastro. O WhatsApp pula o telefone, que já é conhecido. |
chat | Conversa livre com a IA. |
scheduling_time | Aguardando o horário preferido ("10h", "de manhã"). |
scheduling_choice | Horários oferecidos; aguardando a escolha. |
awaiting_more_help | Depois de reservar: "Posso ajudar em algo mais?". |
awaiting_rating | Enquete enviada (😊 🙂 😐 🙁 😞 ou 1 a 5). |
awaiting_inactivity_reply | Perguntou "ainda está aí?"; guarda o estado anterior para retomar. |
handoff | Atendente humano assumiu: o bot só grava e não responde. |
closed | Atendimento encerrado; a próxima mensagem abre outro. |
Fluxo abandonado: se a conversa ficou mais de 1 hora parada no meio de um agendamento, enquete ou pergunta pendente, a próxima mensagem abre um atendimento novo.
Conversa com IA
- Groq, modelo
openai/gpt-oss-120b, temperatura 0,6, até 1024 tokens. - Mensagens de sistema: personalidade e 9 diretrizes, contexto do paciente e proteção contra prompt injection.
- Envia as últimas 20 mensagens. Se a IA falhar, responde com mensagem fixa de instabilidade.
Agendamento
- Disparado por intenção de agendar na mensagem do paciente ou na resposta da IA.
- O paciente informa o período; o motor interpreta "10h", "de manhã" ou "de tarde".
- Busca até 8 horários nos próximos 7 dias, só em dias úteis (sem fins de semana nem feriados nacionais, fixos e móveis).
- Grade de 09:00 a 11:00 e de 13:00 a 17:00, consultas de 45 minutos. A reserva confere conflito na hora de gravar.
Despedida
É despedida quando há palavra de encerramento sem pergunta e sem pedido de agendamento ("obrigado! e quanto custa?" não encerra). Vale em qualquer etapa, depois de tentar a resposta da própria etapa ("obrigado, pode ser às 10h" agenda). Resposta fixa com o nome do paciente e a enquete; no cadastro ou com a enquete recém-enviada, encerra sem enquete.
Inatividade
| Momento | Ação |
|---|---|
| 5 min sem mensagens | "Você ainda está por aí? 😊 Posso ajudar em mais alguma coisa?" (Sim ou Não) |
| Sim | Retoma de onde parou (pergunta pendente do cadastro ou horários oferecidos). |
| Não | Agradecimento e enquete. |
| Mais 5 min sem resposta | Encerra com mensagem. |
No WhatsApp, o servidor verifica a cada minuto as conversas paradas entre 5 minutos e 1 hora. No site, quem dispara é o timer do widget.
Transbordo para atendente
No WhatsApp, o paciente pode pedir um atendente ("falar com alguém"). A equipe responde pela aba Atendimento WhatsApp; se a entrega falhar, o painel mostra o erro e não registra a mensagem. "Finalizar atendimento" envia o agradecimento e encerra.
Privacidade (LGPD)
- Orientação já na primeira mensagem: não enviar documentos, CPF, cartões, senhas ou histórico de saúde.
- Diretriz da IA: nunca pedir esses dados e não repetir o que o paciente compartilhar.
- Remoção automática de CPF, RG, CNH, cartão do SUS, número de cartão (validado pelo algoritmo de Luhn), CVV e senha, antes de gravar ou enviar à IA, com aviso ao paciente. Telefones, datas e horários não são afetados.
- Arquivos: foto ou documento no WhatsApp recebe orientação; o widget mostra aviso ao anexar.
Onde alterar
| Para mudar | Arquivo e símbolo |
|---|---|
| Personalidade e regras da IA | bot-shared.ts → SYSTEM_PROMPT |
| Saudações e mensagens fixas | bot-shared.ts → ASK_NAME_MESSAGE, SURVEY_MESSAGE... |
| Palavras de despedida | bot-shared.ts → CLOSING_PATTERNS |
| Dados sigilosos detectados | bot-shared.ts → SENSITIVE_RULES |
| Tempo de inatividade | bot-engine.ts → INACTIVITY_TIMEOUT_MS |
| Horários e duração | scheduling.ts → AVAILABLE_HOURS, APPOINTMENT_DURATION_MINUTES |
| Modelo de IA | bot-engine.ts e conversation-summary.ts → MODEL |
O simulador em /whatsapp-demo roda o mesmo motor sem enviar nada de verdade; as conversas aparecem no admin com o prefixo [Demo].
API
Todas as rotas ficam em src/app/api. Respostas em JSON; erros no formato { "error": "mensagem" }.
Site público
| Método | Rota | Acesso | Descrição |
|---|---|---|---|
| POST | /api/chat | Público | Mensagem do widget (20/min por IP). Com event: "inactivity", aplica a regra de inatividade. |
| POST | /api/chat/attachment | Público | Anexo do widget: JPEG, PNG, WebP ou PDF até 4 MB, tipo detectado pelos bytes, PDFs com conteúdo ativo recusados (5/min por IP). |
Server Actions do formulário
| Action | Limite | Descrição |
|---|---|---|
getContactFormToken() | 30 a cada 15 min por IP | Token anti-robô assinado: validade de 12 h, uso único, mínimo de 3 s. |
getBookedSlots(date) | 30/min por IP | Horários ocupados num dia. |
scheduleAppointment(data) | 5 a cada 15 min por IP; 3 por e-mail em 24 h | Valida, cria o lead, agenda e envia e-mails (teto global de 40 por hora). |
| Método | Rota | Descrição |
|---|---|---|
| GETPOST | /api/whatsapp/evolution-webhook | Canal ativo. Recebe mensagens da Evolution; exige token secreto. |
| GETPOST | /api/whatsapp/meta-webhook | Canal alternativo Meta Cloud API (verify token e assinatura). |
| GETPOST | /api/whatsapp/webhook | Canal alternativo Twilio (assinatura). |
| POST | /api/whatsapp/simulate | Simulador; aceita só conversas novas ou de demonstração. |
Painel administrativo
| Método | Rota | Acesso | Descrição |
|---|---|---|---|
| POST | /api/admin/login | Público | Login. Origem do próprio site; 5 tentativas a cada 5 min por IP; conta bloqueada após 10 falhas em 15 min. |
| POST | /api/admin/logout | Público | Revoga a sessão no servidor. |
| PATCH | /api/admin/profile | Sessão | Nome, foto, e-mail e senha (atendente não troca e-mail e senha). |
| GET | /api/admin/appointments | Sessão | Próximas consultas (até 90 dias). |
| GET | /api/admin/appointments/calendar | Sessão | Consultas de um mês (month=AAAA-MM). |
| GETPUT | /api/admin/appointments/archived | Admin | Consultas realizadas e anotações do dentista. |
| GET | /api/admin/conversations | Sessão | Lista de conversas (site e WhatsApp). |
| GET | /api/admin/conversations/[id] | Sessão | Mensagens de uma conversa (e anexos em /attachments/[id]). |
| POST | /api/admin/conversations/[id]/summary | Sessão | Resumo da conversa por IA. |
| GET | /api/admin/conversations/stats | Admin | Indicadores dos Insights. |
| POST | /api/admin/whatsapp/[id]/handoff | Sessão | Assumir ou devolver ao bot. |
| POST | /api/admin/whatsapp/[id]/send | Sessão | Resposta do atendente; 502 se o WhatsApp não aceitar. |
| POST | /api/admin/whatsapp/[id]/finish | Sessão | Encerra o atendimento. |
| GETPOST | /api/admin/leads | Admin | Leads de todas as origens; cadastro manual. |
| GETPATCH | /api/admin/site-messages | Admin | Mensagens do formulário; marcar como respondida. |
| GETPOSTPATCHDELETE | /api/admin/campaigns | Admin | Campanhas de marketing. |
| GETPOSTPATCHDELETE | /api/admin/attendants | Admin | Equipe; excluir revoga a sessão na hora. Métricas em /stats. |
Rotas internas
| Método | Rota | Acesso | Descrição |
|---|---|---|---|
| POST | /api/internal/inactivity-sweep | Interno | Varredura de inatividade do WhatsApp. |
| POST | /api/internal/keepalive | Interno | Batimento que evita a pausa do Supabase. |
Banco de dados
PostgreSQL no Supabase, acessado pelo Transaction Pooler com postgres.js. Schema em supabase-schema.sql; todo acesso está em src/lib/db.ts. A agenda não fica no banco: a fonte da verdade é o Google Calendar.
erDiagram
users ||--o{ messages : "atendente"
conversations ||--o{ messages : "contém"
conversations ||--o{ ratings : "avaliada"
conversations ||--o{ message_attachments : "anexos"
messages ||--o{ message_attachments : "anexa"
users {
text id PK
text email UK
text password_hash
text role
}
conversations {
text id PK
text channel
text patient_name
text patient_phone
text bot_state
}
messages {
bigserial id PK
text conversation_id FK
text role
text content
text attendant_id FK
}
ratings {
bigserial id PK
text conversation_id FK
text rating
}
message_attachments {
text id PK
bigint message_id FK
text mime_type
bytea data
}
| Tabela | Conteúdo |
|---|---|
users | Contas do admin (admin ou atendente), senha em scrypt. |
conversations | Uma por conversa; bot_state guarda o estado do bot em JSON. |
messages | Mensagens do paciente e da clínica; attendant_id quando enviada por atendente. |
ratings | Notas da enquete de satisfação. |
message_attachments | Anexos do widget (até 4 MB). |
leads | Formulário do site e cadastro manual. |
marketing_campaigns | Campanhas por plataforma, tipo e status. |
appointment_notes | Anotações do dentista, ligadas ao evento da agenda. |
app_heartbeat | Batimento do keep-alive (a cada 6 h). |
whatsapp_processed_messages | Deduplicação do WhatsApp; limpeza após 7 dias. |
Leads do site e do WhatsApp não ficam em leads: são derivados das conversas com nome e telefone.
O plano gratuito do Supabase pausa projetos sem atividade por cerca de 7 dias. O app grava em app_heartbeat a cada 6 horas para evitar isso. Se pausar, restaure em Dashboard → Resume project.
Painel administrativo
Endereço /admin. A interface esconde as abas que cada perfil não usa; a restrição real está em cada rota da API.
| Aba | Admin | Atendente |
|---|---|---|
| Agendamentos (lista e calendário) | ✓ | ✓ |
| Agendas arquivadas (histórico e anotações) | ✓ | — |
| Histórico do Bot | ✓ | ✓ |
| Atendimento WhatsApp | ✓ | ✓ |
| Insights | ✓ | — |
| Leads | ✓ | — |
| Cadastro Manual | ✓ | — |
| Mensagens do Site | ✓ | — |
| Campanhas de Marketing | ✓ | — |
| Métricas dos Atendentes | ✓ | — |
| Meu Perfil | ✓ | ✓ (sem e-mail e senha) |
Agendamentos
Lista das próximas consultas (7, 15 ou 30 dias) ou calendário mensal, que abre no mês corrente e navega pelos meses seguintes e anteriores. Consultas realizadas aparecem em cinza, com link para o histórico. Em Agendas arquivadas, o admin busca consultas passadas e registra as anotações do dentista.
Histórico do Bot
Conversas do site e do WhatsApp, com mensagens, anexos e resumo por IA.
Atendimento WhatsApp
Chat ao vivo: assumir a conversa (o bot para de responder), responder, devolver ao bot e finalizar. Se uma resposta não for entregue, o painel mostra o erro e mantém o texto para reenviar.
Insights
Cartões, gráficos e Insights sugeridos: até 6 frases geradas por regras sobre os dados (variação em relação ao período anterior, dia de pico, captura de contato, origem dos leads, dias livres na agenda, satisfação). Filtros de período e canal.
Leads
Contatos de todas as origens, com contadores, filtros de período e origem, ordenação (recentes, antigos, A–Z, Z–A), filtro por data de cadastro e exportação em CSV, XML ou JSON.
Demais abas
- Cadastro Manual: contatos do balcão, abordagem, indicação ou telefone.
- Mensagens do Site: mensagens do formulário, botão Responder e marcação de respondida.
- Campanhas: Instagram, Facebook e Google Ads, orgânicas ou pagas.
- Métricas dos Atendentes: atendimentos e mensagens enviadas por pessoa no período.
- Meu Perfil: nome, foto, e-mail e senha (8+ caracteres, maiúscula, minúscula e número).
A sessão dura 8 horas; "Sair" revoga a sessão no servidor, e trocar a senha encerra as outras sessões da conta.
Segurança
Infraestrutura
| Controle | Detalhe |
|---|---|
| HTTPS | Certificados Let's Encrypt renovados pelo Traefik; HSTS de 1 ano só neste domínio. |
| SSH do servidor | Só por chave, no máximo 3 tentativas, troca de chaves pós-quântica, sem algoritmos antigos (CBC, SHA-1, MD5) e sem redirecionamentos. |
| Portas | Só HTTPS/HTTP e SSH; banco e Redis da Evolution apenas na rede interna do Docker. |
| Segredos | Fora do git e da imagem Docker; arquivos no servidor legíveis só pelo administrador do sistema. |
| Cabeçalhos | Bloqueio de iframe, nosniff, política de referência, sem anunciar a tecnologia. |
Painel administrativo
- Senhas com scrypt e sal; política forte para novas senhas.
- Sessão em cookie protegido (
__Host-, HttpOnly, Secure, SameSite Strict), 8 horas. - Logout revoga o token; trocar a senha derruba as outras sessões; excluir usuário encerra a sessão dele.
- Limite por IP e bloqueio por conta contra força bruta, sem revelar quais e-mails existem.
- Login aceito só vindo do próprio site; registro de tentativas com e-mail mascarado.
Site e formulário
- Validação no servidor: nome só com letras, telefone e e-mail válidos, horário da grade, data real até 180 dias.
- Token assinado anti-robô e campo-isca invisível.
- Limites por IP, por e-mail de destino e teto global de e-mails por hora.
- Dados escapados no HTML dos e-mails; mensagens de erro genéricas.
Assistente virtual
- Texto higienizado e limitado; sessão do widget só com UUID gerado por ele.
- Proteção contra prompt injection.
- Anexos verificados pelos bytes; PDFs com scripts e imagens com código embutido são recusados.
- Dados sigilosos removidos antes de gravar ou enviar à IA.
- Webhook do WhatsApp com token secreto, deduplicação e limite de 15 mensagens por minuto por conversa.
Pontos de atenção
Detalhes de saúde escritos livremente dependem da orientação da IA. Mensagens anteriores à proteção de dados sigilosos não foram higienizadas. Limitadores e revogação de sessão ficam em memória e zeram num reinício. O painel ainda não tem verificação em duas etapas, e o formulário não usa CAPTCHA.
Deploy e operação
Infraestrutura
| Item | Descrição |
|---|---|
| Servidor | VPS Linux com Docker (3,6 GB de RAM e 4 GB de swap); acesso administrativo só por chave SSH. |
| Domínios | clinica.connecttool.com.br (app) e evolution.connecttool.com.br (Evolution), DNS no Registro.br. |
| Banco | Supabase (região São Paulo). |
Evolution API v2, instância clinica, número +55 14 99875-7986. |
| Container | Função |
|---|---|
traefik | Proxy reverso e HTTPS de todos os sites do servidor. |
evolution-api, evolution-postgres, evolution-redis | Gateway do WhatsApp. |
clinica-app | Este projeto. |
Tarefas agendadas
| Tarefa | Onde | Frequência |
|---|---|---|
| Inatividade do WhatsApp | App | 1 min |
| Keep-alive do Supabase | App | ao subir e a cada 6 h |
| Watchdog do WhatsApp (reinicia a Evolution após 2 falhas, no máximo 1 vez a cada 30 min) | Servidor | 5 min |
Deploy
git commit ... # só o que está commitado é publicado
bash deploy/app/deploy.sh # no Git Bash, na raiz do projeto
O script envia o último commit (sem .env nem alterações locais), faz o build da imagem no servidor em segundo plano, troca o container só se o build der certo e confere se o site responde. Leva de 2 a 10 minutos. Se o build falhar, o site anterior continua no ar.
Variáveis de ambiente
| Variável | Uso |
|---|---|
DATABASE_URL | Banco Postgres (Supabase). |
AUTH_SECRET | Assina sessões, tokens do formulário e rotas internas. |
SITE_URL | URL pública do app. |
GROQ_API_KEY | IA do bot e resumos. |
GOOGLE_CALENDAR_ID, GOOGLE_SERVICE_ACCOUNT_JSON | Agenda. |
GMAIL_APP_PASSWORD | E-mails pela conta Gmail da clínica. |
EVOLUTION_API_URL, EVOLUTION_API_KEY, EVOLUTION_INSTANCE, EVOLUTION_WEBHOOK_TOKEN | WhatsApp. |
ADMIN_EMAIL, ADMIN_PASSWORD_HASH | Cria o primeiro administrador. |
BOT_INACTIVITY_SWEEP, SUPABASE_KEEPALIVE | Ligam ou desligam as tarefas periódicas (padrão: só em produção). |
Os valores ficam só nos arquivos .env e nunca vão para o repositório.
Procedimentos
WhatsApp não responde
- Verifique se a mensagem chegou à Evolution ou ao histórico do admin.
- Se não chegou, a sessão travou (o status pode dizer "open" mesmo assim). O watchdog reinicia em até cerca de 10 minutos; para forçar, reinicie o container
evolution-api. - Se o status for "close", o aparelho foi desconectado: gere um QR code no painel da Evolution e leia no celular da clínica (Dispositivos conectados → Conectar dispositivo).
- Se chegou mas o bot não respondeu, veja os logs do app e o estado da conversa; em atendimento humano, o bot fica em silêncio de propósito.
Admin com "Erro de conexão"
Provável pausa do Supabase. Restaure em Supabase Dashboard → Resume project (2 a 5 minutos).
Build falhou no deploy
O site anterior continua no ar. Veja o log do build no servidor; falta de memória aparece como "JavaScript heap out of memory".