> 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/julho-2025/30-07-2025-prod.md).

# 30/07/2025 – Prod

Confira nossas últimas atualizações.

### **➡️ Otimização e Estabilidade no Relatório de Atendimentos**

#### **🔹 Problema identificado**

Verificamos que a geração do relatório de atendimentos, ao utilizar filtros que retornavam um volume muito alto de dados (como longos períodos), poderia causar instabilidade.

Em alguns casos, a operação era interrompida por um erro, o que impedia a extração de relatórios completos.

#### **🔹 Soluções implementadas**

Realizamos uma otimização completa na forma como o sistema processa e agrupa as informações para o relatório de atendimentos.

A estrutura de consulta de dados foi aprimorada para lidar com um alto volume de registros de forma muito mais eficiente.

#### **🔹 Benefícios**

* **Maior estabilidade**: Confiança total para gerar seus relatórios sem erros ou interrupções.
* **Mais performance:** Obtenha relatórios de grandes períodos em menos tempo.
* **Análise completa:** Capacidade de extrair e analisar grandes volumes de dados de atendimento sem falhas, garantindo que nenhuma informação importante fique de fora.

### **➡️ Ajuste de Consistência na Data de Transações na Aba "Pagamentos"**

#### **🔹 Problema identificado**

Identificamos uma inconsistência onde a data exibida para uma transação na aba "Pagamentos" do contato não correspondia à data em que a solicitação de pagamento foi originalmente gerada.

Em vez disso, o sistema exibia uma data de consulta posterior, causando confusão no rastreamento e na organização das cobranças emitidas.

#### **🔹 Soluções implementadas**

O sistema foi corrigido para que o campo de data, na aba "Pagamentos" do contato, busque e exiba exclusivamente a data e a hora em que a solicitação de pagamento foi criada no sistema.

#### **🔹 Benefícios**

* **Maior confiança e consistência:** A data da transação agora é a mesma em todas as telas da plataforma, eliminando divergências.
* **Melhor rastreabilidade:** Facilita o acompanhamento do ciclo de vida da cobrança, permitindo saber exatamente quando cada solicitação de pagamento foi emitida.
* **Controle financeiro preciso:** Ajuda na organização e conciliação de valores, garantindo que você tenha sempre a informação correta sobre a origem de suas transações.

### **➡️ Envio de Respostas a Mensagens via API**

#### **🔹 Problema identificado**

Nossa API de mensagens permitia apenas o envio de novas mensagens em uma conversa, sem a capacidade de vinculá-las como uma resposta direta a uma mensagem anterior.

Isso limitava a criação de fluxos de conversa contextuais e organizados para nossos parceiros e clientes que utilizam integrações (Chatbots, sistemas externos, etc.).

#### **🔹 Soluções implementadas**

Introduzimos um novo parâmetro (refId) na API que permite que uma nova mensagem seja enviada como réplica a uma mensagem específica já existente.

Quando utilizado, o sistema exibe a nova mensagem visualmente encadeada à original na interface, da mesma forma que uma resposta manual.

**Endpoints que possuem esse parâmetro:**

* POST /conversas/enviar-mensagem
* POST /conversas/enviar-mensagem-sincrona
* POST /mensagens/enviar
* POST /mensagens/enviar-sincrono

#### **🔹 Benefícios**

* **Melhora a experiência do cliente final:** As respostas automáticas ou via sistema chegam de forma contextual, facilitando o entendimento e tornando o diálogo mais natural.
* **Aumenta o poder das integrações:** Permite que nossos clientes e parceiros criem Chatbots e automações muito mais inteligentes e eficientes, que mantêm o fio da conversa.
* **Maior organização para a equipe de atendimento:** Ao visualizar a conversa na nossa plataforma, a equipe consegue entender o histórico de forma muito mais clara, pois as respostas via API agora seguem o mesmo padrão visual das respostas manuais.

<figure><img src="/files/xmIs4JnoSfi3oCe8Zvqc" alt=""><figcaption></figcaption></figure>

### **➡️ Atualização de Contatos via API**

#### **🔹 Problema identificado**

Em alguns momentos, uma nota interna ou outra informação adicionada a um contato via API não era salva, mesmo que o sistema indicasse que a operação tinha sido um sucesso (200 OK).

O problema ocorria quando duas ou mais atualizações para o mesmo contato aconteciam em um intervalo de tempo muito curto, fazendo com que uma alteração se perdesse no processo.

#### **🔹 Soluções implementadas**

Implementamos um controle de segurança no processo de atualização de contatos. Esse mecanismo funciona como um "organizador de fila", garantindo que, mesmo que várias atualizações cheguem ao mesmo tempo para o mesmo contato, elas sejam processadas uma de cada vez, em ordem, sem conflitos.

#### **🔹 Benefícios**

* **Integridade dos dados:** Garante que nenhuma atualização de contato via API seja mais perdida, mesmo em cenários de alto volume.
* **Confiabilidade para automações:** Parceiros e clientes que utilizam ferramentas como n8n, Zapier, etc., podem confiar que seus fluxos de trabalho de atualização funcionarão de forma consistente.
* **Redução de inconsistências:** Evita cenários de suporte onde o cliente vê um "sucesso" em sua ferramenta de automação, mas a informação não está refletida em nossa plataforma.
