[email protected]

Release Notes - TranscreveZAP v2.3.2 & v2.3.3

🔄 Atualizações Importantes

Seleção de Plataforma LLM (v2.3.3):

• Agora você pode escolher entre os provedores GROQ e OpenAI para o processamento de transcrições e resumos.
• Configuração disponível na interface administrativa, permitindo alternância dinâmica.
• Melhorias na validação de chaves para ambas as plataformas.

Sistema de Gerenciamento de Chaves GROQ (v2.3.2):

• Suporte a múltiplas chaves GROQ com rodízio automático.
• Introdução de sistema de penalidade temporária para chaves com falhas.
• Recuperação automática ao utilizar chaves alternativas.
• Logs detalhados para monitoramento do ciclo de vida das chaves.

---

🛠️ Melhorias Técnicas

• Handler dedicado para requisições GROQ: Melhor controle e otimização de chamadas via groq_handler.py.
• Validação de respostas LLM: Garantia de respostas consistentes e resumo válido.
• Sistema de logs avançado:
  • Rastreamento detalhado das transcrições e resumos.
  • Monitoramento de qualidade de mensagens e eficiência de chaves.
• Integração de OpenAI: Suporte otimizado para integração com modelos GPT.

---

🐛 Correções

• Melhor tratamento de erros de conexão e timeouts em requisições longas.
• Correções no reuso de objetos FormData e serialização de MultiDict.

---

🚀 Instruções de Atualização

1. Atualize para a versão 2.3.3 ou latest utilizando o repositório oficial ou Docker.
2. Configure as chaves GROQ e/ou OpenAI na interface administrativa.
3. Teste transcrições para validar a configuração do provedor LLM.

[email protected]

TranscreveZAP v2.3.1 - Hub de Redirecionamento

🚀 Novo Recurso: Hub de Redirecionamento

O TranscreveZAP agora oferece um sistema robusto para redirecionamento de mensagens, permitindo que você encaminhe os webhooks da Evolution API para múltiplos destinos simultaneamente.

Principais Recursos

• Interface dedicada para gerenciamento de webhooks
• Redirecionamento sem alteração do payload original
• Monitoramento de saúde dos webhooks em tempo real
• Sistema de retry automático para reenvio de mensagens falhas
• Headers de rastreamento para identificação de origem (X-TranscreveZAP-Forward)
• Suporte a descrições personalizadas para cada webhook
• Limpeza automática de dados ao remover webhooks

Compatibilidade

• Mantém o payload da Evolution API intacto
• Suporta múltiplos endpoints simultaneamente
• Compatível com qualquer sistema que aceite webhooks via POST
• Preserva todos os dados originais da mensagem

[email protected]

🎉 TranscreveZAP v2.3 - Release Notes

🌟 Principais Novidades

🌍 Sistema Multi-idioma Avançado

O TranscreveZAP agora oferece um sistema multi-idioma robusto e flexível, com suporte a:

• Configuração manual de idioma por contato
• Detecção automática de idioma
• Tradução automática integrada
• Suporte para 16 idiomas principais

⏱️ Timestamps em Transcrições

Nova funcionalidade de timestamps que adiciona marcadores de tempo precisos em cada trecho da transcrição.

🔄 Sistema de Cache para Idiomas

Implementação de cache inteligente para otimizar a detecção e processamento de idiomas.

📋 Detalhamento das Funcionalidades

🌐 Gestão de Idiomas por Contato

Configuração Manual

1. Acesse o Manager > Configurações > Idiomas e Transcrição
2. Expanda "Adicionar Novo Contato"
3. Digite o número do contato (formato: 5521999999999)
4. Selecione o idioma desejado
5. Clique em "Adicionar Contato"

🔄 Detecção Automática de Idioma

Nova funcionalidade que detecta automaticamente o idioma do contato:

• Ativação via Manager > Configurações > Idiomas e Transcrição
• Analisa o primeiro áudio de cada contato
• Cache inteligente de 24 horas
• Funciona apenas em conversas privadas
• Mantém configuração global para grupos

⚡ Tradução Automática

Sistema inteligente de tradução que:

• Traduz automaticamente áudios recebidos para seu idioma principal
• Mantém o contexto e estilo original da mensagem
• Preserva formatações especiais (emojis, negrito, itálico)
• Otimizado para comunicação natural

