Secretária IA mais segura e contextual:
- Roteamento por especialidade: /contexto (dentistas+especialidades) injetado no
cérebro; descobrir o motivo e priorizar clínico geral só p/ avaliação/limpeza.
- Situações da clínica: regras editáveis injetadas no prompt (siga à risca).
- Dúvida/caso incerto → tool encaminhar_humano (não agenda; pede p/ aguardar).
- Imagem/áudio: ext:message.transcription religa no fluxo ext:message.new
(guard hadCaption evita processar 2x); a IA reage à descrição da imagem.
- Checklist do dono × banco → cautelas no /contexto: NÃO assumir clínico geral
por padrão p/ quem já é paciente; sem certeza de quem/qual dentista → humano.
- Desligar GLOBAL da Secretária: GET/POST /secretaria/power (kill-switch
auto_reply via config.set, efeito imediato, sem restart; visível a todos).
Inclui a plumbing da sessão (chat.upsert, ownership de conexão, ws-bridge).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Encaixe que quebra o espaçamento de 1h (ex.: 09:45): a IA usa perguntar_dentista
→ resolve o WhatsApp do dentista (bridge /dentista-contato), registra
sec_agenda_approvals (aguardando) e manda a pergunta ao dentista ("consegue
encaixar às X? SIM/NÃO", via hook ext:agenda.notify-dentist). Quando o dentista
responde, ext:message.new detecta (roda mesmo com auto_reply off), interpreta
sim/não; se SIM agenda (/book) e avisa o paciente automaticamente ("o Dr
confirmou, agendei às X"); se NÃO oferece outro horário.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Quando o cliente insiste num horário mais tarde, a IA usa confirmar_depois:
diz "vou confirmar, aguarde uns minutinhos" e registra um follow-up
(sec_agenda_followups, fire_at = now + followup_delay_min, default 15). Um worker
no ext-api (a cada 30s) processa os vencidos: consulta /slots perto do horário
desejado e manda ao paciente "Oie, consegui! Posso às X?" (assinado pelo agente).
Testado em dev: worker processa follow-up vencido, consulta a agenda e envia.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Regras injetadas no prompt: NUNCA listar vários horários — primeiro perguntar
"manhã ou tarde?", depois oferecer UM único horário (o primeiro livre do período,
via listar_horarios com periodo), um de cada vez, mantendo 1h entre atendimentos.
listar_horarios ganhou o parâmetro periodo (manha|tarde).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Ao registrar um pedido de horário fora do padrão, a IA passa a responder no tom:
"No momento esse horário não está disponível, mas ainda não confirmei a agenda —
posso te confirmar daqui a pouco?" (antes: "vou verificar com a secretária").
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Quando o cliente pede um horário PONTUAL fora dos disponíveis (mais cedo/mais
tarde), a IA usa solicitar_horario_especial → registra um pedido na agenda do
satélite (POST /pedido) e responde "vou confirmar com a secretária e retorno"
(sem garantir o horário). brain.ts injeta essa regra no prompt. Par do satélite
(scoreodonto): janela flex + fila da secretária humana.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
listar_horarios inclui `local` (nome da sala alugada ou "Clínica") e codifica o
sala_id no slot_id; agendar_horario repassa sala_id ao /book para reservar no
quarto certo. Par do satélite (scoreodonto): folga do dentista (A) + salas (B).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
brain.ts busca GET /status da agenda-bridge (aberto hoje?, próximo dia aberto,
grade da semana, feriados) e injeta no system prompt via formatClinicStatus,
junto da data já existente. Regra: a Secretária só oferece horário/agenda quando
a clínica está ABERTA — em dia fechado/feriado, informa o horário e oferece o
próximo dia disponível. (Par do satélite: scoreodonto #2.)
Testado em dev: ao pedirem "hoje" num domingo, ofereceu "amanhã" nos horários
configurados.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A Secretária passa a prefixar cada resposta enviada com o PRIMEIRO nome do
agente em negrito (ex.: "Ana — Atendente Virtual" → "*Ana:*\n<resposta>"),
igual à assinatura do operador humano — identifica a IA na caixa compartilhada
e é por-sessão (número com agente "Ana Clínica A" assina "*Ana:*"). Aplicado no
envio e no corpo persistido, nos dois caminhos (auto-reply e painel /ask).
Testado em dev: a Ana respondeu no WhatsApp com "*Ana:*" em negrito.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
O `update` do `chat.upsert` no MessageHandler passava `contactId: contact.id`
escalar, que o Prisma rejeita ("Unknown argument `contactId`. Did you mean
`contact`?") → PrismaClientValidationError. Isso derrubava o processMessage
ANTES de emitir o hook ext:message.new, quebrando o tempo real (inclusive o
auto-trigger da Secretária IA) para qualquer contato cujo chat precisasse
revincular o contato. Corrigido nos dois upserts (notify + histórico) para a
sintaxe de relação `contact: { connect: { id: contact.id } }`.
Verificado em dev: a Secretária respondeu ponta-a-ponta após o fix.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Núcleo desta mudança (separação por sessão):
- migrate.ts: sec_numbers.agent_id (FK→sec_agents, ON DELETE SET NULL) e
sec_calendar.instance_id, com índices (aditivo/idempotente).
- ext-api routes.ts: runtime resolve o agente pelo NÚMERO que recebeu a
mensagem (sec_numbers[instanceId].agent_id, fallback: 1º ativo); rotas
admin /secretaria/numbers e /secretaria/calendar aceitam os novos campos.
- brain.ts/tools.ts: instanceId no contexto; sec_calendar interno filtrado
por sessão; parse de jid robusto (.pop(), suporta 2 e 3 partes).
- secretaria/routes.ts: paridade (agent_id em numbers, instance_id no calendar).
Testado em dev (newwhats.dev refrescado): agentes resolvidos por instância;
fallback e FK ON DELETE SET NULL verificados via ext-api.
Obs.: por estarem no mesmo working tree não-commitado do newwhats.local,
ext-api/routes.ts e secretaria/tools.ts também trazem o trabalho acumulado
da integração do satélite (ações de inbox: delete/react/typing/labels/forward
e admin /secretaria/*; tools identificar_numero/cadastrar_paciente do odonto).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- re-download persiste a mídia no Wasabi e gera thumbnail <url>.thumb.webp (sharp)
- GET /inbox/:chatId/messages expõe mediaRecoverable = url|path|payload presente
- ws-bridge: encaminha hook ext:presence
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- POST /satellites/accounts (ensureAccount): cria/reativa User por email, idempotente;
gate aceita chave MESTRA ou chave de satélite (nwk_) válida — o satélite espelha
suas próprias contas (scoreodonto)
- POST /sessions/:id/connect (reconectar/re-scan) e /sessions/:id/disconnect
(encerrar sem remover) — antes o satélite recebia 404 no botão Conectar
- inclui proxy/re-download de mídia (/media/:id/download) da integração satélite
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- brain: detecta 429/cota (quota/billing/insufficient/exceeded/limite da api/
rate limit — inclui a msg PT do Gemini) e emite ext:provider.exhausted por
provider da chain (throttle de 6h por provider), com fallback informado.
- routes: handler ext:provider.exhausted monta notificação profissional e envia
por WhatsApp ao admin (admin_notify_phone da config secretaria), resolvendo o
JID canônico via onWhatsApp (trata 9º dígito BR; pula se número não existe).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Expõe o contrato de administração esperado pelo painel da Secretária no satélite
(antes só havia /secretaria/ask|numbers + /sec/* parcial → 404 em agents/calendar):
- agents: GET/POST/PUT/DELETE
- brain nodes: GET/POST por agente (/agents/:agentId/nodes) + PUT/DELETE (/nodes/:id)
- calendar: GET/POST/PUT/DELETE
- numbers: POST/PUT/DELETE (GET já existia)
- conversations (teste): list/create/patch/delete, /messages, /chat (brain.chat),
/finalize (brain.finalizeProtocol)
Backed pelas tabelas sec_* (globais/single-tenant no motor).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A integration_key do satélite (nwk_) passa a resolver por x-nw-email quando
presente (preserva multi-conta: cada usuário vê o WhatsApp do seu e-mail),
caindo no tenant dono do par quando ausente — igual no middleware REST e no
handshake do WS bridge. Valida o par (revoke) antes de resolver por email.
Permite migrar o scoreodonto da EXT_MASTER_KEY global p/ chave própria
(revogável/auditada), sem mudança de comportamento.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Torna o registry de satélites (PluginPair) o gatekeeper do ext-api, em vez de
uma única EXT_MASTER_KEY global:
- satellites.ts: serviço + router /api/ext/v1/satellites (listar/provisionar/
revogar/rotacionar), montado fora do authMiddleware com gate de chave mestra.
- apikey-auth: resolvePairKey aceita a chave do satélite (nwk_) no REST e no WS,
resolvendo o tenant do par; checa revoke no banco a cada request (revoke
instantâneo) + throttle de lastSeenAt.
- Chave mestra e ApiKey por-tenant seguem funcionando (não-quebra).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Bloqueia SÓ o disparo automático da Secretária (envios manuais seguem normais).
Só desliga quando a config é explicitamente false — sem a flag, inalterado.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
listar_horarios/agendar_horario chamam a ponte do scoreodonto (/api/nw/agenda
slots|book) quando configurada — slot_id sintético (dentista|start|end), telefone
derivado do JID do contato — com fallback ao calendário interno preservado.
brain.ts injeta a config da agenda (agenda_url/secret/clinica_id) no toolCtx.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
isRecoverableError inclui fetch failed/timeout/econnreset/etimedout/und_err —
um blip de rede no primeiro provider agora cai para o próximo da chain (openai→
gemini→anthropic→ollama) em vez de virar "[Erro ao chamar IA: fetch failed]".
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- GET /inbox: orderBy lastMessageAt DESC NULLS LAST (Postgres põe NULLS FIRST
em DESC → chats-stub sem mensagem tomavam o topo; parecia lista de contatos).
- GET /contacts/:jid/avatar/refresh: re-busca a foto pela conexão Baileys viva
(URLs do CDN expiram/404), com timeout de 5s e limpeza da URL obsoleta.
- GET/PUT /sec/keys: passam a ler/gravar na config do plugin 'secretaria'
(config é por-plugin: set(pluginName, obj)); antes gravava em plugin errado
e o brain nunca via as chaves. Corrige TS2345.
- auto-reply da Secretária: nunca responde em grupos (@g.us).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Satélite confiável acessa a conta de qualquer email via EXT_MASTER_KEY:
- apikey-auth: helpers isMasterKey/resolveMasterEmail resolvem o tenant pelo
User.email; middleware REST refatorado para usá-los.
- ws-bridge: handshake do /api/ext/v1/stream trata a chave mestra + x-nw-email
(antes só tabela apiKey → o túnel WS tomava 401).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
No evento 'open', chama getBusinessProfile(selfJid) (fire-and-forget) — só contas
Business retornam perfil (descrição/categoria/horário/etc.). Persiste
Instance.isBusiness e emite 'instance:business' para o tenant. O SettingsPanel já
exibe isBusiness lido de /api/instances.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
prisma.chat.findFirst filtrava por remoteJid, que não existe no model Chat (é jid)
→ 500 em todo /secretaria/ask. Corrigido; endpoint retorna o reply normalmente.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
text-embedding-004 foi descontinuado (404 'model not found'). Migra para
gemini-embedding-001 com outputDimensionality=768 (vetores leves p/ JSON+cosseno).
Validado: embed() retorna vetor 768d via Gemini.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Antes, com openai_key presente, qualquer falha (ex.: 429 insufficient_quota)
retornava null sem tentar o Gemini. Agora tenta OpenAI e, em falha, usa Gemini.
Aviso documentado: OpenAI (1536d) e Gemini (768d) são incompatíveis — trocar de
provider exige reindexar (sync-knowledge + memória de contato).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Cria+configura a conta no motor em um passo: instância (engine 'baileys7' = API
estável por padrão), setor default (idempotente por [tenantId,name]), webhook
opcional e connect opcional (emite QR). Devolve o 'trajeto' com cada passo
visível (instancia/engine/setor/webhook/conexao/business/secretaria/conhecimento),
marcando como pendentes os passos de plugin/satélite. Re-rodar não duplica.
InstanceRepository: provision() (upsert por unique [tenantId,name]) e ensureSector().
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- StorageProvider.deleteObjects(paths): delete seletivo em lote (chunks de 1000),
no provider concreto (Wasabi DeleteObjectsCommand + fallback local).
- GET /api/instances/:id/media-index: index/auditoria por chat/tipo/período
(baseado no DB, com agregado byType, paginado).
- POST /api/instances/:id/media-batch-delete: delete coordenado DB↔Wasabi,
dryRun por padrão (precisa dryRun:false p/ apagar); limpa mediaPath/mediaUrl.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Mostra o texto gerado pelo motor (messages.transcription, Gemini) abaixo do
player de áudio (🎤) e abaixo da imagem (👁). Propaga o campo transcription
por inboxTypes.Message, chatStore.Message e o bridge messagesToLegacy, e
atualiza em tempo real via novo listener socket message:transcription.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Move a transcrição para o motor (genérica p/ todos os tenants/satélites):
- media-transcribe.ts: Gemini 2.0 Flash (áudio→texto, imagem→descrição) a partir
do buffer já baixado; limite inline 18MB; fallback silencioso.
- MessageHandler.processMedia: após salvar a mídia, transcreve fire-and-forget e
grava em messages.transcription, emitindo 'message:transcription' p/ a UI.
- schema: campo Message.transcription (coluna aplicada nos bancos).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
O satélite (mercado, webhook-receiver) chama /api/ext/v1/secretaria/numbers, mas
o ext-api só tinha /sec/*. Adiciona o alias que espelha a rota interna
/api/secretaria/numbers (lista sec_numbers) — retrocompatível, não altera o satélite.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A secretária passa a "lembrar" do cliente entre conversas:
- tabela sec_contact_memory (fato + embedding JSON), chave = ext_chat_id/contact_name.
- na sumarização (a cada ~10 trocas) extrai fatos duradouros do cliente via LLM
e salva com embedding + dedup por similaridade (>0.92).
- buildSystemPrompt injeta "MEMÓRIA DO CLIENTE" com os fatos mais relevantes à
pergunta (cosseno); sem chave de embedding usa os mais recentes; tudo com
fallback silencioso (não regride).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adiciona busca semântica na Base de Conhecimento da secretária:
- embeddings.ts: chunking, embed (OpenAI text-embedding-3-small ou Gemini
text-embedding-004) e similaridade cosseno — tudo na aplicação, sem pgvector.
- tabela sec_knowledge_chunks (vetor em JSON/text) com índices.
- brain.ts: no nó 'knowledge', injeta só os top-4 trechos relevantes à pergunta
do usuário; indexação lazy por hash do conteúdo. Fallback para o conteúdo
inteiro se não houver chave de embedding ou em qualquer falha (não regride).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Cada modelo do modal de ajuda ganha um botão que cria o nó correspondente no
Cérebro (persona/knowledge/rules/calendar/escalation) já preenchido com o
conteúdo de exemplo. Desabilitado se nenhum agente estiver selecionado.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adiciona botão de ajuda (HelpCircle) na barra da /secretaria que abre um modal
detalhado: como funciona (agente + cérebro) + modelos prontos para Persona,
Conhecimento, Regras, Agenda e Escalada (copie e adapte) + dicas de uso.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- Nome exibido: contact.name (agenda) → verifiedName/notify (nome do WhatsApp)
→ pushName da última msg, em vez de cair direto no número quando não há
nome salvo na agenda.
- ThinSidebar: ícone (BrainCircuit) que direciona para /secretaria.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Documentos sem nome/extensão eram salvos como .bin mesmo tendo mimetype
conhecido. Agora a extensão vem de: nome original → mimetype (pdf/docx/xlsx/
mp3/...) → .bin só como último recurso. O serve do Wasabi (/api/storage/view)
também passa a mapear content-type para muitos tipos, não só octet-stream.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Título e textos da página /baileys ficam genéricos ("Monitor de Eventos")
para usuários comuns; "Baileys Engine"/"servidor Baileys" só p/ admin ou
ruibto@gmail.com.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Os rótulos técnicos das engines só aparecem para admin ou ruibto@gmail.com:
- usuário comum vê "API estável" e "API com botões";
- admin/ruibto vê "API estável (Baileys 7)" e "InfinityAPI".
(O item 'Baileys' na Sidebar e a página /baileys já são admin-only.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- Detecta WhatsApp Business (app) via getBusinessProfile no pós-conexão e
persiste em instances.isBusiness; painel mostra "Conta Business: sim/não"
(com nota Business App ≠ Business API).
- Painel avisa que trocar de API desconecta e exige escanear o QR novamente,
com confirmação antes de aplicar a troca.
- sendRichMessage agora monitora e loga erros especificamente quando a mensagem
tem botões/lista/carrossel (diagnóstico de rejeição de interativos por engine).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Ajuste: o painel de configurações lista as DUAS engines selecionáveis —
"API estável" (baileys7) e "InfinityAPI" (infinite) — além da versão.
Apenas a 'official' (Baileys 6, que dá 401) fica de fora da UI.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
O ícone de configurações deixa de abrir popover flutuante e passa a abrir um
painel grande na área central (no lugar das mensagens). O painel mostra apenas:
- "API estável" (= engine Baileys 7 oficial/baileys7, a que conecta), com ação
de ativar na instância;
- a versão do sistema (lida de /version.json).
ThinSidebar simplificada (sem o seletor flutuante); as engines seguem
selecionáveis no backend para teste.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Instala baileys@7.0.0-rc13 sob alias 'baileys-official' (coexiste com a
'infinite' = baileys 7.0.0-rc.9 e a 'official' = @whiskeysockets/baileys 6.x).
Nova engine 'baileys7' (LID/username, app-state moderno) selecionável por
instância; validação do PATCH /engine e rich-message (botões nativos v7)
atualizados; opção adicionada ao seletor da ThinSidebar.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Pin/arquivo/mute não vêm no history sync nem em chats.upsert — vivem no
app-state do WhatsApp. Adiciona syncChatStates() que faz resyncAppState das
collections critical_unblock_low/regular_high/regular (isoladas: uma falha não
derruba as outras); os pins chegam como chats.update e já são aplicados em
isPinned, subindo os fixados ao topo (ordenação já existente). Roda no
pós-conexão e reexecuta (3s/15s/40s) pois as app-state keys chegam após parear.
Obs.: depende da engine 'official' (a InfiniteAPI não sincroniza app-state).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Quando DISABLE_OUTBOUND=true, envolve sock.sendMessage na criação da sessão e
bloqueia QUALQUER envio ao WhatsApp — backstop universal, pois todo envio
(rotas, IA/secretária, chatbot, scheduler, warmer, plugins) usa este sock.
Evita que automações disparem mensagens a contatos/grupos reais ao conectar uma
sessão real em dev. Em produção a flag fica ausente/false (envios normais).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
src/ continha 114 artefatos (.js + .js.map) de builds antigos mal-configurados,
commitados por engano. Não são usados em runtime (dev usa tsx sobre .ts; prod usa
dist/, gerado por tsc com rootDir=src/outDir=dist). Remove todos e adiciona
backend/.gitignore para impedir que voltem.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
O createTable de sec_messages não tinha usage_tokens/provider_used/model_used,
mas brain.ts insere esses campos — quebrando com "column does not exist" em
qualquer banco criado antes dessas colunas (ex.: clones). Adiciona as colunas
ao createTable e um bloco idempotente hasColumn/alterTable (padrão já usado no
arquivo) que garante as colunas em tabelas pré-existentes no boot.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
VPS 4 Deploy Agent