> For the complete documentation index, see [llms.txt](https://docs.helena.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helena.app/duvidas-e-novidades/novidades-de-produto/abril-2025/24-04-2025-prod.md). # 24/04/2025 - Prod ### **➡️ Notas Internas disponíveis na API Pública** #### **🔹 Novidade disponível na API Pública** Agora é possível gerenciar Notas Internas diretamente pela API, oferecendo mais autonomia e integração para as equipes que utilizam a API da plataforma. #### 🔹**O que foi incluído?** Foram adicionados os seguintes *endpoints* para manipulação de notas internas: * Registrar nota interna * Listar notas internas * Obter uma nota interna * Excluir uma nota interna #### **🔹 Benefícios** Essa atualização permite que integrações externas possam criar, visualizar e remover notas internas de forma automatizada, otimizando fluxos personalizados de atendimento e históricos de conversas. #### **🔹 Disponível na documentação da API** Consulte os detalhes de cada endpoint, parâmetros e exemplos de uso em nossa documentação oficial da API.
### **➡️ Validação para Notas Vazias** Correção de comportamento na criação de Notas Internas #### **🔹 Problema identificado** O sistema permitia a tentativa de adicionar notas internas sem texto ou anexo, o que em alguns casos resultava em um comportamento inesperado — como travamento da tela ou mensagens de erro no console, impedindo a finalização do processo. #### **🔹 O que foi corrigido?** Agora, ao tentar salvar uma nota sem conteúdo, o sistema exibirá uma mensagem informativa e bloqueará a ação, evitando loops ou falhas de interface. **Nova mensagem exibida:** *"Não é possível adicionar uma nota vazia. Por favor, insira um texto ou anexe um arquivo antes de salvar."* ### **➡️ Notificação para nova Nota Interna em Atendimento de Terceiros** #### **🔹 O que mudou?** Para fortalecer a colaboração entre os membros da equipe e garantir que nenhuma informação importante passe despercebida, o sistema agora exibe uma notificação automática sempre que uma nota interna for adicionada por um usuário diferente do responsável pelo atendimento. #### **🔹 Cenário de uso** Se a conversa estiver sob responsabilidade da atendente Amanda e outro usuário inserir uma nota interna, a Amanda será imediatamente notificada de que há uma nova anotação. #### **🔹 Como funciona?** * A notificação será exibida diretamente no painel de atendimentos, utilizando o mesmo estilo de alerta já utilizado quando o contato envia uma nova mensagem. * A mensagem informará que uma nova nota interna foi registrada e quem a adicionou. * Dessa forma, o responsável pelo atendimento pode acompanhar as interações internas em tempo real. #### **🔹 Benefícios** * Aumenta a visibilidade das anotações internas. * Facilita o trabalho em equipe. * Evita perda de informações importantes durante o atendimento.
### **➡️ Validação para cadastro de Tag sem canal configurado** #### **🔹 Melhoria implementada** Adicionamos uma validação na tela Ajustes → Integração → Botão do WhatsApp e Tag de Rastreamento, para orientar o usuário sobre a necessidade de ter ao menos um canal configurado na conta antes de tentar cadastrar uma nova tag. #### **🔹 O que foi corrigido?** Anteriormente, ao clicar em “Nova Tag” sem nenhum canal cadastrado, um pop-up era exibido sem funcionalidade, causando confusão ao usuário. Agora, o sistema exibe a seguinte mensagem de aviso: *“Para cadastrar uma nova tag, é necessário ter ao menos um canal configurado. Por favor, adicione um canal antes de tentar novamente."* ### **➡️ Correção na cópia do Script de Integração do WhatsApp** #### **🔹 O que foi corrigido?** Corrigimos o comportamento incorreto ao utilizar o ícone de "Copiar" no quadro de Script localizado em: Ajustes → Integrações → Botão do WhatsApp e Tag de Rastreamento. #### **🔹 Problema identificado** Ao utilizar o botão de cópia, o link dentro do script era alterado de forma indevida, substituindo “[wts.chat](http://wts.chat/)” por “oihe”. No entanto, ao copiar o conteúdo manualmente, o link era mantido corretamente. #### **🔹 O que mudou?** A ação de cópia via botão agora preserva exatamente o conteúdo original exibido no campo de script, mantendo o link correto: [wts.chat](http://wts.chat/). O comportamento agora é consistente, seja usando o botão de copiar ou realizando a cópia manualmente.
### **➡️ Correção no layout do Botão de Ações nas Mensagens** #### **🔹 O que foi corrigido?** Ajustamos o posicionamento do botão de detalhes da mensagem (ícone de três pontinhos), exibido em cada mensagem na tela de atendimento. #### **🔹 Problema identificado** Em alguns casos, o botão estava sendo exibido sobre o texto da própria mensagem, dificultando a leitura do conteúdo e impactando a usabilidade. #### **🔹 O que mudou?** * O botão agora é exibido fora da área de leitura da mensagem, com alinhamento adequado e visual limpo. * A correção considera diferentes tamanhos de conteúdo e resoluções de tela, garantindo consistência visual. * A experiência do atendente foi aprimorada, focando em leitura fluida e acessibilidade.
### ➡️ **Ajuste na exibição do campo "Sequência" para Atendentes Restritos** #### **🔹 O que foi corrigido?** Corrigimos o comportamento da plataforma ao exibir o campo “Sequência” na visualização das informações do contato para usuários com perfil Atendente Restrito. #### **🔹 Problema identificado** Anteriormente, o campo “Sequência” era exibido com a mensagem de erro *“Não foi possível carregar as sequências”*, mesmo quando o contato possuía sequências vinculadas, gerando dúvidas ao usuário. #### **🔹 O que mudou?** O campo “Sequência” agora é carregado corretamente, exibindo as sequências vinculadas ao contato. Para usuários do tipo Atendente Restrito, o campo é exibido em modo somente leitura, sem possibilidade de edição. **Ao passar o mouse sobre o campo, será exibida a mensagem:** *“Funcionalidade disponível apenas para administradores”.*
### ➡️ **Ajuste de permissões em Contatos** #### **🔹 Correção de erro** Corrigido o problema que impedia atendentes de desarquivar contatos e exibia indevidamente a mensagem: *"Esse usuário não pode bloquear/desbloquear o contato."* #### **🔹 Melhorias aplicadas** * Atendentes agora podem desarquivar contatos normalmente. * Botão de bloquear/desbloquear foi desabilitado para atendentes e atendentes restritos, com aviso: *"Funcionalidade disponível apenas para administradores."* * Atendentes restritos não podem mais arquivar/desarquivar contatos.
### ➡️ **Correção na exibição de filtros por Campo Personalizado em Campanhas** #### **🔹 Problema corrigido** Ao aplicar filtros utilizando Campos Personalizados dentro de grupos de campos no público-alvo de campanhas, o sistema não exibia corretamente o nome e o valor filtrado após o salvamento, mostrando apenas "..." no lugar das informações. #### **🔹 Melhoria aplicada** Corrigida a exibição dos filtros aplicados em campos personalizados de grupos, garantindo que nome do campo e valor selecionado sejam corretamente salvos e exibidos na visualização da Campanha. **Como era antes da correção:**
### **➡️ Correção na funcionalidade “Ver Mais” para cards arquivados no painel** #### **🔹 Problema corrigido** Foi identificado um erro no Painel ao utilizar o filtro de cards arquivados. Quando há muitos registros, o botão "Ver Mais" é exibido, mas não carrega os cards adicionais ao ser clicado — comportamento que não ocorre com os cards ativos. #### **🔹** Melhoria aplicada Corrigido o funcionamento da opção "Ver Mais" para cards arquivados, garantindo que todos os registros sejam carregados corretamente ao expandir a listagem. A lógica de carregamento agora é a mesma utilizada para os cards ativos, proporcionando uma experiência consistente ao usuário. ### **➡️ Correção na visualização de cards em painéis com modo "Individual"** #### **🔹 Problema corrigido** Identificamos uma falha que impedia usuários com perfil de atendente ou atendente restrito, mesmo quando configurados como supervisores de equipe, de visualizar os cards nos painéis configurados com a visualização "Individual". O problema não afetava usuários com perfil de administrador, que continuavam visualizando normalmente. #### **🔹 Melhoria aplicada** A lógica de permissões foi ajustada para garantir que atendentes e atendentes restritos, ao serem atribuídos como supervisores, também possam visualizar corretamente os cards dos usuários da equipe nos painéis com visualização "Individual".
### ➡️ **Correção na avaliação de condicionais em Chatbots** #### **🔹 Problema corrigido** Foi identificado um erro na execução de Chatbots que utilizam estruturas condicionais com números inteiros e caracteres. Quando o contato digitava um número no início do atendimento, o fluxo condicional não era acionado corretamente, impedindo o avanço do Chatbot. **Causa:** A falha ocorria devido a um conflito na comparação entre tipos de dados (números inteiros e textos), o que gerava tentativas de acessar valores inexistentes e resultava em erro de execução. #### **🔹 Melhoria aplicada** O sistema foi ajustado para tratar corretamente os diferentes tipos de dados utilizados nas condicionais. Agora, quando um número válido for inserido, o fluxo do chatbot será acionado conforme esperado, garantindo o funcionamento correto da automação e maior estabilidade no atendimento. ### ➡️ **Upload de arquivos via API** #### **🔹 O que mudou?** Agora é possível realizar o upload de arquivos diretamente via API sem a necessidade de expor o conteúdo em uma URL pública, garantindo mais segurança, controle e praticidade no envio de arquivos através da plataforma. #### **🔹 Novos Endpoints disponibilizados** Foram incluídos novos recursos na API para facilitar a manipulação de arquivos: **Obter URL para upload:** Endpoint que retorna uma URL temporária para o envio do arquivo via método PUT, a partir dos metadados informados. **Salvar arquivo:** Após o upload do arquivo para a URL gerada, utilize este endpoint para registrar o arquivo e obter o FileId, que poderá ser usado nas mensagens. 📌 **Importante:** O FileId é reutilizável. Se o mesmo arquivo for usado em diferentes mensagens, não é necessário realizar múltiplos uploads. #### **🔹** Envio de arquivo nas mensagens O endpoint Conversas → Enviar Mensagem foi atualizado e agora conta com a nova propriedade: "fileId": Código do arquivo enviado via upload. Esse ID pode ser obtido nas rotas /core/v2/file, e o conteúdo deve seguir as regras do canal de atendimento. #### **🔹** Principais benefícios * Mais segurança: não há necessidade de hospedar arquivos em URLs públicas. * Mais controle: envio direto para o ambiente da plataforma. * Maior eficiência: reutilização do mesmo arquivo sem múltiplos uploads.