⏱️ Sistema de Timestamps

Nova funcionalidade que adiciona marcadores de tempo:

• Formato [MM:SS] no início de cada trecho
• Ativação via Manager > Configurações > Idiomas e Transcrição
• Precisão de segundos
• Ideal para referência e navegação em áudios longos

Exemplo de Saída com Timestamps:

[00:00] Bom dia pessoal
[00:02] Hoje vamos falar sobre
[00:05] O novo sistema de timestamps

🔧 Configuração e Uso

Configuração de Idiomas

1. Configuração Global

   • Defina o idioma padrão do sistema
   • Acesse: Manager > Configurações > Configurações Gerais
   • Selecione o idioma principal em "Idioma para Transcrição e Resumo"

2. Configuração por Contato

   • Acesse: Manager > Configurações > Idiomas e Transcrição
   • Use "Adicionar Novo Contato" ou gerencie contatos existentes
   • Cada contato pode ter seu próprio idioma configurado

3. Detecção Automática

   • Ative/Desative a detecção automática
   • Configure o tempo de cache
   • Gerencie exceções e configurações manuais

Configuração de Timestamps

1. Acesse: Manager > Configurações > Idiomas e Transcrição
2. Localize a seção "Timestamps na Transcrição"
3. Use o toggle para ativar/desativar
4. As mudanças são aplicadas imediatamente

📊 Monitoramento e Estatísticas

Estatísticas de Idiomas

O sistema agora oferece estatísticas detalhadas:

• Total de transcrições por idioma
• Número de detecções automáticas
• Divisão entre mensagens enviadas/recebidas
• Histórico de uso por idioma

Visualização de Dados

• Gráficos de uso por idioma
• Distribuição de idiomas
• Estatísticas de tradução
• Performance do sistema

🐛 Correções de Bugs

• Corrigido problema de detecção de idioma em grupos
• Melhorada precisão da tradução automática
• Otimizado sistema de cache
• Corrigido tratamento de timeouts

🔐 Sistema Universal de Conexão Redis

Melhorias na Conectividade Redis

O TranscreveZAP agora oferece um sistema mais flexível de conexão com Redis:

• Suporte universal para Redis com ou sem autenticação
• Compatibilidade com instalações Redis existentes
• Sistema automático de detecção de credenciais
• Integração simplificada com diferentes ambientes

🔧 Configurações Flexíveis

Novas opções de configuração para Redis:

• Conexão sem autenticação (padrão)
• Suporte opcional para username/password
• Compatibilidade com Redis local ou remoto
• Configuração via variáveis de ambiente

Exemplos de Configuração:

1. Redis Básico (Sem Autenticação)

redis-transcrevezap:
    command: redis-server --port 6380 --appendonly yes

2. **Redis com Autenticação (Opcional)

redis-transcrevezap:
   command: redis-server --port 6380 --appendonly yes --user seuusuario on '>minhasenha' '~*' '+@all'

###🛠️ Compatibilidade Aprimorada

• Funciona com Redis 6+ (recomendado)
• Compatível com instalações Redis existentes
• Suporte para diferentes modos de deployment
• Integração facilitada com ambientes Docker

📝 Notas Adicionais

Recomendações de Uso

• Configure idiomas manualmente para contatos frequentes
• Use detecção automática como fallback
• Monitore estatísticas de uso
• Faça backups regulares das configurações

Limitações Conhecidas

• Detecção automática requer primeiro áudio
• Cache limitado a 24 horas
• Timestamps podem variar em áudios muito longos

🤝 Contribuição

Agradecemos feedback e contribuições! Reporte issues e sugira melhorias em nosso GitHub.

---

📞 Suporte

Para suporte adicional ou dúvidas:

• WhatsApp: Entre no GRUPO
• Email: [email protected]
• Site: impacte.ai

[email protected]

TranscreveZAP v2.2 - Release Notes

Novos Recursos

Personalização de Mensagens

• Cabeçalhos Customizáveis

• Personalização completa dos cabeçalhos de resumo e transcrição

• Interface intuitiva para configuração

• Preservação da formatação markdown

• Modos de Saída Flexíveis

