Documentação Odonto Premium
Documentação técnica

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óduloO que faz
Landing pageSite institucional (serviços, sobre, diferenciais, depoimentos) com formulário de contato e agendamento protegido contra spam e robôs.
Dra. Sofia — siteChat com IA que cadastra o visitante, tira dúvidas, agenda consultas na agenda real e aplica a enquete de satisfação.
Dra. Sofia — WhatsAppO mesmo motor de conversa no número +55 14 99875-7986, com transbordo para atendente humano.
Painel administrativoAgendamentos (lista e calendário), histórico do bot, atendimento WhatsApp ao vivo, insights, leads, campanhas e métricas da equipe.
OperaçãoDocker 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
docs/ARQUITETURA.md

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
Visão do sistema e serviços externos.

Camadas do código

CamadaPastaResponsabilidade
Páginas e rotassrc/appLanding page, admin, simulador e rotas HTTP (api/).
Server Actionssrc/actionsFormulário do site: token anti-robô, horários ocupados, agendamento e e-mails.
Componentessrc/componentsSite público, widget Chatbot.jsx e painéis do admin.
Regras de negóciosrc/libMotor do bot, banco, autenticação, agenda, WhatsApp e segurança de entrada.
Infraestruturadeploy/, DockerfileImagem, Traefik, Evolution, watchdog e SSH.

Módulos de src/lib

MóduloFunção
bot-engine.tsMotor único de conversa (site e WhatsApp): estados, IA, agendamento, enquete, inatividade, despedida e privacidade.
bot-shared.tsTextos e regras compartilhados: prompt da IA, mensagens fixas, detecção de despedida e remoção de dados sigilosos.
whatsapp-bot.tsAdaptador do WhatsApp: entrega as ações do motor e roda a varredura de inatividade.
whatsapp-client.tsEnvio de mensagens (Evolution, depois Meta, depois Twilio), com prazo e novas tentativas.
db.tsAcesso ao Postgres, sempre com consultas parametrizadas.
auth.tsHash de senha (scrypt), sessão JWT em cookie e revogação.
scheduling.tsGrade de horários, dias úteis e feriados, busca e reserva no Google Calendar.
conversation-summary.tsResumo de conversas por IA para o admin.
input-security.tsSanitização de texto, nomes, ids de sessão e anexos.
contact-form-security.tsToken assinado anti-robô do formulário.
validations.tsSchemas Zod (formulário e política de senha).
rate-limit.tsLimitador em memória por chave (IP, e-mail).
internal-auth.tsAutorizaçã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

TarefaIntervaloRota interna
Varredura de inatividade do WhatsApp1 minPOST /api/internal/inactivity-sweep
Keep-alive do Supabaseao subir e a cada 6 hPOST /api/internal/keepalive

Decisões técnicas

  • Um motor, dois canais. bot-engine.ts decide o que dizer e devolve BotAction[]; 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_Paulo em todo cálculo de dia e horário.
  • Servidor persistente (Docker), o que permite limitadores em memória e tarefas periódicas.
docs/BOT-DRA-SOFIA.md

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]
EntradaDescrição
conversationIdSite: UUID da sessão do widget. WhatsApp: whatsapp:<telefone>.
channelbot ou whatsapp.
textTexto da mensagem (pode ser vazio).
channelPhoneWhatsApp: telefone já conhecido pelo canal.
knownContactSite: nome e telefone de uma sessão anterior, para não pedir de novo.
mediaWhatsApp: 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
EstadoSignificado
name / phoneCadastro. O WhatsApp pula o telefone, que já é conhecido.
chatConversa livre com a IA.
scheduling_timeAguardando o horário preferido ("10h", "de manhã").
scheduling_choiceHorários oferecidos; aguardando a escolha.
awaiting_more_helpDepois de reservar: "Posso ajudar em algo mais?".
awaiting_ratingEnquete enviada (😊 🙂 😐 🙁 😞 ou 1 a 5).
awaiting_inactivity_replyPerguntou "ainda está aí?"; guarda o estado anterior para retomar.
handoffAtendente humano assumiu: o bot só grava e não responde.
closedAtendimento 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

MomentoAção
5 min sem mensagens"Você ainda está por aí? 😊 Posso ajudar em mais alguma coisa?" (Sim ou Não)
SimRetoma de onde parou (pergunta pendente do cadastro ou horários oferecidos).
NãoAgradecimento e enquete.
Mais 5 min sem respostaEncerra 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 mudarArquivo e símbolo
Personalidade e regras da IAbot-shared.ts → SYSTEM_PROMPT
Saudações e mensagens fixasbot-shared.ts → ASK_NAME_MESSAGE, SURVEY_MESSAGE...
Palavras de despedidabot-shared.ts → CLOSING_PATTERNS
Dados sigilosos detectadosbot-shared.ts → SENSITIVE_RULES
Tempo de inatividadebot-engine.ts → INACTIVITY_TIMEOUT_MS
Horários e duraçãoscheduling.ts → AVAILABLE_HOURS, APPOINTMENT_DURATION_MINUTES
Modelo de IAbot-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].

docs/API.md

API

Todas as rotas ficam em src/app/api. Respostas em JSON; erros no formato { "error": "mensagem" }.

Público sem login, com limites Sessão admin ou atendente Admin só administrador Interno o próprio servidor

Site público

MétodoRotaAcessoDescrição
POST/api/chatPúblicoMensagem do widget (20/min por IP). Com event: "inactivity", aplica a regra de inatividade.
POST/api/chat/attachmentPúblicoAnexo 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

ActionLimiteDescrição
getContactFormToken()30 a cada 15 min por IPToken anti-robô assinado: validade de 12 h, uso único, mínimo de 3 s.
getBookedSlots(date)30/min por IPHorários ocupados num dia.
scheduleAppointment(data)5 a cada 15 min por IP; 3 por e-mail em 24 hValida, cria o lead, agenda e envia e-mails (teto global de 40 por hora).

