F3 Conecta

Plataforma de Atendimento, Vitrine & Fidelidade

 Voltar ao Painel
Central de Atualizações

Notas da Versão & Changelog

Acompanhe em detalhes cada evolução, novos recursos e melhorias de desempenho do seu sistema.

v3.34.0
06 de Novembro, 2026
Versão Atual

Modo Silencioso da IA (Apenas Avisos & Chat): Autonomia para Operar Sem Respostas Automáticas em Conversas Abertas

Aperfeiçoamento do motor de autoatendimento no WhatsApp para estabelecimentos que desejam utilizar a conexão exclusivamente para a lógica de avisos ativos (confirmações Sim/Não de agendamentos, lembretes automáticos de horário, notificações de edição e Cartão Fidelidade) e painel de chat ao vivo, sem que o robô envie respostas genéricas como "Não entendi. Como posso ajudar?" a mensagens abertas dos clientes.

Silenciamento Inteligente da IA & Preservação do Painel de Chats
  • Fim do Fallback Forçado com IA Desativada: Ao desmarcar a opção "Permitir que a IA gerencie interações abertas dos clientes" e manter o Fluxo Padrão (Fallback) em branco, o robô permanece 100% silencioso diante de mensagens espontâneas que não correspondam a fluxos ativos.
  • Fluxo Normal no Painel (Conversando com o Bot): Mesmo com as respostas automáticas silenciadas, todas as mensagens e mídias recebidas continuam sendo registradas normalmente em Conversando com o Bot na aba Fila & Chats, permitindo visualização em tempo real e assunção manual pelo operador a qualquer momento.
  • Lógica de Avisos e Transbordo Protegida: Os disparos de confirmação de agendamento, lembretes automáticos (reconhecimento de respostas Sim e Não), frases gatilho de fila e alertas administrativos continuam operando integralmente, sem transbordos automáticos indesejados após 3 mensagens ou 3 mídias seguidas no modo silencioso.
v3.33.0
05 de Novembro, 2026

Central de Ajuda & Tutoriais em Vídeo: Grupos Personalizáveis, Capas Próprias Opcionais, Player Sob Demanda e Correção de Visibilidade no Fora do Horário

Lançamento da nova aba nativa Ajuda & Tutoriais integrada diretamente ao painel administrativo (disponível para proprietários e atendentes em todos os planos), com gerenciamento completo pelo Superadmin sem necessidade de alterações em código. Arquitetura projetada para zero impacto de desempenho no carregamento do painel, exibindo apenas miniaturas leves e instanciando o player youtube-nocookie exclusivamente no clique. Inclui ainda correção na fila de atendimentos noturnos para manter visíveis clientes aguardando envio de assunto.

Aba Ajuda & Tutoriais no Painel & Gestão no Superadmin
  • Grupos e Vídeos 100% Personalizáveis: Criação, edição, ativação/ocultação e reordenação por setas (↑ / ↓) de grupos e vídeos diretamente pelo Superadmin, com proteção transacional contra concorrência e bloqueio de exclusão de grupos com vídeos vinculados.
  • Capas Híbridas com Validação Binária: Suporte a upload opcional de capa personalizada (PNG, JPG ou WebP com verificação de magic bytes reais) ou uso automático da miniatura oficial do YouTube com fallback visual elegante.
  • Desempenho Máximo & Privacidade: Nenhum script ou iframe do YouTube é carregado ao abrir o painel; o player youtube-nocookie.com é criado apenas ao clicar no card e destruído imediatamente ao fechar o modal.
  • Vitrine de Upgrade Inteligente: Todos os planos e atendentes visualizam o manual completo, exibindo o selo "🔒 Recurso não incluso no seu plano" nos módulos adicionais com atalho direto de upgrade para o proprietário.
Visibilidade de Atendimentos Fora do Horário
  • Exibição Imediata de Chats aguardando_contexto: Clientes que recebem a mensagem automática de fora do horário agora permanecem imediatamente visíveis na seção Agendados (Fora do Horário) mesmo antes de responderem com o assunto, eliminando o período em que ficavam ocultos no monitor.
v3.32.0
22 de Setembro, 2026

Mini Site 2.0: Novo Bloco de Conteúdo/Avisos, Redes Sociais no Fluxo da Página e Rastreamento Multi-Canal com Meta Ads Pixel & Google Analytics GA4

Evolução estrutural completa do construtor de Mini Sites e Link na Bio da plataforma. Introdução de dois novos formatos de blocos dinâmicos — Bloco de Conteúdo/Texto/Avisos (permitindo publicação de comunicados, seção "Sobre Nós", regras e políticas de atendimento sem exigir links falsos) e Bloco Personalizado de Redes Sociais no fluxo da página com normalização automática de URLs. Implementação do rastreamento unificado de tráfego pago em três camadas com Meta Ads Pixel, Google Analytics 4 (GA4) e telemetria interna com keepalive: true, garantindo mensuração de conversões sem duplicação de eventos. Estabilização e padronização visual da largura dos modais de gerenciamento no painel administrativo.