• Resumo e Transcrição: Modo padrão com ambos os conteúdos

• Apenas Resumo: Envio exclusivo do resumo do áudio

• Apenas Transcrição: Envio da transcrição completa

• Modo Inteligente: Escolha automática baseada no tamanho do texto

• Configurações Avançadas

• Limite de caracteres configurável para modo inteligente

• Persistência das configurações via Redis

• Sistema de fallback para valores padrão

Interface Renovada

• Novo Layout em Tabs

• Chaves API: Gerenciamento completo de chaves GROQ

• Configurações Gerais: Idiomas e processamento

• Formatação de Mensagens: Personalização de saídas

• Melhorias de UX

• Navegação mais intuitiva

• Feedback visual aprimorado

• Organização otimizada das configurações

Melhorias Técnicas

Otimizações

• Sistema de rodízio de chaves GROQ aprimorado
• Gerenciamento de configurações via Redis otimizado
• Performance melhorada no processamento de áudios
• Estabilidade aumentada na geração de resumos

Benefícios

• Controle granular sobre formato das mensagens
• Economia inteligente de caracteres
• Personalização avançada para cada necessidade
• Experiência aprimorada para usuários finais

Requisitos do Sistema

• Docker v20.10+
• Redis v6.0+
• Python 3.10+

Guia de Atualização

Docker

# Pull da nova imagem
docker pull impacteai/transcrevezap:2.2

[email protected]

🌍 Suporte Multilíngue

• Transcrição e resumo em 10+ idiomas
• Mudança instantânea de idioma
• Interface intuitiva para seleção de idioma
• Mantém consistência entre transcrição e resumo

🔄 Sistema Inteligente de Rodízio de Chaves

• Suporte a múltiplas chaves GROQ
• Balanceamento automático de carga
• Maior redundância e disponibilidade
• Gestão simplificada de chaves via interface

[email protected]

What's Changed

• Implementado Interface Visual Streamlit no projeto
• Adicionado o uso de Redis como Banco de Dados
• Atualização da Stack Docker para ter a instalação de um redis próprio para a aplicação sem atrapalhar outro que tiver no servidor
• Variaveis ( GROQ_API_KEY, BUSINESS_MESSAGE, PROCESS_GROUP_MESSAGES, PROCESS_SELF_MESSAGES) agora definidas dentro do painel de configurações na Interface Visual
• Implementado Login com chaves de Usuario e Senha definidos na Stack Docker para login da aplicação
• Incluido sistema de permissões de transcrição para grupos, só transcreve o que foi permitido no painel de configurações
• Incluido sistema de bloquei de transcrição para usuarios individuais definidos no painel
• Sistema de Contagem de Transcrições e Dashboard Gráfico
• Mudança das variáveis contidas dentro da Interface podem ser feitas sem necessidade de redeploy
• Incluído chamada API na Evolution para buscar grupos de Whastapp para poder selecionar para aceitar transcrição
• Mudança de Logo da Aplicação
• Sistema de Logs modificado para abarcar logs da Interface
• Utilização de Redis para persistencia de dados de configuração do sistema e dados da interface.

[email protected]

What's Changed

• Implementa configuração de variáveis de ambiente e logging by @DavidsonGomes in #1
• Adiciona verificação de tipo de mensagem em transcrição de áudios, ig… by @DavidsonGomes in #2
• Ajuste para melhorar a escalabilidade do serviço by @DavidsonGomes in #3

New Contributors

• @DavidsonGomes made their first contribution in #1

Full Changelog: https://github.com/impacte-ai/transcrevezap/commits/2.0

[email protected]

Primeira versão estável do Projeto TranscreveZAP
Aplicação de API sem interface

• Transcrição de audios do Whatsapp através de um webhook da Evolution API
• Utilização de chave GROQ no docker compose
• Definição das Variáveis todas feitas no Docker Compose ( GROQ_API_KEY, BUSINESS_MESSAGE, PROCESS_GROUP_MESSAGES, PROCESS_SELF_MESSAGES)
• Para poder mudar variáveis é necessário mudar a stack e rebuildar o projeto
• Possibilidade de definir se transcreve grupos e mensagens de si próprio
• Transcreve todos os eventos de audio que chegam ao webhook, transcreve e resume.