WhatsApp

MétodoRotaDescrição
GETPOST/api/whatsapp/evolution-webhookCanal ativo. Recebe mensagens da Evolution; exige token secreto.
GETPOST/api/whatsapp/meta-webhookCanal alternativo Meta Cloud API (verify token e assinatura).
GETPOST/api/whatsapp/webhookCanal alternativo Twilio (assinatura).
POST/api/whatsapp/simulateSimulador; aceita só conversas novas ou de demonstração.

Painel administrativo

MétodoRotaAcessoDescrição
POST/api/admin/loginPúblicoLogin. 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/logoutPúblicoRevoga a sessão no servidor.
PATCH/api/admin/profileSessãoNome, foto, e-mail e senha (atendente não troca e-mail e senha).
GET/api/admin/appointmentsSessãoPróximas consultas (até 90 dias).
GET/api/admin/appointments/calendarSessãoConsultas de um mês (month=AAAA-MM).
GETPUT/api/admin/appointments/archivedAdminConsultas realizadas e anotações do dentista.
GET/api/admin/conversationsSessãoLista de conversas (site e WhatsApp).
GET/api/admin/conversations/[id]SessãoMensagens de uma conversa (e anexos em /attachments/[id]).
POST/api/admin/conversations/[id]/summarySessãoResumo da conversa por IA.
GET/api/admin/conversations/statsAdminIndicadores dos Insights.
POST/api/admin/whatsapp/[id]/handoffSessãoAssumir ou devolver ao bot.
POST/api/admin/whatsapp/[id]/sendSessãoResposta do atendente; 502 se o WhatsApp não aceitar.
POST/api/admin/whatsapp/[id]/finishSessãoEncerra o atendimento.
GETPOST/api/admin/leadsAdminLeads de todas as origens; cadastro manual.
GETPATCH/api/admin/site-messagesAdminMensagens do formulário; marcar como respondida.
GETPOSTPATCHDELETE/api/admin/campaignsAdminCampanhas de marketing.
GETPOSTPATCHDELETE/api/admin/attendantsAdminEquipe; excluir revoga a sessão na hora. Métricas em /stats.

Rotas internas

MétodoRotaAcessoDescrição
POST/api/internal/inactivity-sweepInternoVarredura de inatividade do WhatsApp.
POST/api/internal/keepaliveInternoBatimento que evita a pausa do Supabase.
docs/BANCO-DE-DADOS.md

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
    }
TabelaConteúdo
usersContas do admin (admin ou atendente), senha em scrypt.
conversationsUma por conversa; bot_state guarda o estado do bot em JSON.
messagesMensagens do paciente e da clínica; attendant_id quando enviada por atendente.
ratingsNotas da enquete de satisfação.
message_attachmentsAnexos do widget (até 4 MB).
leadsFormulário do site e cadastro manual.
marketing_campaignsCampanhas por plataforma, tipo e status.
appointment_notesAnotações do dentista, ligadas ao evento da agenda.
app_heartbeatBatimento do keep-alive (a cada 6 h).
whatsapp_processed_messagesDeduplicaçã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.

docs/PAINEL-ADMIN.md

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.

AbaAdminAtendente
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.

docs/SEGURANCA.md

Segurança

Infraestrutura

ControleDetalhe
HTTPSCertificados Let's Encrypt renovados pelo Traefik; HSTS de 1 ano só neste domínio.
SSH do servidorSó por chave, no máximo 3 tentativas, troca de chaves pós-quântica, sem algoritmos antigos (CBC, SHA-1, MD5) e sem redirecionamentos.
PortasSó HTTPS/HTTP e SSH; banco e Redis da Evolution apenas na rede interna do Docker.
SegredosFora do git e da imagem Docker; arquivos no servidor legíveis só pelo administrador do sistema.
CabeçalhosBloqueio 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.

docs/DEPLOY-E-OPERACAO.md

Deploy e operação

Infraestrutura

ItemDescrição
ServidorVPS Linux com Docker (3,6 GB de RAM e 4 GB de swap); acesso administrativo só por chave SSH.
Domíniosclinica.connecttool.com.br (app) e evolution.connecttool.com.br (Evolution), DNS no Registro.br.
BancoSupabase (região São Paulo).
WhatsAppEvolution API v2, instância clinica, número +55 14 99875-7986.
ContainerFunção
traefikProxy reverso e HTTPS de todos os sites do servidor.
evolution-api, evolution-postgres, evolution-redisGateway do WhatsApp.
clinica-appEste projeto.

Tarefas agendadas

TarefaOndeFrequência
Inatividade do WhatsAppApp1 min
Keep-alive do SupabaseAppao 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)Servidor5 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ávelUso
DATABASE_URLBanco Postgres (Supabase).
AUTH_SECRETAssina sessões, tokens do formulário e rotas internas.
SITE_URLURL pública do app.
GROQ_API_KEYIA do bot e resumos.
GOOGLE_CALENDAR_ID, GOOGLE_SERVICE_ACCOUNT_JSONAgenda.
GMAIL_APP_PASSWORDE-mails pela conta Gmail da clínica.
EVOLUTION_API_URL, EVOLUTION_API_KEY, EVOLUTION_INSTANCE, EVOLUTION_WEBHOOK_TOKENWhatsApp.
ADMIN_EMAIL, ADMIN_PASSWORD_HASHCria o primeiro administrador.
BOT_INACTIVITY_SWEEP, SUPABASE_KEEPALIVELigam 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

  1. Verifique se a mensagem chegou à Evolution ou ao histórico do admin.
  2. 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.
  3. 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).
  4. 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".