Updatev1.35.1
Nova versão
[v1.35.1] - 05/10/2026 🐛
dncarbonell/fzap:v1.35.1
dncarbonell/fzap:latest
🐛 Tokens de instância, mídia Chatme, prioridade do tempo real, política de status no Chatwoot e comparativo FZAP × Meta
🔑 Tokens de instância
-
Rotação e personalização de tokens
- Agora é possível consultar o impacto da troca de token antes de realizá-la.
- O novo token pode ser gerado automaticamente ou definido manualmente.
- É possível solicitar a atualização automática da integração com o Chatwoot durante a troca.
- O token antigo deixa de autenticar imediatamente, sem desconectar a sessão do WhatsApp.
- Integrações externas que utilizam o token precisam passar a utilizar a nova credencial.
-
Mais segurança durante a troca
- O sistema detecta tokens inválidos, duplicados ou trocas concorrentes.
- O dashboard apresenta um resumo do impacto e solicita confirmação pelo nome da instância.
💬 Chatwoot
-
Política de status unificada
- WhatsApp tradicional e Cloud API passam a seguir as mesmas regras de abertura e reabertura de conversas.
- Marcar como pendente define o status inicial de novas conversas, mas não controla mais a reabertura.
- Reabrir como pendente passa a atuar somente quando uma mensagem recebida reutiliza uma conversa resolvida.
-
Novo controle para envios externos
- Abrir a conversa utiliza o comportamento tradicional e abre a conversa ao enviar.
- Manter o status utiliza Agent Bot para evitar alterações desnecessárias no status.
- Quando uma conversa resolvida é reutilizada pelo Agent Bot, o envio pode reabri-la como
pending. - Sem Agent Bot, envios externos seguem utilizando o usuário normal e podem reabrir a conversa como
open.
-
Agent Bot configurável
- O token pode ser configurado diretamente na conexão com o Chatwoot.
- O painel informa se o token está disponível e válido.
- Manter o status fica indisponível quando não existe um token utilizável.
- Em caso de rejeição do Agent Bot durante o envio, o sistema realiza fallback automático para o usuário normal.
-
Melhor compatibilidade de áudio
- A transcrição passa a utilizar a extensão correspondente ao formato real do arquivo.
- Formatos como AAC e AMR são convertidos automaticamente para OGG Opus quando necessário.
📦 Mídia Chatme
-
Novo modo de entrega
chatme- Instâncias vinculadas ao Chatme podem utilizar diretamente a cópia de mídia armazenada nele.
- Esse modo dispensa o upload para S3 no fluxo de entrega compatível.
- Também permite recuperar mídias que já não estejam mais disponíveis diretamente no WhatsApp.
-
Adoção automática em instalações elegíveis
- Instâncias vinculadas ao Chatme, sem S3 próprio e ainda utilizando
base64, podem migrar automaticamente parachatme. - Configurações existentes de
s3oubothcontinuam preservadas. - Ao remover o vínculo com o Chatme, a entrega retorna para
base64.
- Instâncias vinculadas ao Chatme, sem S3 próprio e ainda utilizando
-
Mudanças aplicadas imediatamente
- Alterações no modo de mídia passam a ser consideradas imediatamente nas novas mensagens recebidas.
-
Uso de disco mais resiliente
- O limite de cache passa a funcionar como referência para limpeza, sem bloquear downloads desnecessariamente.
- Mídias antigas são removidas automaticamente quando necessário.
- O processamento só é recusado quando realmente não existe espaço físico suficiente.
-
S3 mais eficiente
- Verificações completas do armazenamento deixam de ocorrer no caminho crítico dos uploads.
- Isso reduz bloqueios temporários que poderiam atrasar a entrega de novas mídias.
- Uploads interrompidos também passam a ser verificados de forma mais eficiente.
-
Reenvio de mensagens próprias corrigido
- Mensagens próprias reenviadas deixam de receber incorretamente o selo Encaminhada.
- O contexto necessário para o roteamento correto das mídias é preservado.
⚡ Prioridade de tempo real
-
Mensagens novas têm prioridade no boot
- Durante a inicialização, tarefas como histórico, campanhas, importações e sincronizações ficam em segundo plano enquanto as instâncias prioritárias são restauradas.
- Mensagens e mídias recebidas em tempo real não precisam aguardar esse processo.
-
Processamento de mídia mais responsivo
- Trabalhos de mídia começam a ser processados imediatamente quando chegam.
- Entradas em tempo real têm prioridade sobre processamento histórico.
- O histórico de saída passa a utilizar no máximo dois workers simultâneos.
-
Mais capacidade para mensagens atuais
- O sistema pode reservar capacidade extra para mídias em tempo real mesmo durante períodos de maior carga.
📊 Tráfego pago
-
Comparativo diário FZAP × Meta
- O painel passa a comparar contatos únicos identificados pelo FZAP com as conversas registradas pela Meta.
- São exibidos os totais de cada origem e o percentual de cobertura.
- O comparativo também informa a origem dos dados e o fuso da conta Meta quando disponível.
-
Conversas da Meta por campanha, conjunto e anúncio
- Os dados de conversas passam a aparecer junto às métricas já exibidas nas tabelas de tráfego pago.
- Quando uma conta de anúncios está configurada, a sincronização também consegue considerar anúncios que ainda não possuem leads capturados no FZAP.
-
Diferenças de métricas mais transparentes
- FZAP e Meta utilizam critérios diferentes de contagem.
- Diferenças de fuso horário também podem fazer os números variarem entre os dias.
- Por isso, uma divergência isolada não significa necessariamente falha na captura.
-
Recuperação de leads ausentes
- O sistema pode procurar no histórico contatos que não foram corretamente associados anteriormente.
- Antes de recuperar, é possível realizar uma simulação para verificar quantos registros seriam encontrados.
- A recuperação acontece somente quando existe uma associação segura com um único anúncio conhecido.
- O timestamp original é preservado.
- Leads recuperados não geram novamente webhook ou CAPI retroativos.
-
Funil de captação simplificado
- A taxa de identificação passa a ser exibida corretamente como percentual.
- A etapa técnica Campanha identificada foi removida do funil principal.
🚨 Cloud API
-
Detecção automática de bloqueio da conta
- Falhas de entrega associadas a bloqueio, limitação ou problemas de saúde da conta passam a ser identificadas automaticamente.
- O estado fica disponível no diagnóstico da instância.
- Mudanças entre bloqueado e liberado podem gerar notificações administrativas.
-
Melhor detalhamento das falhas
- Os motivos informados pela Meta passam a ser exibidos com mais detalhes.
- Falhas específicas de destinatários não são confundidas com bloqueios gerais da conta.
🖥️ Dashboard e experiência de uso
-
Listagem de instâncias mais eficiente
- Dados de Chatwoot, Chatme, S3, webhooks e Cloud API passam a ser carregados em lote.
- Isso reduz o volume de consultas em instalações com muitas instâncias.
-
Paginação no painel administrativo
- A listagem de instâncias passa a ser paginada, melhorando desempenho e navegação em ambientes maiores.
-
Tours ampliados
- Os guias de conexão, QR Code, Chatwoot, MCP, header e convite White Label foram ampliados.
- O progresso parcial pode ser retomado no mesmo navegador e escopo de acesso.
-
Atualização da integração com o WhatsApp
- A biblioteca de conexão foi atualizada com melhorias no protocolo e na comunicação em tempo real.
- Foram incluídas correções para situações em que frames de conexão chegavam divididos em múltiplos pacotes.