# 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.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.helena.app/duvidas-e-novidades/novidades-de-produto/abril-2025/24-04-2025-prod.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.