Bloco de Conteúdo / Texto / Avisos (Formato 6)
  • Comunicação Clara sem Links Falsos: Permite que o estabelecimento publique anúncios temporários, avisos de recesso/feriados, seção institucional "Sobre Nós", regras de agendamento e políticas de cancelamento diretamente no Mini Site, eliminando a necessidade de links fictícios (#).
  • Estilos Visuais e Ícones Temáticos: Três opções visuais elegantes (Padrão Neutro, Destaque com Cor da Marca e Alerta/Aviso Dourado) com seletor de ícones intuitivos (📢 Megafone, ℹ️ Informação, 📜 Regras, ⭐ Destaque, 💡 Dica, 🕒 Horários, 📍 Endereço, 💳 Pagamentos, ❤️ Sobre Nós) e alinhamento à esquerda ou centralizado.
  • Sanitização Segura & Parágrafos Dinâmicos: Tratamento automático contra injeção XSS com conversão nativa de quebras de linha (\n para <br>) e preservação total de emojis digitados no painel.
Bloco de Redes Sociais Personalizado & Reordenável (Formato 5)
  • Posicionamento Livre no Fluxo: O lojista agora pode posicionar seus canais sociais no início, no meio ou antes da vitrine de serviços utilizando as setas de ordenação (▲ / ▼), além de contar com a barra social fixa no rodapé como fallback.
  • Normalização Inteligente de Handles: O cliente pode digitar apenas o @usuario ou a URL completa; o backend normaliza e valida automaticamente os destinos para Instagram, TikTok, Facebook e YouTube.
Rastreamento de Tráfego Pago & Métricas (Meta Pixel + GA4 + Banco Interno)
  • Disparo Simultâneo em 3 Camadas: Integração tripla através da função unificada trackClick(), enviando eventos com keepalive: true para garantir que nenhum clique em agendamento ou link seja perdido ao mudar de aba.
  • Semântica Rigorosa & Fim da Duplicação: WhatsApp dispara Meta Contact e GA4 generate_lead (sem duplicar com Lead); Agendamento dispara Meta Schedule e GA4 select_content (sem contaminar relatórios de e-commerce com begin_checkout); Vitrine dispara Meta ViewContent e GA4 select_item.
  • Consolidação no Painel Administrativo: A seção "Acessos e Desempenho (Últimos 30 Dias)" agrupa cliques em serviços vitrine e redes sociais com precisão matemática em tempo real.
Estabilidade Visual & UX do Modal no Painel Admin
  • Fim do "Efeito Sanfona" na Largura: Padronização da largura do modal "Novo Bloco / Link" com a classe modal-container e largura fixa de max-width: 620px, eliminando saltos de largura ao alternar entre botões, carrosséis, vídeos, redes ou textos.
Blindagem de Dados no Toggle & Semântica Tri-State
  • Preservação Integral de URLs e Subtítulos no Toggle: Ao clicar no ícone de olho para ocultar ou ativar qualquer bloco, a URL e o subtítulo existentes são 100% preservados, erradicando o bug onde updates parciais sobrescreviam colunas com NULL.
  • Diferenciação Estrita (Undefined vs Null): Implementação de merge defensivo no updateLink() que distingue com rigor ausência de envio (preservar banco) de limpeza intencional de campo (gravar NULL).
Card Destaque Flexível: Banner Informativo sem Botão
  • URL e Botão CTA Opcionais: Os estabelecimentos agora podem publicar cards de destaque contendo apenas imagem chamativa, título e descrição, sem a necessidade de cadastrar um link externo ou botão forçado.
  • Layout Limpo e Inteligente: Se a URL for omitida, o Mini Site renderiza um banner visual perfeito e a listagem do admin identifica o bloco como Banner Informativo (sem botão).
v3.31.0
10 de Setembro, 2026

Blindagem de Memória no WhatsApp: Fim do "Falso Desconectado", Autocura com Watchdog Silencioso e Preservação de Sessão

Atualização crítica de estabilidade e resiliência na camada de gerenciamento das sessões de WhatsApp (Baileys). Eliminação definitiva do bug de "falso desconectado" no painel administrativo — cenário onde o socket do WhatsApp continuava ativo recebendo mensagens, áudios e interações de IA normalmente, porém a rota de envio manual e a verificação de status ficavam indisponíveis devido à perda temporária de ponteiro no mapa de memória durante oscilações transitórias de conexão (conflito 440 ou stream restart). Implementação de reinserção garantida no evento de conexão, exclusão restrita estritamente a logouts manuais (401), watchdog autônomo de autocura a cada 30 segundos e tolerância a falhas no polling do frontend.

Blindagem de Memória & Fim da Falsa Desconexão
  • Preservação de Ponteiros em Oscilações Transitórias (440): Desconexões temporárias por concorrência ou atualização de stream não deletam mais a sessão do mapa em memória nem desativam a flag no banco de dados, mantendo o serviço disponível enquanto o Baileys restabelece o fluxo.
  • Desconexão Restrita a Logout Real do Usuário (401): A limpeza da sessão da memória e a marcação de inatividade no banco agora ocorrem estritamente quando o aparelho desconecta de forma deliberada no aplicativo (401 / loggedOut), respeitando com fidelidade o ciclo de vida do dispositivo.
Reinserção Automática & Autocura com Watchdog Silencioso
  • Reinserção Imediata no Evento "connected": Sempre que o socket estabelece ou reabre a conexão com os servidores do WhatsApp, o adapter é indexado instantaneamente no mapa de sessões ativas (tanto por ID numérico quanto por String), restabelecendo de imediato os envios pelo chat e a leitura de status.
  • Watchdog de Memória Silencioso (30s): Monitor de integridade em segundo plano que inspeciona periodicamente sockets abertos e saudáveis, sincronizando automaticamente o mapa em caso de qualquer inconsistência, garantindo disponibilidade contínua sem necessidade de intervenção humana.
Resiliência do Painel & Prevenção de Instâncias Concorrentes
  • Fim do Ciclo Vicioso de Reconexões: Ao eliminar o falso status de desconexão, erradica-se a necessidade do lojista clicar repetidamente em "Ativar Conexão", evitando o surgimento de instâncias concorrentes que geravam conflitos em cascata.
  • Tolerância a Oscilações de Rede no Frontend: O polling de checagem do WhatsApp no painel administrativo agora valida respostas bem-sucedidas antes de alterar a indicação visual, impedindo que flutuações pontuais de requisição façam o badge oscilar incorretamente.
Gestão Dinâmica de Teste Grátis (Trial) no SuperAdmin
  • Parâmetro Centralizado no Modal de Planos: O SuperAdmin agora pode definir a quantidade de dias de teste grátis (ex: 3, 7, 14, 30 dias) diretamente no modal "Showroom de Planos & Estratégia", persistido com segurança na tabela saas_config.
  • Reatividade Instantânea no Cadastro Público: O formulário de auto-cadastro consome a configuração via API pública e atualiza em tempo real os badges visuais, textos de garantia e alertas de confirmação sem necessitar de alteração manual em código.
  • Cálculo Preciso da Data de Expiração: O backend calcula a validade inicial da nova conta com base no parâmetro configurado (INTERVAL ? DAY), garantindo conformidade imediata para cobrança pós-teste.
Simplificação no Autocadastro & Geração Inteligente de Slug
  • Zero Fricção no Formulário de Cadastro: Remoção do campo manual de link/slug na tela inicial de cadastro. O cliente agora informa apenas os dados essenciais para iniciar seus dias de teste grátis imediatamente.
  • Resolução Silenciosa de Conflitos no Backend: O identificador exclusivo é derivado diretamente do nome do estabelecimento e, caso haja nomes coincidentes, o backend adiciona sufixo único automaticamente, garantindo que o cadastro nunca seja interrompido por erro de link duplicado.
Redirecionamento Automático de Usuários Logados (Padrão Canva/Slack)
  • Blindagem de Sessão no Head: Ao tentar acessar a tela pública de cadastro com uma sessão já conectada no navegador, o sistema redireciona imediatamente o usuário para o painel de gestão (/admin), impedindo preenchimentos acidentais, duplicidade de e-mails ou substituição involuntária de conta.
  • Navegação Fluida sem Loop: O redirecionamento utiliza window.location.replace, garantindo que o histórico do navegador não fique preso caso o usuário clique no botão "Voltar".
Preservação de Valores Promocionais e Customizados na Edição
  • Fim da Sobrescrita Involuntária de Mensalidades: Ao abrir o modal de edição de uma empresa no SuperAdmin, o valor customizado ou promocional previamente salvo é preservado com exatidão, recalculando o valor padrão apenas se o administrador alterar conscientemente o seletor de plano.
Evolução de Marca & Posicionamento Oficial: F3 Conecta
  • Nova Identidade "F3 Conecta": Evolução oficial do nome do sistema para refletir a amplitude do ecossistema que vai além de agendamentos, integrando Mini Sites profissionais, Clube Fidelidade VIP & CRM e Automações Inteligentes de WhatsApp.
  • Estabilidade Técnica Absoluta: A modernização da marca é 100% retrocompatível, mantendo todas as sessões ativas do WhatsApp, dados de empresas, faturas bancárias e links públicos em pleno funcionamento.
v3.30.0
10 de Setembro, 2026

Blindagem na Emissão de Boletos & Pix Efí Pay: Validação Cadastral Prévia, Fim de Erros Mascarados e Trava Anti-Duplicidade Inteligente

Aprimoramento abrangente no ecossistema financeiro e de cobranças do SaaS integrado à Efí Pay (Gerencianet). Implementação de validação cadastral prévia estrita de CPF/CNPJ antes de acionar a autoridade bancária, prevenção de mascaramento de erros com descontinuação de dados simulados em ambientes configurados, comunicação transparente de inconsistências da API diretamente ao usuário e arquitetura inteligente de reaproveitamento de faturas pendentes, eliminando cobranças repetidas na Efí e garantindo emissão rápida e consistente do boleto registrado oficial.

Validação Cadastral Prévia & Conformidade Bancária
  • Validação Rigorosa de Documento (11 ou 14 dígitos): O sistema valida previamente se a empresa possui CPF ou CNPJ regular cadastrado antes de despachar a chamada à Efí, evitando requisições desnecessárias e notificando prontamente o lojista caso falte o documento.
  • Conformidade com Normas do Banco Central: Assegura que toda emissão de boleto registrado atenda às exigências regulatórias nacionais, eliminando rejeições da autoridade emissora por ausência de dados obrigatórios do sacado.
Transparência na Emissão & Fim de Falhas Silenciosas
  • Feedback Transparente e Tratamento Real de Exceções: Em caso de recusa cadastral ou instabilidade na Efí Pay, o sistema não gera mais cobranças fictícias nem esconde a falha. A mensagem exata fornecida pela API é repassada via avisos (toasts) no painel.
  • Modo de Demonstração Confinado: Fallbacks simulados permanecem operacionais apenas em instâncias de teste/homologação onde não existam credenciais cadastradas no SuperAdmin, preservando o fluxo produtivo real.
Trava Anti-Duplicidade Inteligente & Gestão de Faturas
  • Prevenção de Cobranças Repetidas na Efí: Boletos e cobranças Pix reais já emitidos continuam sendo reaproveitados instantaneamente em cliques subsequentes, blindando o lojista contra emissões duplicadas e custos adicionais.
  • Substituição Automática de Dados Simulados: Se uma fatura continha código de barras provisório ou simulado de testes anteriores, o backend substitui os dados pelo boleto real registrado assim que o documento é corrigido, sem criar faturas órfãs.
  • Reaproveitamento Seguro de Faturas Pendentes: Solicitações de pagamento pelo botão de atalho localizam automaticamente qualquer fatura pendente pré-existente da empresa, impedindo a geração desnecessária de novas faturas no banco.
v3.29.0
08 de Setembro, 2026

Blindagem de Conexão WhatsApp & Baileys: Proteção Anti-Loop, Auto-Recuperação Resiliente e Sincronização em Tempo Real

Evolução profunda na estabilidade, segurança e resiliência da infraestrutura de integração com o WhatsApp via Baileys. Implementação de arquitetura anti-looping de reconexões com backoff exponencial inteligente e janela de estabilização, tratamento especializado para desconexões transitórias da Meta (incluindo erro de stream 503 e corte seguro para 440 Connection Replaced), ciclo de vida limpo com descarte de listeners do socket para prevenir vazamentos de memória e eliminação definitiva de falsos status "Desconectado" no painel através de cabeçalhos anti-cache estritos, normalização universal de identificadores e inspeção direta do estado do WebSocket.

Motor Anti-Loop e Backoff Exponencial Resiliente
  • Janela de Estabilização Ativa (15s): Se a conexão permanecer ativa e estável por 15 segundos, o contador de falhas consecutivas e a latência de reconexão são resetados automaticamente, garantindo que novas desconexões futuras reconectem de forma rápida sem penalidade acumulada.
  • Backoff Exponencial com Teto Seguro (60s): Em caso de instabilidade severa de rede, o intervalo de reconexão escala progressivamente (3s, 6s, 12s, 24s... até 60s), impedindo enxames de conexões (connection storms) e protegendo os números contra bloqueios ou banimentos por parte dos servidores do WhatsApp.
  • Guarda de Execução Anti-Duplicação: Bloqueio atômico de reconexões paralelas caso o socket já esteja conectado ou tenha recebido ordem explícita de desconexão manual pelo lojista.
Resiliência a Desconexões Transitórias da Meta & Gestão de Conflito
  • Auto-Recuperação Transparente (Status 503 / Stream Errored): Tratamento dedicado para reinicializações rotineiras e transitórias dos clusters da Meta. O sistema detecta o erro 503 e restabelece o fluxo em menos de 3 segundos, mantendo a sessão salva sem exigir novo escaneamento de QR Code nem intervenção do usuário.
  • Tratamento Seguro de Sessão Substituída (Status 440 / Connection Replaced): Interrupção imediata das tentativas de reconexão quando o WhatsApp identifica login simultâneo em outro dispositivo, destruindo o socket zumbi com segurança e prevenindo disputa cíclica de conexão.
Ciclo de Vida Limpo do Socket & Gestão de Memória
  • Destruição Real de Listeners e Encerramento de Sockets: Implementação de limpeza profunda no método destroy() com remoção de todos os ouvintes de eventos (removeAllListeners), finalização de socket de rede (sock.end()) e anulação de referências para erradicar memory leaks e duplicação de disparos.
  • Normalização Universal de Identificadores (Multi-Tenant): Tratamento resiliente de identificadores da empresa (Number vs String) no gerenciador de sessões, garantindo busca consistente e impedindo que instâncias ativas fiquem inacessíveis no mapa de sessões.
Sincronização em Tempo Real e Fim do Cache Fantasma no Painel
  • Blindagem Anti-Cache HTTP Estrita: Endpoints de status e controle de conexão (/whatsapp/status e /whatsapp/conectar) equipados com cabeçalhos Cache-Control: no-store, no-cache, must-revalidate e Pragma: no-cache, impedindo armazenamento intermediário por navegadores ou proxies corporativos.
  • Inspeção Ativa de Transporte do WebSocket: A verificação de status no backend agora avalia o estado real do WebSocket (adapter.isConnected || adapter.sock?.ws?.isOpen), garantindo resposta precisa de status verde imediatamente após o handshake com os servidores do WhatsApp.
  • Feedback Imediato na Interface: Ao clicar em "Ativar Conexão", o painel exibe indicador imediato de processamento e anexa timestamp dinâmico nas consultas, sincronizando o status sem necessidade de recarregar a página.
v3.28.1
08 de Setembro, 2026

Sincronização Dinâmica de Planos: Integração em Tempo Real entre o Showroom do SuperAdmin e o Auto-Cadastro

Implementação da integração dinâmica e ponta a ponta dos valores de assinatura do SaaS. Os valores configurados pelo Administrador Mestre no Showroom de Planos do SuperAdmin agora são refletidos em tempo real na tela pública de criação de contas e consumidos diretamente pelo backend no momento da geração do contrato e da primeira fatura, eliminando qualquer discrepância entre a estratégia comercial e a cobrança efetiva.

Conexão Dinâmica SuperAdmin & Cadastro
  • Endpoint Público de Planos: Disponibilizada rota leve dedicada (GET /api/public/planos) para consulta em tempo real dos pacotes ativos de auto-serviço diretamente da tabela central do SaaS.
  • Atualização Dinâmica dos Cards no Frontend: O formulário de cadastro consome os valores em tempo real assim que a página carrega, mantendo os valores originais como fallback imediato para garantir carregamento instantâneo.
  • Faturamento Dinâmico no Backend: O controlador de criação de empresas agora consulta a tabela central no momento do cadastro para atribuir o valor exato da mensalidade e gerar a fatura inicial.
v3.28.0
07 de Setembro, 2026

Identidade Visual & Assinatura White-Label: Padronização do Rodapé 'Powered by F3 Fábio Ramos' em Todas as Páginas Públicas

Unificação e padronização da identidade institucional e autoridade de marca em todas as interfaces públicas acessadas pelos clientes finais. O rodapé de assinatura oficial foi atualizado para apontar diretamente para o domínio principal (https://f3fabioramos.com.br) com a chancela "Powered by F3 Fábio Ramos", implementado de forma consistente e responsiva no Mini Site & Link na Bio, no Cartão Fidelidade Digital, no Portal de Agendamento Online, no Checkout e na tela de Cadastro.

Padronização do Rodapé Institucional
  • Atualização de Domínio e Naming: Atualização de "F3 Agenda" para "F3 Fábio Ramos", direcionando os cliques para o site oficial https://f3fabioramos.com.br com abertura em nova aba (target="_blank") e segurança (rel="noopener noreferrer").
  • Mini Site & Link na Bio: Rodapé do mini site atualizado com a nova assinatura e link oficial.
  • Cartão Fidelidade Digital: Inclusão do rodapé institucional estilizado no final da cartela pública de selos e recompensas.
  • Portal de Agendamento Web: Inclusão do rodapé no formulário público de agendamento (agendar.html), perfeitamente harmonizado com o tema dark/glass.
  • Páginas de Pagamento e Cadastro: Adição da assinatura nas páginas de confirmação de pagamento e criação de contas.
v3.27.2
07 de Setembro, 2026

Auditoria Completa na Gestão de Agendamentos: Rastreabilidade Total por Atendente e Administrador

Implementação de governança e rastreamento minucioso de autoria no módulo de Agendamentos. Todas as operações manuais realizadas no painel administrativo — cadastro de novos agendamentos, edições de horário ou serviço, atualizações de status e exclusões — passam a registrar explicitamente o nome e cargo do operador responsável (Atendente da equipe ou Dono da empresa), garantindo transparência operacional e auditoria completa tanto para a empresa quanto no painel do SuperAdmin.

Identificação de Autoria nos Logs de Auditoria
  • Criação de Agendamentos: O log agora registra exatamente qual atendente ou administrador cadastrou o horário (ex: "Mariana Silva (Atendente) cadastrou o agendamento #47...").
  • Edições e Remarcações: Qualquer modificação de data, hora, profissional ou serviço passa a carregar o autor da alteração no histórico (ex: "Carlos Souza (Atendente) atualizou o agendamento #47...").
  • Mudanças de Status: Ações de confirmação, conclusão ou cancelamento registram quem executou a mudança (ex: "Fábio Ramos (Dono) alterou o status do agendamento #47 para 'concluido'").
  • Exclusão de Horários: Registra de forma definitiva e rastreável qual usuário removeu um agendamento do sistema.
Unificação com o Módulo Multi-Atendentes
  • Consistência Global: O módulo de Agendamentos agora adota o mesmo padrão de rastreabilidade já consolidado nas áreas de Atendimento Humano no Chat e Cartão Fidelidade Digital.
v3.27.1
07 de Setembro, 2026

Modo Simulação & Webhook: Otimização da Notificação de Alteração e Eliminação de Mensagens Espúrias no Chat

Aprimoramento cirúrgico no comportamento do simulador de chat e webhooks internos de agendamento. Quando um agendamento é editado ou atualizado no painel de controle (alteração de data, horário ou profissional), o sistema agora direciona a notificação exclusivamente como aviso informativo no histórico do chat, eliminando o falso disparo de novos fluxos de agendamento e evitando respostas automáticas incoerentes como "Não entendi sua resposta" durante simulações e testes.

Correção: Webhook em Modo Simulado na Edição de Agendamento
  • Filtro de Ação no Simulador de Webhook: A rotina de simulação de chat interna em dispararWebhook passou a ser estritamente restrita a novos agendamentos (acao: 'criacao'). Edições e exclusões não geram mais mensagens simuladas de entrada de clientes solicitando novo horário.
  • Eliminação de Mensagens Conflitantes e Erros de Confirmação: Com a segregação de ações, o simulador deixa de solicitar confirmação (Sim/Não) para agendamentos que já foram criados e apenas tiveram seus horários editados, mantendo o histórico de mensagens 100% limpo.
Fidelidade Visual no Chat de Simulação
  • Aviso de Alteração Exibido no Chat Simulado: O aviso informativo oficial (✏️ Atualização no seu Agendamento!) agora é persistido corretamente no histórico do atendimento simulado como enviado pela empresa (from_me: 1), permitindo conferência visual fiel exatamente idêntica à experiência do cliente no WhatsApp real.
v3.27.0
07 de Setembro, 2026

Chatbot Inteligente: Correção do Transbordo Automático Prematuro com TTL de Inatividade e Limite Seguro de Interações

Correção cirúrgica de um bug que causava o transbordo automático prematuro para a fila de atendimento humano (longa_interacao). O sistema contabilizava interações de sessões distintas como se fossem contínuas — um cliente que agendou na segunda e voltou a conversar na quinta era transferido para fila humana logo nas primeiras mensagens, pois o contador nunca zerava automaticamente. Também foi corrigida uma falha onde confirmar ou cancelar um agendamento com sucesso incrementava o contador em vez de zerá-lo.

Correção: Contador de Interações Nunca Zerava por Inatividade
  • TTL de 30 Minutos de Inatividade: O rastreamento de interações agora registra o timestamp de cada troca (ultimaAtividade). Se o cliente ficou em silêncio por mais de 30 minutos entre sessões, o contador é zerado automaticamente antes de incrementar, tratando a nova conversa como um contexto completamente novo.
  • Log Transparente de Reset por TTL: Quando o reset ocorre, uma linha de auditoria é emitida no console indicando quantos minutos o cliente ficou inativo, facilitando o diagnóstico de transbordo em casos reais.
Correção: Confirmação de Agendamento Incrementava o Contador
  • Reset Direto ao Concluir o Fluxo: Quando o cliente responde Sim ou Não para confirmar ou cancelar um agendamento, o contador de interações agora é zerado (interacoes = 0, alertaEnviado = false) em vez de somar +1, reconhecendo que o fluxo foi concluído com sucesso.
  • Contagem Mantida para Respostas Inválidas: Respostas não reconhecidas na tela de confirmação (ex: cliente digita algo diferente de Sim/Não) continuam contando normalmente, pois representam dificuldade real do cliente.
Limite de 3 Interações: Agora Funcionando Corretamente
  • Limite Preservado em 3: O limite original de 3 interações consecutivas foi mantido — ele cumpre exatamente seu propósito: impedir que clientes que mandam textos, arquivos ou imagens aleatórias sem interagir com o menu polua o chat com respostas automáticas em loop. O que estava errado não era o limite, mas a falta de reset automático por inatividade e por conclusão de fluxo.
  • Log de Progresso Atualizado: O console passa a exibir interações consecutivas: X/3, tornando mais claro o ponto em que o transbordo acontecerá durante o monitoramento em tempo real.
Garantia de Compatibilidade Total
  • Zero Regressão: As funcionalidades independentes de transbordo (3 mídias consecutivas, transbordo por loop de repetição, transbordo manual pelo atendente e fila voluntária) utilizam caminhos de código separados e não foram impactadas.
  • Sem Alteração de Banco de Dados: Toda a correção está no rastreamento em memória (this.tracking), sem necessidade de migração de dados ou alteração de tabelas.
v3.26.0
06 de Setembro, 2026

Identidade Visual & Logotipo Unificados no Plano Fidelidade e Robô com Upload Direto e Mockup Interativo

Nova experiência de personalização de marca e White-Label para o Plano Fidelidade Digital & CRM e modernização completa do campo de logotipo no Robô de WhatsApp. Clientes agora podem enviar suas logomarcas diretamente de seus smartphones ou computadores com prévia instantânea e simulação em tempo real de como o cartão fidelidade aparecerá para o cliente final. A arquitetura unifica a persistência de marca no banco de dados, garantindo sincronização automática entre o Cartão Fidelidade, o Painel Administrativo e as automações do Robô em caso de upgrade de plano.

Módulo Fidelidade: Identidade Visual & Logo
  • Sub-Aba Dedicada: Adição da sub-aba "Identidade Visual & Logo" dentro do módulo Fidelidade, permitindo configurar o Nome Fantasia e a Logomarca Oficial sem precisar sair do fluxo de gestão de cartões.
  • Upload Direto com Preview: Suporte a envio de fotos direto do dispositivo (JPG, PNG, WEBP) com preview instantâneo e botão de remoção rápida.
  • Mockup Interativo do Smartphone: Maquete visual ao vivo que reproduz exatamente o cabeçalho da Carteira Digital do cliente final conforme o lojista digita o nome e atualiza o logotipo.
Modernização do Logotipo no Robô & Sincronização White-Label
  • Sincronização Automática pós-Upgrade: Logotipos configurados no Plano Fidelidade são persistidos centralmente no banco de dados e já aparecem pré-carregados nas Configurações Avançadas do Robô caso o cliente migre para um plano superior.
  • Botão de Upload no Robô: Substituição do antigo campo de URL de texto cru por um componente completo com seletor de arquivo e preview em miniatura.
  • Marca Própria (White-Label) no Painel: O logotipo enviado passa a ser refletido de imediato no cabeçalho da barra lateral esquerda do painel da empresa.
v3.25.0
06 de Setembro, 2026

Autocadastro Público Self-Service, Free Trial Inteligente com Bloqueio no 8º Dia e Login Unificado com E-mail e Senha

Lançamento do ecossistema de Autocadastro Público Self-Service voltado para os planos de entrada: Mini Site & Link na Bio e Cartão Fidelidade Digital & CRM. Agora, qualquer empresa, profissional autônomo ou comércio local pode criar sua conta em menos de 1 minuto diretamente pela página pública /cadastro, usufruindo de 7 dias de Free Trial com provisionamento instantâneo de ambiente e auto-login. A versão introduz bloqueio rígido de expiração no 8º dia (Tolerância Zero) integrado ao modal inteligente de pagamento Pix, validação assíncrona de link/slug em tempo real, proteção contra bots por honeypot e novo modo de login unificado com E-mail e Senha.

Página Pública de Cadastro (/cadastro)
  • Interface Responsiva & Seletor Visual de Planos: Página moderna em Dark Glassmorphism com cards comparativos entre o Plano Mini Site e o Plano Cartão Fidelidade, com suporte a parâmetros de campanha (?plano=minisite ou ?plano=fidelidade).
  • Validação de Link (Slug) em Tempo Real: Verificação assíncrona com debounce que informa instantaneamente se o link desejado está disponível para uso ou já foi registrado.
  • Proteção Anti-Bot & Rate Limit: Campo invisível honeypot que neutraliza preenchimentos automatizados e limitação de cadastros por IP para blindagem da infraestrutura.
  • Auto-Login & Redirecionamento Imediato: Ao concluir o cadastro, as credenciais e tokens de sessão são inicializados instantaneamente no navegador, levando o usuário direto para seu painel.
Free Trial de 7 Dias & Bloqueio Rígido no Dia 8
  • Tolerância Zero para Período de Testes: Diferente de planos pagos que contam com tolerância de atraso, as contas em período de testes são bloqueadas pontualmente na virada do 8º dia (NOW() > trial_expira_em).
  • Bloqueio Integrado com Pix Instantâneo: O middleware direciona a conta expirada para o overlay de suspensão, exibindo a fatura pendente com botão Pix integrado ao Mercado Pago para desbloqueio automático sem intervenção manual.
  • Banner Informativo de Testes: Durante os dias 1 a 7, o painel exibe um banner discreto indicando a contagem regressiva de dias restantes e botão para garantir a assinatura antecipadamente.
Provisionamento Condicional Atômico
  • Bifurcação Estrita por Plano: Cadastros do Mini Site provisionam exclusivamente os dados do Mini Site (garantindo que o link público funcione no primeiro segundo), enquanto cadastros da Fidelidade provisionam a campanha VIP inicial e CRM de 500 contatos, evitando registros desnecessários ou poluídos.
  • Login Híbrido no Painel: O painel de gestão passa a suportar login tanto pelo clássico Token de API quanto por E-mail e Senha cadastrados pelo Dono.
v3.24.0
05 de Setembro, 2026

Novo Plano Fidelidade Digital & CRM, Envio Inteligente de Cartões via WhatsApp Web e Alertas Proativos de Limite

Lançamento oficial do novo plano comercial focado em retenção de clientes e marketing de relacionamento: o Plano Fidelidade Digital & CRM. Uma solução desenhada para salões, barbearias, comércios locais e prestadores de serviços que buscam um programa completo de selos digitais, vouchers premiados e gestão interna de clientes sem precisar de robô de atendimento automatizado via WhatsApp. A atualização traz fluxo completo de envio manual inteligente com 1 clique via WhatsApp Web (wa.me), modal de feedback pós-carimbo com cópia imediata do link, proteção robusta do banco de dados com limite de clientes configurável no SuperAdmin e monitoramento proativo de uso no painel administrativo.

Novo Plano Fidelidade Digital & CRM
  • Fidelização VIP Completa: Acesso integral a todas as ferramentas do Clube de Fidelidade: campanhas ilimitadas, selos digitais, regras de expiração de ciclos e de inatividade, vouchers com códigos exclusivos e extrato detalhado de auditoria por operador.
  • Base de Clientes & CRM Integrado: Acesso à gestão de contatos, histórico de fidelização e filtros avançados no painel interno.
  • Painel Otimizado e Direcionado: A barra lateral do painel adapta-se automaticamente para empresas no Plano Fidelidade, ocultando abas de robô, simulador, fluxos, agenda eletrônica e mini site, garantindo uma navegação limpa, focada e sem distrações.
Envio Inteligente de Cartões & Modal Pós-Carimbo
  • Modal de Feedback Pós-Carimbo: Ao confirmar um carimbo de selo, um modal comemorativo apresenta o progresso atualizado da cartela, código do voucher gerado (quando a meta é atingida) e ações imediatas de compartilhamento.
  • Cópia de Link em 1 Clique: Botão rápido para copiar o link público exclusivo do cartão digital do cliente diretamente para a área de transferência, pronto para envio em qualquer canal.
  • Envio Direto via WhatsApp Web (wa.me): Botão inteligente que abre diretamente o WhatsApp Web com mensagem personalizada contendo o nome do cliente, quantidade de selos, prêmio e link da cartela digital, permitindo ao atendente realizar o envio sem necessidade de robô conectado ao sistema.
  • Ações Rápidas na Tabela de Fidelidade: Adicionado botão direto de cópia de link e envio inteligente no WhatsApp para cada cliente listado na tabela geral do clube.
Governança do CRM & Monitoramento Proativo
  • Limite de Clientes Customizável no SuperAdmin: Capacidade de definir um limite de contatos no CRM por empresa (com padrão recomendado de 500 contatos no Plano Fidelidade), mantendo planos ilimitados nos demais pacotes.
  • Alerta Proativo de Uso (80%+): Banner informativo sutil na aba de Clientes exibido quando o volume cadastrado atinge 80% ou mais da capacidade contratada, prevenindo surpresas e incentivando upgrades de plano de forma transparente.
v3.23.1
05 de Setembro, 2026

Sincronização Dinâmica de Faturamento SaaS com SuperAdmin e Refinamento de Alertas de Assinatura

Aprimoramento do ciclo de vida financeiro e faturamento recorrente na aba "Meu Plano & Mensalidade" do painel administrativo. Implementação de sincronização dinâmica em tempo real com as diretrizes globais configuradas no painel do SuperAdmin (saas_config), cálculo automático da data exata prevista para geração de faturas (eliminando prazos estáticos/hardcoded no código) e eliminação definitiva de mensagens e alertas conflitantes, garantindo transparência, clareza e previsibilidade financeira para o assinante.

Sincronização Dinâmica com o SuperAdmin
  • Parâmetro de Antecedência Dinâmico (dias_antecedencia_fatura): O endpoint /api/mensalidade/minha-assinatura agora consulta dinamicamente a configuração global do SaaS no banco de dados e entrega a antecedência real configurada pelo SuperAdmin.
  • Cálculo Preciso da Data de Liberação: O painel calcula matematicamente a data exata em que a cobrança será gerada (dataVencimento - diasAntecedencia). Se o SuperAdmin alterar o prazo de antecedência para 5, 7, 9, 10 ou 15 dias, a data e a mensagem se ajustam instantaneamente para todos os clientes.
  • Mensagem Explicativa Dinâmica: O Card Verde de conformidade agora exibe dinamicamente: "A próxima fatura será gerada automaticamente X dias antes do vencimento (em DD/MM/AAAA) para o vencimento em DD/MM/AAAA", sem valores numéricos fixos no JavaScript.
Refinamento Lógico & Coerência Visual
  • Eliminação do Conflito de Avisos: Ajuste na condicional inteligente do container de alertas (saas-alerta-vencimento). Quando a assinatura está ativa e em dia sem fatura gerada, apenas o Card Verde explicativo é renderizado, impedindo a exibição antecipada e concorrente do alerta amarelo de cobrança.
  • Exibição Contextual das Formas de Pagamento: Os botões de pagamento instantâneo (Pix e Boleto Efí Pay) e o alerta de renovação só entram em ação quando a fatura é de fato gerada na data programada ou na iminência do vencimento/carência, eliminando confusões no autoatendimento.
v3.23.0
04 de Setembro, 2026

Novo Módulo: Mini Site & Link na Bio Profissional, Personalização Visual Inteligente e Arquitetura Safe Merge

Lançamento oficial do mais novo grande produto da plataforma SaaS: o Módulo Mini Site & Link na Bio Profissional. Uma solução completa de alta conversão para empresas e profissionais autônomos concentrarem sua presença digital em um único endereço elegante (seusite.com/slug). Acompanhado de um novo plano comercial de entrada (Plano Mini Site), o recurso já nasce com arquitetura de alta performance SSR com cache em memória RAM, 4 tipos de blocos de conteúdo (botões, banners de destaque, carrosséis interativos com fotos e players de vídeo do YouTube), personalização avançada de cores com Color Picker e algoritmo de contraste YIQ inteligente, persistência com Safe Merge no MySQL e integração segura com o WhatsApp e agendamentos.

Novo Módulo: Mini Site & Link na Bio (Lançamento Oficial)
  • Página Pública Ultrarrápida (SSR com Cache RAM): Renderização Server-Side Rendering gerando páginas leves com carregamento instantâneo (<50ms), com cache inteligente em memória RAM (TTL 5 min) e invalidação imediata ao salvar configurações no painel.
  • 4 Tipos de Blocos de Conteúdo (Até 25 blocos): Liberdade total para montar a página com:
    • Botões de Links Simples: Links diretos com ícones FontAwesome personalizáveis;
    • Banners em Destaque: Cards ricos com imagem de capa, título, subtítulo e botão CTA;
    • Carrossel de Imagens: Slider horizontal com fotos, títulos e suporte a arrasto (drag & drop no mouse e swipe no celular);
    • Vídeos do YouTube: Player integrado responsivo com extração automática do ID do vídeo a partir de qualquer link do YouTube.
  • Identidade Visual Completa da Marca: Suporte a foto de perfil/logotipo circular, banner superior panorâmico de capa, slogan/biografia comercial e botão de atendimento direto no WhatsApp com mensagem pré-formatada.
  • Status de Funcionamento Inteligente em Tempo Real: Badge dinâmico no topo informando se o estabelecimento está "Aberto agora", "Fechado no momento" (indicando quando abrirá) ou em Feriado/Exceção, conectado diretamente à grade semanal de horários da empresa.
  • Telemetria & Estatísticas dos Últimos 30 Dias: Painel analítico no admin que contabiliza acessos e engajamento: Total de Visualizações, Cliques no WhatsApp, Cliques nos Links, Acessos a Rotas e Solicitações de Agendamento.
  • SEO & Compartilhamento Social Otimizado: Meta tags OpenGraph, Twitter Cards e favicon dinâmico injetados via SSR para pré-visualização impecável no WhatsApp, Instagram, Facebook e Telegram.
  • Novo Plano Comercial Mini Site: Plano de assinatura de entrada próprio, perfeito para atrair clientes que desejam profissionalizar seu link na bio das redes sociais antes de migrarem para planos com robô e agendamento.
Personalização Visual & Contraste Inteligente
  • Tema Personalizado (Custom): Além dos temas padrão Escuro (Dark #0b1120) e Claro (Light #f8fafc), o cliente agora pode escolher qualquer cor de fundo através de um Color Picker nativo com sincronização em campo hexadecimal.
  • Paleta Rápida de Cores Premium: Botões de 1 clique com cores pré-definidas elegantes: Preto OLED, Azul Noturno, Roxo Profundo, Stone / Café, Bege Creme e Off-White.
  • Contraste Automático por Fórmula YIQ: O sistema analisa a luminosidade da cor escolhida pelo cliente e ajusta a tipografia e os cards dinamicamente: fundos claros recebem tipografia escura (#0f172a) e cards brancos; fundos escuros recebem tipografia clara (#f8fafc) e cards translúcidos sofisticados com efeito glassmorphism (backdrop-filter: blur).
  • Badge Indicador de Contraste no Admin: Feedback visual em tempo real no painel de edição confirmando se a cor selecionada ativará o modo claro ou escuro.
Arquitetura, Módulos Flexíveis & Privacidade
  • Persistência Segura (Safe Merge no MySQL): Reformulação do método updateConfig para cruzar e preservar os dados atuais antes de gravar. Elimina definitivamente qualquer perda de dados do menu "1. Apresentação" (Título, Bio, Avatar, Banner e WhatsApp) ao reiniciar o servidor ou ao realizar uploads e salvamentos parciais.
  • Módulo "Como Chegar (Mapa & Waze)": Novo botão opcional na lista de módulos com modal responsivo gerando rotas diretas para Google Maps e Waze a partir do endereço configurado.
  • Módulos Condicionais por Plano: Controles de exibição de "Agendar Horário Online" e "Vitrine de Serviços" (com fotos, preços e duração) exibidos de forma inteligente apenas para planos com agendamento (Plano 3 e Plano 4).
  • Privacidade & Segurança no Clube de Fidelidade: Ocultação do botão público de fidelidade do Mini Site para proteger os dados dos clientes e evitar riscos de furto de vouchers premiados. O acesso aos selos acumulados permanece 100% seguro via token criptográfico pessoal enviado exclusivamente no WhatsApp privado do cliente.
  • Interface Otimizada na Assinatura: Ocultação automática do card de add-on "Pacote Multi-Atendentes" para clientes do plano Mini Site, mantendo o painel simples, direto e coerente.
v3.22.0
29 de Agosto, 2026

Métricas de Desempenho e TMA por Operador, Permissões Granulares, Sessões Permanentes e Auditoria

Evolução estratégica do módulo Multi-Atendentes focada em produtividade, governança e segurança. Introduz a Matriz de Permissões Granulares (com padrão seguro Zero Trust e caixinhas para liberar Dashboard, Profissionais, Serviços, Bloqueios e Financeiro), nova tabela de Desempenho e Tempo Médio de Atendimento (TMA) por Operador, arquitetura de Sessões Permanentes (bot_sessoes) imutáveis, sub-abas de foco na fila de chat ([Meus Chats] vs [Todos Ativos]), badges de posse com proteção contra respostas concorrentes e rastreamento completo de operador no Cartão Fidelidade com Extrato.

Métricas & Desempenho por Operador
  • Tabela de Desempenho da Equipe: Exibição consolidada por operador (incluindo o Administrador/Dono) com Total Atendidos, Atendidos Hoje, TMA (Tempo Médio de Atendimento amigável) e Chats Ativos em tempo real.
  • Identificação no Histórico de Protocolos: Nova coluna de Atendente e Tempo de Duração tanto na tabela de protocolos encerrados quanto no modal de busca global.
  • Sessões Permanentes (bot_sessoes): Cada atendimento realizado por um operador é gravado como um registro imutável, garantindo fidelidade estatística mesmo se o mesmo cliente for atendido por diferentes operadores ao longo do tempo.
Experiência na Fila & Prevenção de Conflitos
  • Sub-Abas de Foco na Fila: Alternância rápida entre [ 🟢 Meus Chats (N) ] e [ 🔵 Todos Ativos (N) ] com inicialização inteligente baseada no perfil do usuário logado.
  • Badges de Posse & Linha Destacada: Identificação visual imediata com badge verde 🟢 Meu Atendimento e proteção de concorrência com modo de leitura e botão de [ 🔁 Transferir para mim ].
  • Encerramento Automático com Duração: O timeout por inatividade (tempo_reativacao_minutos) finaliza sessões pendentes no banco registrando o tempo exato e reativando o robô.
  • Permissões Granulares por Operador: Matriz de caixinhas opcionais no modal de cadastro/edição do atendente para liberar com precisão: Dashboard, Profissionais, Serviços, Bloqueios e Financeiro & Relatórios. Por padrão, todo novo atendente entra com visão 100% segura e focada nas operações (Fila de Chats, Agenda, Clientes e Fidelidade).
  • Rastreamento de Operador no Cartão Fidelidade: Registro obrigatório de quem carimbou selos ou resgatou prêmios (operador_nome e operador_id), novo botão [ 📜 Extrato ] com auditoria detalhada de cada lançamento e logs instantâneos na aba de Auditoria com badges próprios ([Selo Fidelidade], [Resgate Prêmio] e [Selo Auto]).
  • Logs de Auditoria de Operadores: Registro detalhado de eventos com badges próprios para [Assumiu], [Encerrou], [Reabriu], [Transferência] e [Msg Painel].
  • Plano 3 com Cartão Fidelidade (Modelo Cumulativo): O Plano 3 agora segue o modelo cumulativo linear (Bot + Agenda + Fidelidade + CRM), permitindo que empresas com agendamento por hora marcada (barbearias, clínicas, estéticas) utilizem campanhas de fidelidade e pontuação sem necessidade do Plano 4.
v3.21.0
29 de Agosto, 2026

Módulo Multi-Atendentes: Gestão de Equipe, Login Duplo e Atribuição de Conversas

Expansão da plataforma SaaS para suportar múltiplos operadores e atendentes simultâneos por empresa. O sistema preserva 100% o funcionamento original de 1 atendente para todos os planos existentes e adiciona o pacote modular Multi-Atendentes (até 5 operadores) com possibilidade de contratação de atendentes extras. Inclui tela de login duplo (Admin por Token ou Atendente por E-mail + Senha), aba de gestão de equipe, atribuição visual de conversas na fila e faturamento automático integrado.

Gestão de Equipe & Atendentes
  • Nova Aba "👥 Equipe": Painel completo para o Administrador cadastrar, editar, redefinir senhas e desativar operadores com controle estrito de limites do pacote contratado.
  • Tela de Login Duplo: Interface intuitiva que permite aos Administradores logarem com o Token Secreto e aos Atendentes logarem com Token da Empresa + E-mail + Senha.
  • Isolamento e Restrição de Perfis: Atendentes possuem visão focada no atendimento e agenda, com bloqueio automático de abas sensíveis (Financeiro, WhatsApp, Configurações do Bot).
Fila com Atribuição & Faturamento Modular
  • Identificação do Operador na Fila: Gravação automática do operador que assumiu a conversa (atendente_nome e atendente_usuario_id) com exibição de chip visual no monitor de atendimentos.
  • Filtro "Meus Atendimentos": Suporte a filtragem dinâmica na fila para que cada operador visualize seus atendimentos ativos.
  • Faturamento Integrado com Add-on: Cálculo automático das mensalidades e faturas Pix/Boleto considerando plano base + pacote multi-atendentes + atendentes adicionais.
v3.20.1
28 de Agosto, 2026

Estabilização do Hover de Reações, Botão Trigger de Emojis e Suporte Total no Modo Simulador

Refinamento de usabilidade e precisão no Módulo de Reações com Emojis. Implementação de ponte invisível (hover bridge) no CSS que elimina o fechamento acidental da paleta de emojis ao mover o cursor, novo botão trigger discreto (😀) para abertura facilitada em qualquer dispositivo e geração automática de identificadores de mensagem (wamid) no modo Simulador, permitindo testar e curtir mensagens livremente sem necessidade de conexão ativa.

Usabilidade & Estabilidade de Reações
  • Hover Bridge 100% Estável: Ponte de contato contínuo no CSS conectando o balão à barra flutuante, garantindo que os emojis permaneçam abertos e confortáveis para clicar.
  • Botão Trigger de Emoji (😀): Mini botãozinho de ação anexado a cada balão de mensagem para abrir a paleta de reações com 1 clique (ideal para telas touch e mouse).
  • Mock WAMID no Simulador: Todas as mensagens mock geradas no Simulador agora recebem um ID simulado automaticamente, permitindo testar reações e curtidas sem travas.
v3.20.0
28 de Agosto, 2026

Módulo de Reações e Curtidas de Mensagens com Emojis (WhatsApp Reactions)

Lançamento oficial do sistema de Reações com Emojis Nativas do WhatsApp para o painel de atendimento do SaaS F3 Agenda. Agora, atendentes e operadores podem reagir diretamente às mensagens de clientes e participantes de grupos com emojis rápidos (👍 ❤️ 😂 😮 😢 🙏), trocar reações ou removê-las com 1 clique, além de sincronização em tempo real das reações enviadas pelos próprios clientes pelo celular.

Reações com Emojis no Chat Web
  • Barra Flutuante no Hover: Ao passar o cursor sobre qualquer balão de mensagem no painel, uma barra elegante surge com os 6 emojis mais populares do WhatsApp (👍 ❤️ 😂 😮 😢 🙏) e botão de remoção rápida.
  • Badge de Reação Fixado no Balão: Exibição do emoji no canto inferior do balãozinho da mensagem, com suporte a clique direto para desfazer ou alternar a reação.
  • Sincronização Bidirecional & Toggle: Clicar no mesmo emoji que já estava marcado envia comando de remoção para a Meta; reações enviadas pelos clientes pelo WhatsApp aparecem instantaneamente no painel via polling/upsert.
  • Compatibilidade Total com Grupos & Chats Individuais: Suporte unificado tanto para conversas individuais (1 a 1) quanto para o Módulo de Grupos de Projetos e Reuniões.
  • Segurança Multi-Tenant & Identificador WAMID: Validação rigorosa por empresa (empresa_id) e gravação do identificador original da mensagem (wamid) no MySQL.
v3.19.1
28 de Agosto, 2026

Blindagem Humanizada da Simulação de Digitação em Grupos do WhatsApp

Aprimoramento crítico na camada de comunicação do BaileysAdapter e do Módulo de Grupos de Projetos. O método simulateTyping foi reestruturado com isolamento total no disparo de presença (sendPresenceUpdate), garantindo que o intervalo de digitação humana (tempo proporcional ao tamanho da mensagem) seja executado obrigatoriamente sem interrupções mesmo em grupos (@g.us), blindando a conta contra disparos instantâneos e mantendo a experiência natural e protegida.

Simulação de Digitação Humanizada & Anti-Ban
  • Execução Ininterrupta do Delay: O cálculo de tempo de digitação (proporcional a 20ms/caractere, entre 1.2s e 4s) agora é 100% garantido e à prova de falhas, mesmo quando o WhatsApp recusa o status de presença em grupos.
  • Comportamento Idêntico ao Chat Individual: As respostas enviadas para grupos de projetos passam exatamente pelo mesmo ritmo humanizado e seguro dos atendimentos individuais.
  • Simulação em Envio de Mídias e Documentos: Integrada a simulação prévia de digitação também no envio de fotos, áudios e arquivos para grupos pelo painel.
v3.19.0
28 de Agosto, 2026

Grupos de Projetos & Reuniões no WhatsApp, Estrutura de 4 Planos SaaS Especializados e Cobrança Condicional Inteligente

Lançamento oficial do Módulo de Grupos de Projetos & Reuniões (WhatsApp) para atendimento humano direto e colaborativo em grupos pelo painel web, estruturação estratégica da Matriz de 4 Planos do SaaS F3 Agenda com controle de acesso rigoroso no backend (requirePlan), novo fluxo de Cobrança SaaS Condicional Inteligente e sincronização completa no Web Admin, SuperAdmin e Aplicativo Mobile.

Grupos de Projetos & Reuniões (WhatsApp)
  • Vinculação Automática em 1 Clique & Manual: Modal para puxar e listar grupos participando no WhatsApp conectado ou cadastrar manualmente pelo ID do grupo (...@g.us).
  • Chat Humano Direto no Painel Web: Janela de atendimento ao vivo com balões identificados pelo nome do autor, suporte a envio de texto, anexos, fotos, documentos e colagem de prints via Ctrl+V com simulação de digitação humana (composing).
  • Identificação Inteligente do Remetente em Cascata: Consulta automática em 3 níveis ao receber mensagens: (1º) Nome oficial no CRM; (2º) Nome do perfil no WhatsApp (pushName); (3º) Fallback com telefone formatado (DD) 9XXXX-XXXX.
  • Isolamento de Banco & Zero Interferência de Bots: Tabelas exclusivas (bot_grupos e bot_grupos_mensagens) com bloqueio 100% garantido contra disparos de robôs, fluxos automáticos ou IA Gemini em grupos.
  • Desvinculação Segura: Remover um grupo pelo painel apenas retira o monitoramento do SaaS, sem sair do grupo no WhatsApp do celular.
Matriz de 4 Planos SaaS
  • Plano 1 (Somente Bot): Atendimento automatizado 24h via WhatsApp, Chat Humano ao Vivo, Gestão de Grupos e Simulador Visual.
  • Plano 2 (Bot + Fidelidade & CRM): Novo plano exclusivo com Robô WhatsApp + Base de Clientes (CRM) + Cartão Fidelidade VIP Completo + Grupos.
  • Plano 3 (Bot + Agenda & CRM): Robô WhatsApp + Sistema completo de Agendamentos, Calendário, Profissionais, Serviços, Bloqueios, Grupos e CRM.
  • Plano 4 (Completo + App Mobile): Todos os recursos do ecossistema desbloqueados sem limites: Bot WhatsApp + Cartão Fidelidade VIP + Base CRM + Agenda Eletrônica Completa + Grupos de Projetos + Aplicativo Mobile de Gestão.
Segurança de Rotas, Cobrança & Painéis
  • Cobrança SaaS Condicional Inteligente: Ocultação automática de botões de pagamento quando a conta está em dia, novo card visual Sua assinatura está 100% em dia! com previsão de faturamento e exibição em destaque de Pix/Boleto apenas quando houver fatura aberta.
  • Blindagem Backend (requirePlan): Todas as rotas de Fidelidade, CRM, Atendimentos, Serviços, Funcionários e Bloqueios contam com validação de plano ativa.
  • Interface Dinâmica Web & SuperAdmin: Menus e abas no Web Admin adaptam-se instantaneamente ao plano contratado; o SuperAdmin gerencia e visualiza os 4 planos com novos badges e valores automáticos.
  • App Mobile Integrado: Telas do aplicativo (Fidelidade, CRM, Agenda, Meu Plano, Profissionais) mapeadas com os 4 planos, formatação de telefones e tratamento elegante de bloqueios por plano.
  • Máscara & Validação de Profissionais: Campo de WhatsApp no cadastro de profissionais com máscara automática (DD) 9XXXX-XXXX, limite de caracteres, validação de preenchimento e exibição padronizada no Web e App.
v3.18.0
26 de Agosto, 2026

Centralização Total no CRM: Seleção de Clientes na Fidelidade e Simulador, Travas de Segurança & Auditoria

Unificação arquitetural colocando a Base de Clientes & CRM Interno como fonte central da verdade. O modal de carimbar selos de fidelidade e o simulador do robô agora operam 100% integrados à base de clientes cadastrados, com auto-preenchimento, campos travados contra edição indevida (readonly), atalho para cadastro rápido no CRM, blindagem da Conversa de Simulação Visual e rastreabilidade total de eventos nas Auditorias do Bot e SuperAdmin.

Simulador & Fidelidade Integrados ao CRM
  • Puxar Cliente do CRM ao Carimbar Selo: Modal de carimbar cartão fidelidade agora conta com seletor dinâmico de clientes do CRM, auto-preenchimento e trava de segurança contra digitação incorreta.
  • Puxar Cliente do CRM no Simulador: Dropdown com carregamento dinâmico dos clientes cadastrados, preenchendo automaticamente Nome e WhatsApp com máscara.
  • Sincronização Automática do Cliente Alvo: O campo de telefone para ações rápidas do Admin agora é preenchido automaticamente e travado como readonly para evitar qualquer erro de digitação.
  • Conversa de Simulação Visual em Tempo Real: Busca multi-formato no histórico e garantia do DDI 55 na sincronização garantem exibição contínua e instantânea de todos os balões de diálogo.
CRM & Auditoria Global
  • Máscara Inteligente no CRM: Formulários de "Novo Cliente" e "Editar Cadastro" contam com a máscara dinâmica (DD) 9XXXX-XXXX e normalização 12 dígitos na persistência.
  • Logs de Auditoria do CRM & Fidelidade: Criação, edição e exclusão de clientes no CRM e movimentações de fidelidade agora geram registros detalhados na Auditoria do Bot e na Auditoria Global do SuperAdmin com filtros e badges dedicados.
v3.16.0
26 de Agosto, 2026

Exclusão Inteligente de Contatos no CRM & Notificação Gamificada de Selos

Adicionado o recurso de Exclusão Segura de Clientes no CRM com detecção automática de impacto de agendamentos e remoção em cascata para evitar ressincronização indevida. Otimizado o layout das notificações do WhatsApp do Cartão Fidelidade com barra de progresso gamificada e normalização completa no Simulador de Atendimento.

Gestão & Exclusão no CRM
  • Exclusão Inteligente com Modal de Impacto: Identificação em tempo real se o cliente possui agendamentos ou faturamento histórico, alertando o gestor com total transparência.
  • Limpeza em Cascata: Exclusão segura que remove cadastros órfãos, histórico de agendamentos, cartões de fidelidade e OTPs associados para impedir que a sincronização automática recrie contatos excluídos.
  • Exibição Formatada na Tabela CRM: Telefones agora são formatados visualmente no padrão nacional legível (DD) 9XXXX-XXXX.
  • Máscara Inteligente no Cadastro do CRM: O formulário de "Novo Cliente" e "Editar Cadastro" agora aplica a máscara dinâmica (DD) 9XXXX-XXXX e normaliza automaticamente o número na persistência.
Fidelidade & Simulador
  • Mensagem Gamificada Direta: Substituição de textos redundantes pelo formato compacto [ ⭐⭐☆☆ ] (2/10) ➔ 🎁 Prêmio.
  • Normalização no Simulador: Entradas de números no simulador de mensagens agora são normalizadas para 12 dígitos, sincronizando chats em tempo real com o cartão fidelidade.
v3.15.0
26 de Agosto, 2026

Padronização Unificada do WhatsApp (9º Dígito) & Ferramenta de Limpeza de Cartões

Implementada a padronização arquitetural de números de WhatsApp em todo o ecossistema do Cartão Fidelidade, alinhando com a remoção automática do 9º dígito já utilizada nos Agendamentos e no Baileys. Adicionado também o sistema de Limpeza e Gestão de Cartões por Campanha com pré-visualização de impacto e travas de segurança.

Limpeza de Histórico & Cartões
  • 3 Modos de Limpeza Inteligente: "Sem Uso" (cartões zerados), "Ciclos Expirados" (já zerados por prazo) e "Zerar Campanha Completamente" (reset total).
  • Preview de Impacto & Proteção Ativa: Pré-visualização do total de cartões, selos em risco e vouchers pendentes antes de confirmar qualquer ação. Bloqueio automático de reset total quando há vouchers não resgatados.
  • Confirmação de Segurança: Obrigatoriedade de digitação da palavra "CONFIRMAR" para liberar ações destrutivas irreversíveis.
Padronização do WhatsApp & Zero Duplicação
  • Normalização do 9º Dígito BR: Unificação da lógica 5582999991234 → 558299991234 em todo o fluxo de Fidelidade (Chat, CRM, Agendamentos e Painel Admin), eliminando duplicidade de cartões para o mesmo cliente.
  • Máscara Inteligente de Telefone: O campo de entrada reconhece números vindos do banco com prefixo 55 e formata visualmente sem truncar dígitos.
  • Exibição Formatada na Tabela: Números na listagem do clube de fidelidade são apresentados no padrão nacional legível (DD) 9XXXX-XXXX ou (DD) XXXX-XXXX.
  • Mensagem Gamificada & Compacta: Layout enxuto no WhatsApp com barra de progresso visual direta [ ⭐⭐☆☆ ] (2/10) ➔ 🎁 Prêmio sem redundâncias.
v3.14.0
26 de Agosto, 2026

Validade Inteligente de Fidelidade, Otimização de Logotipo e Refinamento Visual

Adicionado o motor completo de Validade e Expiração de Selos e Vouchers com regras configuráveis por campanha (Renovável por Inatividade, Prazo Fixo ou Vitalício). Ajustado o ajuste visual dinâmico do logotipo na Carteira Web e refinada a seleção do menu Fidelidade no Painel Admin.

Validade Inteligente & Rollover
  • Renovação por Inatividade: O cliente ganha +X dias (ex: 90 dias) a cada novo carimbo recebido. Se mantiver frequência contínua, os pontos nunca expiram.
  • Prazo Fixo de Ciclo & Vitalício: Escolha entre ciclo fixo rígido ou selos vitalícios sem expiração. Campos do formulário adaptam-se dinamicamente conforme a regra escolhida.
  • Validade do Voucher de Prêmio: Prazo configurável (ex: 30 dias) para retirada da recompensa após completar a cartela.
  • Rollover e Banner Expirado: Se o ciclo expirar, o sistema arquiva o histórico e reinicia uma nova cartela automaticamente no próximo carimbo.
Melhorias de Layout & UI
  • Carimbo 1-Clique no Chat ao Vivo: Captura automática e bloqueio de segurança do WhatsApp/Nome do cliente diretamente da janela de conversa aberta.
  • Ajuste Visual do Logotipo: Correção no contêiner da logo da empresa em fidelidade.html (ajuste proporcional sem cortes ou distorções).
  • Menu Sidebar Fidelidade: Correção no contraste de cor da fonte (#FFFFFF) ao selecionar a aba de Fidelidade no Painel Admin.
v3.13.0
26 de Agosto, 2026

Módulo de Cartão Fidelidade Digital Universal (Web, WhatsApp, Chat & App Flutter v1.4.0)

Substituição completa dos cartões físicos de papel por uma solução 100% digital e gamificada. Suporte a múltiplas campanhas simultâneas (ex: Cortes vs Impressos/Balcão), pontuação automática por agendamento concluído, carimbo manual em 1 clique direto no Chat de Atendimento ou no CRM, página pública da Carteira Digital VIP com confetes e vouchers de resgate.

Cartão Fidelidade Digital & Carteira VIP
  • Múltiplas Campanhas: Crie programas independentes para agendamentos, serviços gráficos, produtos de balcão com metas e prêmios customizados.
  • Automação WhatsApp: Envio imediato da barra de selos e link do cartão ao concluir agendamentos ou carimbar pelo chat.
  • Carteira Digital Web (fidelidade.html): Visual VIP de luxo com selos brilhantes, confetes ao atingir 100% da meta, código voucher de resgate (#PREMIO-XXXX) e botões diretos de agendamento e WhatsApp.
  • Aplicativo Flutter (v1.4.0): Gestão completa de clientes e campanhas de fidelidade com ação rápida de carimbar e resgatar no celular.
v3.12.0
25 de Agosto, 2026

Módulo "Meu Plano SaaS" no App Mobile Flutter (v1.3.0) & Renovação Direta via Pix e Boleto

Implementação da nova tela de gestão de assinatura "Meu Plano" no aplicativo Flutter. O gestor agora acompanha o vencimento da assinatura SaaS, visualiza o histórico completo de faturas e realiza pagamentos em segundos com Pix Copia e Cola / QR Code e Boleto Bancário diretamente pelo celular.

Assinatura SaaS & Pagamentos no App Mobile
  • Tela "Meu Plano" no Menu Lateral: Exibição do plano ativo, valor da mensalidade, data de vencimento e contador regressivo de dias restantes.
  • Pagamento Pix em 1 Toque: Geração de QR Code e Pix Copia e Cola instantâneo com botão de cópia rápida para pagamento em qualquer app de banco.
  • Histórico de Faturas & Boleto: Consulta de todas as faturas geradas, linha digitável e abertura do boleto em PDF.
v3.11.0
25 de Agosto, 2026

Sincronização Total com App Mobile Flutter (v1.2.0), Ocupação de Grade, Status de Pagamento & Lembretes

Expansão da API de Gestão Mobile (/f3-agenda/v1) e atualização completa do aplicativo Flutter. O app agora usufrui de faixas de horário inteligentes (14:00 → 14:30), composição de tempo com buffer em cards dedicados, identificação visual de pagamentos online (Mercado Pago/Pix) e status de envio dos lembretes automáticos de WhatsApp.

Aplicativo Flutter Mobile (v1.2.0) & API de Gestão
  • Faixa Horária & Ocupação na Listagem: Cards do app mobile com visualização inteligente de início ➔ término e badge de minutos reais consumidos na agenda (ex: ⏱️ 45m).
  • Card de Composição do Tempo no BottomSheet: Extrato de detalhes com visualização limpa de tempo de atendimento, buffer de higienização e horário exato de liberação.
  • Badges de Pagamento & WhatsApp: Identificação instantânea de agendamentos pagos online via Mercado Pago ou a receber presencialmente, além do status do lembrete WhatsApp.
v3.10.0
25 de Agosto, 2026

Otimização Visual no Cadastro de Profissionais & Foco Total na Escala Diária Personalizada

Limpeza visual na interface de gerenciamento de equipe. Os campos legados e redundantes de horário padrão foram preservados de forma oculta no DOM para assegurar 100% de compatibilidade, deixando o modal focado e direto na configuração dos dias de atendimento e na Escala Diária com horários e slots individuais por dia da semana.

Módulo de Profissionais & Usabilidade
  • Modal de Profissional Clean e Objetivo: Ocultação dos inputs legados do topo, eliminando duplicidade de configurações e garantindo que o gestor veja exatamente a Escala Diária ativa.
  • Escala Diária em Destaque: Título e grade de dias da semana aprimorados para configuração clara de Início, Fim e Intervalo de Slots de cada dia trabalhado.
  • Compatibilidade Total: Manutenção transparente dos elementos no DOM para evitar qualquer erro de referência nula em scripts legados.
v3.9.9
25 de Agosto, 2026

Cálculo de Ocupação da Grade no Módulo de Serviços, Prévia em Tempo Real & Carregamento Resiliente

Expansão da inteligência de cálculo de ocupação para a gestão de serviços. A tabela de serviços exibe os minutos bloqueados na agenda (duração + buffer) e o modal de cadastro/edição calcula instantaneamente a ocupação real à medida que o usuário digita a duração. Inclui inicialização resiliente do estado global contra falhas de renderização.

Gestão de Serviços & Prévia de Grade
  • Ocupação Real na Coluna Duração: Exibição do tempo de atendimento acompanhado do badge de bloqueio total (ex: 30 min · Grade: 45 min (+15m buf)).
  • Prévia Dinâmica no Cadastro de Serviço: Cálculo instantâneo no modal ao digitar a duração do serviço, somando automaticamente o intervalo da empresa.
  • Carregamento Seguro de Dados: Inclusão de configsCache no ciclo inicial com fallbacks de try/catch, garantindo que profissionais e serviços nunca sumam da tela.
v3.9.8
25 de Agosto, 2026

Visibilidade de Ocupação Real da Grade (Serviço + Buffer), Faixa de Horário Inteligente & Composição do Tempo

Implementação da inteligência de cálculo de ocupação temporal na grade de agendamentos. A tabela de atendimentos e os modais agora exibem a faixa horária completa (início ➔ término) e a janela total de bloqueio com buffer/intervalo, informando com clareza o instante exato em que a agenda estará livre para o próximo cliente.

Gestão de Grade & Ocupação Temporal
  • Faixa Horária Inteligente na Tabela: Em vez de apenas o horário inicial, a lista exibe o intervalo de execução (ex: 12:00 → 12:30) e um badge detalhado com os minutos totais consumidos (ex: ⏱️ 45 min (Livre: 12:45)).
  • Card de Composição do Tempo nos Modais: Visualização interativa ao criar ou editar agendamentos, detalhando os minutos do serviço, o buffer de transição e o horário de liberação da agenda.
  • Cálculo Dinâmico no Backend: O endpoint /atendimentos agora cruza as durações dos serviços e as configurações de intervalo da empresa, entregando métricas prontas para o frontend.
v3.9.7
24 de Agosto, 2026

Auditoria Global de Agendamentos, Respostas de Áudio Gemini sem Cortes & Suporte Multimodal a Imagens e Figurinhas

Otimização do motor de Inteligência Artificial para eliminar cortes de respostas em mensagens de áudio, desativando o orçamento de raciocínio interno redundante e expandindo a janela de tokens. Suporte nativo à visão multimodal de imagens e figurinhas no Gemini, além de registro completo de auditoria cronológica para agendamentos online e confirmações SIM/NÃO via WhatsApp.

Inteligência Artificial & Resolução de Áudio/Mídia
  • Eliminação de Respostas Cortadas pela Metade: Aumento do limite de tokens de geração para 2048 e desativação do Thinking Budget no Gemini 2.5/3.x, garantindo que respostas de áudio sejam entregues com rapidez, completude e pontuação final perfeita.
  • Visão Multimodal de Imagens & Figurinhas: O Gemini agora analisa fotos e figurinhas enviadas pelo WhatsApp, respondendo com cordialidade a saudações ou direcionando pedidos visuais conforme as diretrizes do System Prompt.
  • Fallback Resiliente de Geração: Extração multi-partes que ignora blocos de pensamento interno e retentativa automática caso o provedor rejeite configurações específicas.
Auditoria & Rastreabilidade 360°
  • Registro de Agendamentos Criados (`agendamento_criado`): Todas as reservas feitas no link público agora constam imediatamente na "Auditoria do Bot" e na "Auditoria Global do Servidor".
  • Auditoria de Confirmações WhatsApp: Registro instantâneo de disparos de confirmação SIM/NÃO e das respostas dos clientes ("Sim" ➔ `agendamento_confirmado` / "Não" ➔ `agendamento_cancelado`).
v3.9.6
22 de Agosto, 2026

Métricas de Atendimento (SLA) com Precisão Cirúrgica, Notificação WhatsApp Mercado Pago & Melhorias no Monitor de Chats

Implementação da arquitetura simétrica de timestamps dedicados (`entrou_fila_em`, `assumido_em`, `finalizado_em`) com migração de banco automática, eliminando distorções em clientes recorrentes e calculando o Tempo Médio na Fila e a Duração do Atendimento com exatidão matemática. Inclui disparo automático de mensagem WhatsApp após aprovação no Mercado Pago e botão de visualização em agendamentos fora do horário.

Métricas do Bot & Qualidade de Atendimento (SLA)
  • Timestamp Dedicado de Entrada na Fila (`entrou_fila_em`): Nova coluna criada via migração automática para registrar o instante exato em que o cliente solicita atendimento humano em qualquer caminho (transbordo por menus, gatilhos de frase, retorno pós-expediente ou anti-loop).
  • Cálculo Simétrico e Preciso de Filas: A métrica de Tempo Médio na Fila agora avalia exclusivamente `entrou_fila_em ➔ assumido_em` e a Duração Média avalia `assumido_em ➔ finalizado_em`, sem contaminações de datas de contatos antigos.
  • Isolamento Total por Sessão: Ao iniciar uma nova conversa após um atendimento anterior ser encerrado, os timestamps são renovados, garantindo que cada atendimento tenha seu histórico limpo e individualizado.
  • Diferenciação de Atendimento Proativo: Atendimentos assumidos diretamente no status "Conversando com o Robô" exibem `–` na fila (pois o cliente não esperou) e computam apenas o tempo de conversa humana.
  • Interface com Tratamento Gracioso de Valores Nulos: A tabela detalhada exibe `–` com tooltips explicativos ao invés de zeros enganosos para atendimentos puramente por robô.
Pagamentos & Monitor de Chats
  • Confirmação WhatsApp Automática no Mercado Pago: O webhook do Mercado Pago agora despacha imediatamente uma mensagem formatada de confirmação no WhatsApp do cliente assim que o pagamento Pix/Cartão é aprovado.
  • Botão "Ver" em Agendados (Fora do Horário): Adicionado o botão de visualização rápida da conversa ao lado de "Assumir" na tabela de contatos noturnos/fora do expediente, padronizando a experiência do painel de monitoramento.
v3.9.5
20 de Agosto, 2026

Engine de IA Multi-Provedor (Google Gemini API, Groq & OpenAI), Atendimento Nativo a Voz & Navegação Livre de Menus

Evolução da inteligência artificial do sistema com suporte oficial ao Google Gemini API (endpoint `v1beta`), escuta e processamento nativo de mensagens de voz/áudio no WhatsApp, motor de Fallback Automático (Redundância de IA), consulta dinâmica de modelos ativos no Google AI Studio e reset inteligente do contador durante a navegação nos menus da empresa.

Inteligência Artificial & Atendimento por Voz
  • Atendimento Nativo a Mensagens de Voz (Google Gemini API): O Gemini agora recebe, escuta e interpreta arquivos de áudio (.ogg/.opus) enviados pelos clientes no WhatsApp real ou simulador, respondendo diretamente em texto de forma inteligente.
  • Motor Multi-Provedor com Fallback Automático (Redundância): Se o provedor principal (ex: Groq) oscilar ou atingir limite de requisições, o sistema comuta em milissegundos para o segundo provedor (Gemini/OpenAI) sem deixar o WhatsApp fora do ar.
  • Detecção Dinâmica de Modelos Gemini: Botão no painel admin para consultar em tempo real os modelos ativos liberados para a chave no Google AI Studio com seleção em 1 clique.
  • Navegação Livre nos Menus da Empresa: Reset automático do contador de interações (`interacoes = 0`) sempre que o cliente escolhe qualquer opção válida do menu cadastrado pela empresa, permitindo navegação ilimitada.
Otimizações de Protocolo & Tolerância
  • Endpoint Oficial `v1beta` (Gemini): Garantida a compatibilidade total com o parâmetro `systemInstruction` e conteúdos multimodais no Google AI Studio.
  • Tolerância de Latência Otimizada (15s): Ajuste perfeito do limite de resposta (timeout em 15.000ms) para voz e texto, acionando o Fallback Redundante rapidamente em caso de indisponibilidade.
v3.9.0
20 de Agosto, 2026

Portal "Minhas Reservas" com OTP WhatsApp, Transbordo Inteligente (Regra dos 3) & Normalização de Telefones

Lançamento do Portal do Cliente "Minhas Reservas" com login sem senha via OTP no WhatsApp, histórico e exportação para a Google Agenda, motor de Transbordo Automático Inteligente para a Fila Humana com a Regra dos 3 (mídias ou textos sem seleção) e padronização completa do 9º dígito no Brasil.

Novos Recursos & Portal do Cliente
  • Portal "Minhas Reservas" no Agendamento Público: Os clientes finais agora possuem um portal dedicado no formulário público para consultar e cancelar seus agendamentos ativos ou passados.
  • Autenticação Segura via OTP no WhatsApp: Acesso simplificado enviando um código numérico de 4 dígitos (OTP) válido por 10 minutos direto no WhatsApp do cliente com sessão persistente de 30 dias.
  • Exportação para Google Agenda: Botão de 1 toque no portal do cliente para sincronizar agendamentos diretamente no aplicativo ou web do Google Agenda.
  • Transbordo Inteligente (Regra dos 3):** Detecção automática ao receber 3 mídias seguidas (áudios, fotos, vídeos, figurinhas ou documentos) ou 3 mensagens de texto sem seleção de menu, transferindo o cliente na hora para a Fila Humana com a mensagem oficial da empresa (`msg_fila_espera`).
Otimizações, Normalização & Correções
  • Normalização do 9º Dígito no Brasil: Padronização automatizada para telefones do Brasil com 12/13 dígitos (`55 + DDD + 9XXXX-XXXX` ➔ `55 + DDD + XXXX-XXXX`), garantindo 100% de compatibilidade e entrega nos servidores da Meta/Baileys.
  • Ícone Genérico para Serviços: Substituição do antigo ícone de tesoura pelo genérico `fa-bell-concierge` no formulário público para serviços sem foto cadastrada.
  • Suporte ao Modo Simulação: Preenchimento automático do código OTP em modo simulador (`?simulacao=true`) para testes instantâneos.
v3.8.0
19 de Agosto, 2026

Nova Engine de IA Groq, Envio de Documentos no Chat & Notificações Desktop Nativas

Atualização da arquitetura de inteligência artificial com novos modelos de raciocínio da Groq e soberania do System Prompt, suporte completo ao envio de arquivos e documentos (PDF, Word, Excel, ZIP) no chat com visualização aprimorada e notificações nativas da área de trabalho (Windows) com monitor global em segundo plano.

Novos Recursos & Produtividade
  • Envio de Documentos no Chat: O operador agora pode anexar e enviar arquivos diretamente pelo painel (PDFs, contratos, orçamentos, Word, planilhas Excel, arquivos ZIP e prints via Ctrl+V) até 25MB, entregues nativamente no WhatsApp do cliente.
  • Notificações Nativas do Windows / Desktop: Notificações da Área de Trabalho (Web Notification API) quando o navegador estiver minimizado ou em outra aba, com foco automático na conversa ao clicar no aviso.
  • Novos Modelos de IA Groq: Atualização completa para os modelos ativos qwen/qwen3.6-27b, openai/gpt-oss-120b e openai/gpt-oss-20b com seleção visual no painel.
  • Cards Elegantes de Download: Visualizador de histórico no chat atualizado com cartões estilizados de download identificando ícones específicos de cada extensão (.pdf, .docx, .xlsx, .zip).
Otimizações de IA, UX & Estabilidade
  • Soberania Total do System Prompt: Removidas injeções forçadas de texto, permitindo que a IA execute com 100% de fidelidade as instruções operacionais e regras de atendimento criadas pelo lojista.
  • Parâmetros de Raciocínio (Groq): Configuração de reasoning_effort: "none" para execução estrita de comandos e higienização automática de tags <think> para não expor pensamentos internos da IA.
  • Monitor de Chat Global e Permanente: O monitor de mensagens agora roda em segundo plano contínuo em todas as abas do painel (Dashboard, Clientes, Financeiro), garantindo avisos sonoros e visuais em qualquer menu.
  • Auto-Migração de Modelos no Boot: O script de inicialização do banco de dados agora migra automaticamente qualquer modelo legado para o novo padrão sem necessidade de intervenção manual.
v3.7.0
16 de Agosto, 2026

Notificações Inteligentes de Chat, Overlay de Suspensão com Autoatendimento & Baixa FIFO

Nova experiência de notificações em tempo real no chat com Toasts flutuantes e filtros inteligentes de mensagens, overlay de bloqueio com autoatendimento Pix/Boleto para empresas suspensas, baixas manuais organizadas em fila de vencimento (FIFO), recibos de pagamento em PDF/Impressão e bloqueio discreto de agendamentos.

Novos Recursos & Comunicação
  • Popups Toast Flutuantes no Chat: Notificações visuais em tempo real no canto inferior direito para mensagens recebidas do cliente, com prévia do texto, tag de status (*Fila*, *Atendimento Humano*) e botão direto para abrir a conversa.
  • Filtro Inteligente de Notificações: Notifica apenas em mensagens enviadas por clientes (ultimoFromMe = 0), silenciando respostas automáticas do Bot/IA e suprimindo popups quando o operador já está com aquele chat aberto na tela.
  • Overlay de Suspensão com Quitação Direta: Tela de bloqueio elegante para assinaturas suspensas com exibição da fatura em aberto e botões Pix/Boleto, permitindo que a empresa Quite e reative a conta autonomamente sem contatar suporte.
  • Emissão e Impressão de Recibos SaaS: Função de emissão e visualização de recibos de pagamento formatados em pop-up com layout profissional para impressão ou exportação em PDF.
Melhorias de Gestão & UX
  • Baixa Manual Inteligente (FIFO): A baixa manual do SuperAdmin agora quita automaticamente a fatura pendente mais antiga (respeitando a ordem de vencimento) e exibe um alerta transparente caso a empresa possua mais pendências em aberto.
  • Separação de KPIs no SuperAdmin: Dashboard do SuperAdmin atualizado com cards separados para empresas Vencidas vs. Suspensas, proporcionando visão financeira clara da base.
  • Bloqueio Discreto no Agendamento Público: Substituição de mensagens internas de cobrança ("Assinatura Inativa") por um aviso neutro e discreto de "Agendamento Indisponível" na página pública do cliente final.
  • Acesso Seguro para Pagamento de Suspensas: Middleware auth.js atualizado para permitir requisições de cobrança Pix/Boleto da API Efí Pay mesmo quando o tenant estiver em estado suspenso.
v3.6.0
13 de Agosto, 2026

Integração Real Efí Pay com Certificado .p12 (mTLS Pix) + Melhorias de Validação

Implementação da integração REST real com a API Pix Efí Pay usando OAuth2 + certificado digital .p12 (mTLS) via https.Agent nativo do Node.js, sem necessidade de SDK. Upload seguro do certificado direto pelo SuperAdmin com indicadores visuais de status por ambiente.

Novos Recursos
  • Upload de Certificado .p12: Campo de upload no SuperAdmin (Credenciais Efí Pay) separado por ambiente — Produção e Homologação — com badge de status indicando se o certificado está configurado, nome e tamanho do arquivo.
  • Integração mTLS Real (sem SDK): O efiService.js foi reescrito para usar https.Agent com pfx nativo do Node.js. Obtém access_token via OAuth2 e gera cobranças Pix (PUT /v2/cob/:txid) na API real da Efí Pay.
  • Endpoint de Upload Seguro: Nova rota POST /api/superadmin/config/efi/certificado com multer, restrita ao SuperAdmin, que salva o .p12 em certs/ e registra o caminho na saas_config.
  • Fallback Automático: Se o certificado ainda não foi enviado, o sistema continua operando com Pix simulado (QR Code de demonstração) sem interromper o fluxo.
Melhorias & Correções
  • Máscara de Telefone: Limitação de dígitos e validação de formato (XX) XXXXX-XXXX implementada nos formulários de agendamento púблico e no modal admin.
  • Sincronização de Faturas: Alterações de vencimento e valor no SuperAdmin agora sincronizam automaticamente a fatura pendente ativa em faturas_saas.
  • Layout da Tabela de Empresas: Espaçamentos e larguras de coluna ajustados no SuperAdmin para eliminar o scroll horizontal.
  • Cards de Navegação no SuperAdmin: Hub de módulos com cards de acesso rápido adicionado ao painel do SuperAdmin.
v3.5.0
13 de Agosto, 2026

Gestão de Mensalidades SaaS com Checkout Transparente Efí Pay (Pix & Boleto)

Implementação completa do sistema de cobranças recorrentes para empresas do SaaS integrado à API Efí Pay (antiga Gerencianet), oferecendo Pix QR Code/Copia e Cola instantâneo, Boleto Bancário PDF com código de barras, Webhook de autorrenovação e controle financeiro total no SuperAdmin.

Novos Recursos & Integrações
  • Checkout 100% Transparente Efí Pay: Geração instantânea de QR Code + Copia e Cola Pix e Boleto Bancário com PDF diretamente no painel do cliente, sem redirecionamentos.
  • Aba "Meu Plano" no Tenant: Visualização de status da assinatura, dias restantes até o vencimento, valor mensal e tabela com histórico de faturas.
  • Autonomia do SuperAdmin: Botão de "Baixar Manual" para renovação em +30 dias, alteração de vencimento/valor da mensalidade e alteração de status para ativo, vencido, suspenso ou isento.
  • Webhook Inteligente Efí Pay: Processamento automático de notificações de pagamento em /api/public/webhook-efi para estender a validade da empresa por 30 dias instantaneamente.
v3.4.1
12 de Agosto, 2026

Cadastro Manual de Novos Clientes no CRM

Adicionado o botão ➕ Novo Cliente no CRM para permitir o cadastro manual de clientes que entram em contato por telefone, presencialmente no balcão ou via redes sociais, com controle automático de duplicação por WhatsApp.

  • Cadastro Antecipado & Proteção Contra Duplicação: Permite pré-cadastrar clientes com a origem desejada. Se o cliente agendar pelo formulário online posteriormente, o cadastro prévio e sua origem são mantidos intactos!
v3.4.0
12 de Agosto, 2026

Mini-CRM de Clientes & Rastreio de Origem do Cadastro

Evolução da lista de Clientes para um Mini-CRM completo com tabela dedicada MySQL (clientes), rastreio de canais de entrada (Formulário Online, Robô WhatsApp, Instagram, Google Ads, Indicação, Balcão), cidade/bairro, notas internas da equipe e modal de edição do cadastro.

  • Modal de Edição de Cadastro: Atualização de nome, e-mail, canal de origem, localização e observações internas do cliente.
  • Métricas & Filtro por Origem: Indicadores de tamanho da base, ticket médio por cliente e maior canal de aquisição com filtro por origem.
v3.3.9
12 de Agosto, 2026

Truncamento Inteligente & Contador de Profissionais por Serviço

Otimização da coluna de Profissionais na tabela de Serviços para lidar elegantemente com equipes grandes ou serviços oferecidos por múltiplos médicos/especialistas. Exibe as 2 primeiras badges + contador (ex: +3 outros) ou 👥 Toda a equipe (5) com tooltip informativo ao passar o mouse.

  • Smart Truncation: Previne distorções na tabela mantendo o layout 100% compacto e responsivo.
v3.3.8
12 de Agosto, 2026

Exibição dos Nomes dos Profissionais no Catálogo de Serviços

Correção na tabela de Serviços onde os membros vinculados eram exibidos numericamente como #1, #2. A coluna agora renderiza o nome completo dos profissionais em badges verdes elegantes com ícone (ex: 👤 João Silva, 👤 Maria Oliveira).

  • Badges Nominativas de Profissionais: Resolução dos nomes reais no backend e frontend para o catálogo de serviços.
v3.3.7
12 de Agosto, 2026

Ícone Universal para o Catálogo de Serviços

Substituição do ícone de tesoura (específico para barbearia/salão) pelo ícone vetorial universal Concierge Bell (fa-bell-concierge) em todo o sistema (menu lateral do painel admin, cards do hub de módulos e no formulário público de agendamento).

  • Ícone de Serviços Universal: Adequação para qualquer segmento de negócio (consultorias, clínicas, barbearias, pet shops, estúdios, etc.).
v3.3.6
12 de Agosto, 2026

Campo Profissional Obrigatório em Novos Agendamentos e Edição

Definição da obrigatoriedade do campo Profissional (*) tanto no modal visual do Admin quanto no controlador backend. Essa alteração previne que agendamentos fiquem sem profissional atrelado acidentalmente.

  • Seleção Obrigatória de Profissional: Validação no front-end e back-end impedindo salvar agendamentos sem definir um membro da equipe.
v3.3.5
12 de Agosto, 2026

Badges Minimalistas & Ultra-Compactas para Pagamento e Status

Redesenho completo das tags visuais de Pagamento e Status na tabela de agendamentos. Redução de 50% na largura horizontal através de micro-badges com ícones vetoriais modernos (ex: MP (Pago), Pix (Pago), Local), mantendo o visual ultralimpo e minimalista.

  • Micro-Badges Minimalistas: Redução drástica da largura das colunas de status e meio de pagamento.
v3.3.4
12 de Agosto, 2026

Otimização da Tabela de Agendamentos & Eliminação do Scroll Horizontal

Redução do espaçamento interno das células (padding de 20px para 10px) e agrupamento inteligente das colunas Data / Hora e Cliente / WhatsApp. A tabela agora cabe 100% na largura da tela sem necessidade de rolagem horizontal em notebooks e monitores de qualquer resolução.

  • Tabela Compacta sem Scroll: Agrupamento visual das informações e padding reduzido para máximo aproveitamento de tela.
v3.3.3
12 de Agosto, 2026

Correção de Contraste nas Iniciais do Logo e Avatares no Modo Claro

Ajuste de estilos CSS garantindo que o texto das iniciais no .logo-badge e nos avatares de profissionais permaneça sempre em branco de alto contraste (#ffffff), mesmo no Modo Claro ou quando o estabelecimento seleciona uma cor primária personalizada para a marca.

  • Alto Contraste nas Iniciais: Fixação de color: #ffffff !important nos elementos com fundo de marca/accent.
v3.3.2
12 de Agosto, 2026

Feedback Detalhado na Tela & Registros no Log de Auditoria do Bot

Ajuste da verificação da tabela de agendamentos e exibição de alerta explicativo completo com quantidade exata de clientes afetados ao tentar excluir um serviço ou profissional. Além disso, todas as tentativas de exclusão bloqueadas passam a ser gravadas na Auditoria do Bot.

  • Auditoria & Mensagens Claras: Exibição do motivo exato do bloqueio em tela e registro de eventos servico_exclusao_bloqueada e funcionario_exclusao_bloqueada nos logs.
v3.3.1
12 de Agosto, 2026

Trava de Segurança & Feedback Inteligente ao Excluir Serviços e Profissionais

Implementação da Opção A de proteção no backend. O sistema agora verifica se existem agendamentos ativos ou pendentes em datas futuras antes de permitir a exclusão de qualquer serviço ou profissional, exibindo uma mensagem de alerta detalhada caso haja vínculos.

  • Proteção Contra Exclusão Acidental: Bloqueia a exclusão de serviços e profissionais com clientes marcados para hoje ou datas futuras, exigindo o reagendamento ou cancelamento prévio.
v3.3.0
12 de Agosto, 2026

Métricas Avançadas do Bot: Tempo Médio na Fila, Duração dos Atendimentos & Autonomia da IA

Nova suíte de métricas e inteligência operacional na aba "Métricas do Bot"! Agora com cálculo de tempo médio de espera na fila humana, tempo médio de duração dos atendimentos, taxa de resoluções autônomas pela IA/Robô e tabela detalhada por protocolo.

  • Tempo Médio na Fila: Mede o tempo exato decorrido desde a solicitação do cliente até o operador clicar em "Assumir Chat".
  • Duração do Atendimento: Monitora o tempo total gasto pelos atendentes para resolver e encerrar cada protocolo.
  • Taxa de Autonomia da IA: Percentual de atendimentos finalizados 100% pelo robô/IA sem necessidade de transbordo humano.
v3.2.3
12 de Agosto, 2026

Proteção de Dados & Atualizações SQL Dinâmicas entre Formulários de Configuração

Implementação de updates dinâmicos e parciais no backend (`PUT /configs` e `PUT /bot/config`), garantindo que a gravação das configurações gerais da loja (Pix/Mercado Pago) preserve 100% intactos os horários customizados (Sábado) e as mensagens do robô no banco de dados.

  • Persistência Garantida: Salvamento isolado e não-destrutivo por aba. A alteração de parâmetros na aba Agenda nunca mais sobrescreverá ou resetará o expediente de sábado e as mensagens de contexto do bot.
v3.2.2
12 de Agosto, 2026

Ajuste de Contraste e Fundo Limpo para Campos (Inputs/Selects) no Modo Claro

Substituição da transparência fixa antiga `rgba(0,0,0,0.25)` nos campos de entrada e seleção pela variável dinâmica `var(--bg-input)`, garantindo fundos brancos limpos `#ffffff` e bordas refinadas `#cbd5e1` no tema Clean Light.

  • Inputs & Selects Limpos: Removida a tonalidade acinzentada (`#ACACAC`) dos campos no modo claro. Os formulários e filtros agora têm contraste perfeito e fundo cristalino.
v3.2.1
12 de Agosto, 2026

Cards Financeiros e KPIs com Design Ultra-Minimalista & Tipografia Refinada

Refatoração visual dos cards de resumo financeiro e estatísticas do Dashboard e da aba Financeiro. Substituição de ícones volumosos por cabeçalhos limpos com mini-ícones e valores com fonte Plus Jakarta Sans de alto impacto.

  • Design Minimalista de KPIs: Rótulos em caixa alta suave (uppercase tracking), mini-ícones elegantes e valores numéricos em destaque com tipografia moderna de alta legibilidade.
v3.2.0
12 de Agosto, 2026

Redesign UX/UI de Classe Mundial: Hub de Cards no Dashboard, Mini-Sidebar Recolhível & Temas Clean/Dark OLED

Grande atualização de experiência do usuário! Adicionada a nova fonte Plus Jakarta Sans, alternador de temas (Clean Light ☀️ e Dark OLED 🌙) com salvamento automático, Mini-Sidebar recolhível ☰ e o Hub Central de Módulos em cards interativos no Dashboard.

  • Motor de Temas Duplo (Clean & Dark OLED): Alternância instantânea no cabeçalho entre o modo Clean Light e o modo escuro de alto contraste Dark OLED (Obsidian `#0b0f17`), salvando a preferência no navegador.
  • Hub Central de Módulos em Cards: Dashboard expandido com cartões interativos de acesso rápido para Agenda, Chats WhatsApp, Financeiro, Clientes, Profissionais e Serviços.
  • Sidebar Recolhível (Mini-Sidebar): Menu lateral expansível/recolhível via botão ☰, ampliando o espaço útil de tela para tabelas e conversas do chat.
v3.1.2
12 de Agosto, 2026

Redirecionamento Limpo e Inteligente no Retorno/Falha de Pagamento do Mercado Pago

Substituição da dependência de `history.go(-2)` por links limpos e diretos apontando para a página de agendamentos do estabelecimento (`/agendar.html?s=slug`), evitando loops de redirecionamento no Mercado Pago Sandbox e Produção.

  • Navegação Limpa Pós-Pagamento: Botões da tela de confirmação/falha agora conduzem o usuário diretamente para a landing de agendamentos da empresa, sem recarregar históricos expirados do gateway de pagamento.
v3.1.1
11 de Agosto, 2026

Correção de Protocolo HTTPS & Proxy para Checkout do Mercado Pago em Produção (Hostinger)

Adicionada a configuração `trust proxy` no Express e normalização forçada para HTTPS nas URLs de retorno e webhook do Mercado Pago, solucionando o erro 500 no auto_return da Hostinger.

  • Garantia de HTTPS em Produção: As URLs de retorno (back_urls.success) e notificação (notification_url) da API de preferências do Mercado Pago agora são geradas com protocolo seguro https:// em servidores sob proxy reverso.
v3.1.0
11 de Agosto, 2026

Correção Definitiva de Imagens Duplicadas no Chat do Painel Operador (Anexos & Ctrl+V)

Implementada a trava de controle de log `skipLog: true` no método de envio de mídias do adaptador WhatsApp (`sendImage`), garantindo registro único no banco de dados e eliminando imagens duplicadas no chat do painel.

  • Eliminação de Imagens Duplicadas no Painel: Ajustado o parâmetro { skipLog: true } na rota de envio de imagens do atendente humano. O chat agora exibe apenas 1 mídia única para cada anexo ou print colado via Ctrl+V.
v3.0.0
11 de Agosto, 2026

Módulo Dedicado "Financeiro & Relatórios Detalhados" com Filtros Customizados, Gráficos por Método e Exportação em CSV

Lançamento do grande marco v3.0.0! Nova aba inteira no painel administrativo dedicada ao controle financeiro avançado. Permite filtrar qualquer período por data, forma de pagamento, status e profissional, com exportação de dados em CSV.

  • Aba Exclusiva "Financeiro & Relatórios": Nova seção no menu lateral de Gestão de Agenda para acompanhamento de faturamento do negócio.
  • Filtros Avançados por Período e Profissional: Selecione qualquer intervalo de datas (Data Início / Data Fim), forma de pagamento (No Local, Pix, Mercado Pago), status e profissional responsável.
  • Distribuição por Método de Pagamento: Cards de progresso visual exibindo o percentual e valor faturado em cada meio de pagamento (Pix Antecipado, Mercado Pago, No Local).
  • Exportação em CSV com 1 Clique: Exporte todo o relatório filtrado diretamente para arquivos Excel/CSV para contabilidade e auditoria.
v2.9.0
11 de Agosto, 2026

Dashboard Analítico Expandido: Faturamento Semanal/Mensal, Top Serviços & Desempenho por Profissional

Transformamos o Dashboard do Admin em uma central completa de gestão financeira e operacional. Agora o dono do estabelecimento acompanha os indicadores em tempo real com novos cards estatísticos e tabelas analíticas.

  • KPIs Financeiros Expandidos: Novos cards para Faturamento Semanal (R$), Faturamento Mensal (R$) e Atendimentos no Mês ao lado dos indicadores diários de faturamento e agendamentos.
  • Top Serviços Mais Lucrativos do Mês: Tabela ranking mostrando a quantidade de vendas e a receita gerada pelos principais serviços do estabelecimento.
  • Desempenho por Profissional: Relatório visual com o volume de atendimentos e faturamento individual de cada profissional no mês corrente.
v2.8.0
11 de Agosto, 2026

Novo Modal "Agendamentos do Dia", Cards de Calendário Padronizados & Filtro Dinâmico de Profissionais por Serviço

Solução definitiva para grandes volumes de agendamentos diários. Agora o calendário mensal possui altura fixa padronizada com badges de resumo, e qualquer clique no dia abre a lista diária completa com ações de edição e confirmação com 1 clique.

  • Novo Modal "Agendamentos do Dia": Ao clicar em qualquer área do card no calendário mensal, abre-se uma janela com a lista completa dos agendamentos daquela data (Horário, Cliente, Serviço, Profissional, Pagamento e Status), além do botão destacado "+ Novo Agendamento nesta Data".
  • Cards de Calendário com Tamanho Fixo e Limpo: O calendário mensal não mais deforma ou fica gigante quando há muitos agendamentos. Cada célula exibe badges resumidos (🟢 Confirmados, 🟡 Pendentes), eliminando cliques acidentais em formulários vazios.
  • Filtro Inteligente de Profissionais por Serviço: Ao selecionar um serviço no modal de agendamentos, o dropdown de profissionais exibe exclusivamente os profissionais qualificados/vinculados àquele serviço.
v2.7.0
11 de Agosto, 2026

Calendário Visual em Grade no Admin, Auditoria 360° em Todos os Módulos, Abas e Paginação no SuperAdmin & Lembretes WhatsApp

Esta versão marca um salto histórico no SaaS F3 Agenda. Implementamos o Calendário Visual em Grade no modal do Admin, Auditoria 360° conectada a todos os controllers (Profissionais, Serviços, Bloqueios, Configs e Empresas), Reestruturação do SuperAdmin em Abas com Filtros e Paginação, Robô de Lembretes no WhatsApp com Confirmação IA (Sim/Não) e Reciclagem de Tokens de API com 1 clique.

  • Calendário Visual em Grade no Modal Admin: Substituição completa do `` pelo mesmo calendário visual do frontend público. Os dias de expediente do profissional selecionado aparecem destacados em verde 🟢, e os dias de folga/passados aparecem desabilitados e opacos ⚪.
  • Sistema de Auditoria 360° por Módulos: Registros em tempo real no `bot_logs` cobrindo todas as ações: cadastro, edição e exclusão de Profissionais, Serviços (preços e tempo), Bloqueios de Agenda, Configurações Globais (Horários, Pix e Mercado Pago) e alterações no SuperAdmin.
  • Lembrete Automático via WhatsApp & Robô IA (Sim/Não): Varredura contínua no servidor que dispara lembretes via WhatsApp X horas antes do horário. O robô intercepta a resposta do cliente: "Sim" confirma a vaga automaticamente; "Não" libera a vaga para outros clientes; sem resposta mantém o agendamento reservado. Exibe indicador visual com sininho 🔔 na tabela do Admin.
  • Notificação de Remarcação de Atendimento: Disparo de aviso instantâneo no WhatsApp do cliente sempre que o Administrador altera a data, horário, profissional ou serviço de um agendamento no painel.
  • Painel SuperAdmin com Abas, Filtros e Paginação: Interface reestruturada em duas abas principais (Empresas Cadastradas vs Auditoria Global do Servidor), com filtros por empresa, por tipo de evento, busca por palavra-chave e paginação dinâmica (25 registros/página).
  • Reciclagem e Edição de Token de API: Botão de 1 clique (🔄) no SuperAdmin para regenerar o token da empresa imediatamente em caso de vazamento ou emergência, além de campo editável com gerador criptográfico no modal.
v2.6.0
11 de Agosto, 2026

Gestão de Pagamentos Estilo WooCommerce, Lembretes Automáticos via WhatsApp & Notificações de Remarcação

Nesta versão de grande porte, trouxemos um controle avançado de pagamentos para o Painel Admin, a ativação do robô de lembretes automáticos com IA e notificações de alteração de agendamento em tempo real.

  • Gestão Visual de Pagamentos (Estilo WooCommerce):** Nova coluna e modal no admin com badges coloridos (🟢 Pago, 🟡 Aguardando MP, 🔷 Pix, ⚪ No Local) exibindo o ID do comprovante do Mercado Pago (#123456).
  • Trava de Segurança Antifraude:** O status de pagamento de agendamentos feitos via Mercado Pago é travado contra edições manuais, sendo atualizado exclusivamente pelo Webhook oficial.
  • Lembretes Automáticos via WhatsApp com IA:** Serviço em background (`reminderService.js`) que varre e dispara lembretes X horas antes do atendimento com tags dinâmicas ({nome}, {servico}, {funcionario}, {data}, {hora}) e escuta respostas (Sim/Não) para confirmar ou cancelar vagas automaticamente. Indicador visual com sininho 🔔 na tabela.
  • Aviso de Remarcação ao Cliente:** Sempre que o administrador alterar Data, Horário, Profissional ou Serviço no painel, uma notificação formatada é enviada instantaneamente ao WhatsApp do cliente.
v2.5.9
09 de Agosto, 2026

Integração Online com Mercado Pago & Ocultação Automática de Pix

Nesta versão (Fase 2 dos Pagamentos), implementamos a funcionalidade completa de pagamentos online automatizados e melhoramos a experiência do Pix manual.

  • Checkout Mercado Pago: Clientes agora podem pagar online com Cartão de Crédito ou Pix dinâmico do Mercado Pago. O pagamento é detectado via Webhook e atualiza o agendamento no sistema automaticamente, sem depender de SDK (integração via API REST nativa).
  • Ocultação Inteligente do Pix: A opção "Pagar via Pix" (manual) no formulário público só é exibida ao cliente se a empresa tiver uma Chave Pix cadastrada nas configurações.
  • Sandbox do Mercado Pago: Administradores podem ativar o Modo Testes/Sandbox (usando credenciais TEST-...) para validar a integração de pagamentos sem usar dinheiro real.
v2.5.8
08 de Agosto, 2026

Nova Feature: Módulo de Cobranças e Pagamento via Pix

Adicionamos um fluxo completo para gerenciar pagamentos. Agora o cliente pode escolher pagar via Pix já no momento do agendamento, e o administrador pode enviar links e chaves Pix rapidamente pelo chat do sistema.

  • Pagamento no Agendamento: Clientes agora têm a opção de escolher "Pagar no local" ou "Pagar via Pix" na Etapa 5 do agendamento, com a chave Pix do estabelecimento embutida no checkout.
  • Modal de Pagamento no Chat: Novo botão (💳) na barra do chat para o atendente enviar chaves Pix (já cadastradas) ou gerar um Link de Pagamento na hora durante a conversa.
  • Configuração Centralizada: Novo bloco de "Chave Pix para Cobranças" nas configurações do painel admin.
v2.5.7
08 de Agosto, 2026

Correção: API de Bloqueios para Aplicativo Mobile

Correção no endpoint da API utilizado pelo aplicativo de gestão móvel, que não estava exibindo os bloqueios de agenda cadastrados no sistema.

  • Sincronização de Banco de Dados: A rota /f3-agenda/v1/bloqueios foi atualizada para consultar corretamente as colunas atualizadas do banco de dados (data_inicio e data_fim).
  • Formatação de Datas: As datas enviadas para o aplicativo agora são pré-formatadas para o padrão YYYY-MM-DD no backend, garantindo que o aplicativo processe e exiba os bloqueios corretamente na tela de calendário.
v2.5.6
07 de Agosto, 2026

Correção: Normalização do 9º Dígito no Agendamento

Correção de compatibilidade com o WhatsApp Brasil: o número de telefone digitado no agendamento público é agora normalizado removendo o 9º dígito, garantindo que a mensagem de confirmação seja entregue imediatamente ao cliente, sem necessidade de ele falar primeiro.

  • Entrega Imediata da Confirmação: O WhatsApp Brasil resolve números sem o 9º dígito internamente. Agora o sistema salva o número já no formato correto, garantindo consistência entre o banco de dados e o Baileys.
  • Sem Duplicata de Clientes: Antes, um cliente podia aparecer duas vezes no painel (com e sem o 9). Agora ambos os fluxos — agendamento público e contato via WhatsApp — usam o mesmo formato de número.
v2.5.5
07 de Agosto, 2026

Confirmação de Agendamento via WhatsApp (Modo Produção)

Agora, quando um cliente realiza um agendamento pela página pública, ele recebe automaticamente uma mensagem de confirmação SIM/NÃO no seu próprio WhatsApp.

  • Mensagem Real de Confirmação: Imediatamente após o agendamento, o sistema envia uma mensagem para o WhatsApp do cliente pedindo que ele confirme com Sim ou cancele com Não.
  • Cadastro Automático no Painel: Clientes novos que agendaram pelo site já aparecem automaticamente no painel de atendimento antes mesmo de enviarem qualquer mensagem no WhatsApp.
  • Segurança Total: A mensagem só é enviada se o WhatsApp estiver conectado. Se não estiver, o agendamento é salvo normalmente e um aviso é registrado nos logs.
v2.5.4
07 de Agosto, 2026

Reconexão Automática do WhatsApp após Restart

Correção crítica de infraestrutura: o sistema agora reconecta automaticamente todas as contas do WhatsApp após um reinicio do servidor, eliminando a necessidade de intervenção manual.

  • Reconexão Automática: Após um reinicio pela hospedagem (sinal SIGTERM), o servidor agora sobe e reconecta automaticamente todas as sessões ativas do WhatsApp sem nenhuma ação manual.
  • Desconexão Manual Preservada: O botão "Desconectar" no painel continua funcionando exatamente igual, encerrando a sessão e gravando a inatividade no banco como esperado.
  • Pronto para Escalar: A solução funciona para qualquer quantidade de empresas cadastradas (ex.: 200+), reconectando todas simultaneamente e de forma segura após o boot.
v2.5.3
04 de Agosto, 2026

Nova Modal de Busca de Histórico Completo

Implementada uma nova ferramenta para buscar de forma ilimitada os clientes que já tiveram o atendimento encerrado, sem travar o painel.

  • Carregamento Dinâmico Inteligente: Ao clicar no botão de "Buscar Completo", o sistema carrega os últimos contatos automaticamente, pulando aqueles que já estão visíveis na tela inicial.
  • Busca Refinada no Banco: Agora você pode buscar clientes antigos por fragmentos do Nome ou Telefone, mantendo a capacidade de "Ver" a conversa antiga ou "Reabrir" o protocolo.
v2.5.2
04 de Agosto, 2026

Correção do Efeito "Fantasma" no Histórico

Ajuste de interface (UI) no painel de atendimento para melhorar a experiência ao alternar rapidamente entre conversas.

  • Fim do atraso visual: Ao trocar de cliente no chat, o histórico anterior é limpado instantaneamente da tela e substituído por um aviso de carregamento até que o servidor responda, evitando que conversas se misturem visualmente.
v2.5.1
04 de Agosto, 2026

Suporte Nativo a Emojis e Correção de Histórico

Nesta atualização focamos em corrigir um problema crítico de renderização de histórico de chat provocado pela incompatibilidade do banco de dados antigo com emojis complexos.

  • Correção do erro "Unexpected token 'y'": Corrigido o bug que travava o painel e impedia o carregamento do histórico da conversa após o envio de emojis de 4 bytes (como 👍).
  • Migração automática para UTF8MB4: O sistema agora aplica `charset: 'utf8mb4'` no pool de conexões do MySQL e converte tabelas principais para `utf8mb4_unicode_ci` automaticamente para suportar emojis sem corrupção.
v2.5.0
01 de Agosto, 2026

Grade Semanal de Horários & Proteções Avançadas

Novas Funcionalidades
  • Grade de Horários por Dia da Semana: Configure horários de funcionamento específicos para cada dia (Segunda a Domingo) com o novo painel interativo.
  • Atalho "Copiar Segunda": Reclique e replique os horários de Segunda para todos os dias úteis da semana com um único clique.
  • Gestão Visual de Feriados: Adicione exceções e feriados por data com nome descritivo e exclusão visual sem precisar digitar JSON.
  • Transbordo Inteligente de Abertura: Clientes que deixaram mensagem à noite e responderam de manhã são transferidos direto para a Fila Humana Ativa assim que o expediente abre.
  • Proteção Anti-Envio Duplo: Trava de envio no chat e limpeza otimista instantânea do campo de texto ao pressionar Enter ou clicar em enviar.
Estabilidade & Conectividade
  • Resolução Dinâmica de LIDs: Correção e vinculo transparente de contatos temporários (@lid) com seu número real de WhatsApp.
  • Auto-Arquivamento de Contexto: Limpeza automática de conversas noturnas abandonadas com base no tempo de reativação configurado.
v2.4.0
28 de Julho, 2026

Fila de Agendados Noturnos & Notificações

Novas Funcionalidades
  • Fila de Agendados Noturnos: Clientes que chamam fora do horário deixam o resumo do assunto gravado e aguardam na ordem FIFO de chegada.
  • Alerta Sonoro & Banner Amber: Som de notificação e banner de aviso no painel ao receber o primeiro lead noturno do dia.
  • Confirmação de Contexto Configurável: Mensagem personalizada enviada ao cliente assim que ele digita o assunto do atendimento.
v2.3.0
15 de Julho, 2026

Inteligência Artificial & Simulador Multi-Tenant

Novas Funcionalidades
  • Integração com IA Groq (LLaMA 3.1): Respostas inteligentes humanizadas em tempo real para dúvidas frequentes do robô.
  • Simulador de Chatbot: Ambiente de testes interativo no painel para simular diálogos de clientes sem gastar dados no WhatsApp real.
  • Suporte a Envio de Imagens & Mídias: Envio e recebimento de imagens, figurinhas e áudios com player de áudio direto no chat.
v2.0.0
01 de Julho, 2026

Lançamento da Plataforma SaaS F3 Agenda

Funcionalidades Principais
  • Página de Agendamento Online Pública: Link exclusivo com slug personalizado da empresa para clientes agendarem serviços.
  • Gestão Multi-Profissionais & Serviços: Configuração de duração, preços, fotos e escalas individuais de profissionais.
  • Motor Anti-Overbooking: Cálculo automático de horários disponíveis considerando intervalos e buffers entre clientes.