> 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/setembro-de-2026/23-09-2026.md).

# 23/09/2026

### 💬 **Instagram: Atendimentos duplicados para o mesmo contato**

Em canais do Instagram, um mesmo contato podia ficar com dois atendimentos em andamento ao mesmo tempo.

Isso ocorria porque, ao editar ou sincronizar os dados do contato, a identificação usada pela plataforma para reconhecê-lo no canal era alterada de forma incorreta. Assim, na mensagem seguinte, o sistema não reconhecia o contato existente e criava um novo cadastro com um novo atendimento.

✅ **O que foi corrigido?**

* O contato continua sendo reconhecido corretamente no canal do Instagram após a edição ou sincronização dos seus dados
* Novas mensagens são direcionadas ao atendimento existente, sem gerar cadastros ou atendimentos duplicados

### 💬 **Z-API: Atendimento vinculado ao contato incorreto após unificação**

Em canais Z-API, quando a plataforma identificava que um contato já existente possuía o mesmo número de um novo registro, os dois eram unificados e o duplicado removido.

Porém, em alguns casos, ações simultâneas como transferências pelo chatbot ou gravações concorrentes faziam o atendimento em andamento continuar vinculado ao contato removido. Com isso, o atendimento desaparecia da plataforma durante a conversa e automações retornavam "Contato não encontrado".

✅ **O que foi corrigido?**

* O atendimento permanece vinculado ao contato correto após a unificação, mesmo com outras ações em execução simultaneamente
* As integrações e automações externas passam a localizar e receber os dados do contato ativo corretamente
* Falhas temporárias durante a unificação são reprocessadas sem encerrar o atendimento
* Atendimentos afetados anteriormente foram recuperados e vinculados ao contato correto

### 👥 **Atendimentos: Atendimento direcionado à aba Meus após disparo de sequência**

Quando uma sequência disparava um chatbot para atendimento que estava oculto, o sistema atribuía o atendimento a um atendente logo no disparo.

Com isso, ao responder, o contato tinha o atendimento exibido na aba Meus desse atendente, mesmo com o agente de IA ainda conduzindo a conversa e sem nenhuma ação que justificasse a atribuição.

✅ **O que foi corrigido?**

* Atendimentos iniciados por sequências permanecem ocultos e sem atendente atribuído até a resposta do contato.
* A distribuição do atendimento ocorre somente quando o contato responde, seguindo as regras configuradas no chatbot.

### 🤖 **Chatbot: Chatbot de fora do horário acionado durante o expediente**

Chatbots configurados para atender apenas fora do horário de atendimento eram acionados também durante o expediente.

Isso ocorria quando o chatbot possuía, além da regra de horário, um gatilho por palavra-chave. Como a palavra-chave é válida para qualquer horário, o sistema passava a considerar o chatbot disponível em todos os momentos, acionando-o em qualquer mensagem recebida.

✅ **O que foi corrigido?**

* Chatbots configurados para fora do horário são acionados somente fora do horário de atendimento definido
* Mensagens recebidas durante o expediente seguem para a aba Novos ou para o chatbot configurado para dentro do horário

⚠️ **Atenção:** esta correção se aplica a mensagens que **não** correspondem a uma palavra-chave configurada no chatbot. Gatilhos por palavra-chave continuam válidos para qualquer horário, ou seja, se o contato enviar a palavra-chave durante o expediente, o chatbot ainda será acionado.

### 💬 **Modelos de mensagem: Campo Telefone enviado vazio**

Ao utilizar um modelo de mensagem com o campo personalizado “**Telefone”**, a informação era enviada vazia, mesmo com o número cadastrado no contato.

Isso ocorria porque o sistema não gerava o telefone no formato utilizado pelo modelo durante o preenchimento. As variáveis **Origem** e **Data de Importação** também não eram preenchidas corretamente no chatbot.

✅ **O que foi corrigido?**

* O campo Telefone é preenchido com o número cadastrado no contato em respostas rápidas, mensagem agendada, campanhas e chatbot
* Em envios para múltiplos contatos, cada destinatário recebe o seu respectivo número
* As variáveis Origem e Data de Importação são preenchidas corretamente no chatbot

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2F7K5M8OFg7Yxou30Lkwqi%2FDEM-2382%20(1).gif?alt=media&amp;token=6524e2d7-3351-4fc2-87b9-736e1e0d8f23" alt=""><figcaption></figcaption></figure>

### 👤 **Importação de contatos: Seleção de contatos duplicados perdida ao trocar de página**

Na importação de contatos por planilha, a tela de seleção de contatos duplicados podia exibir um contato como resolvido sem que nenhuma opção estivesse de fato marcada.

Além disso, ao avançar para a próxima página e retornar, as seleções feitas anteriormente eram perdidas, e a barra de paginação ficava sobreposta à lista de contatos, dificultando a visualização.

✅ **O que foi corrigido?**

* A seleção de cada contato duplicado reflete corretamente a opção escolhida pelo usuário
* As seleções são mantidas ao navegar entre as páginas
* Contatos com três ou mais versões duplicadas exibem a marcação corretamente
* A barra de paginação é exibida ao final da lista, sem sobrepor os contatos

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FHtgu4p6wDiaexX8iMJD7%2FDEM-2412%20(1).gif?alt=media&amp;token=8c7e6866-8017-41f1-ac20-f9d890b0e7a1" alt=""><figcaption></figcaption></figure>

### 👤 **Importação de contatos: Código de verificação não enviado ao retomar importação**

Ao retomar uma importação de contatos que havia ficado pendente após o fechamento da janela de confirmação, a tela de verificação era exibida com o campo "Enviado para:" em branco e o código de verificação não era enviado ao e-mail do usuário.

Isso ocorria porque os dados do usuário eram carregados antes de a importação pendente estar disponível, impedindo a conclusão do processo.

✅ **O que foi corrigido?**

* O código de verificação é enviado ao e-mail do usuário logado ao retomar uma importação pendente
* O campo "Enviado para:" exibe corretamente o e-mail do usuário
* A importação pendente pode ser concluída normalmente após a validação do código

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FL06PQTXoF00lnrtpsjof%2FDEM-2407%20(1).gif?alt=media&amp;token=cb04d995-41ac-4cc5-8137-848feafe36f1" alt=""><figcaption></figcaption></figure>

### 📊 **Relatórios: Nome incorreto exibido nos indicadores por usuário**

No relatório de indicadores por usuário, um atendente ativo podia aparecer com o nome de um atendente já excluído da conta, caso os dois registros compartilhassem o mesmo ID de usuário.

✅ **O que foi corrigido?**

* O relatório passa a exibir corretamente o nome do usuário ativo
* O nome do usuário excluído é mantido apenas no histórico de atendimentos anteriores ao cadastro do novo usuário

### 🔌 **API: Quantidade de Agentes de IA e opção Ilimitado nos endpoints de contas**

Nos endpoints de contas da API (Listar, Criar, Obter por ID, Atualizar e Ativar), o retorno/response não informava a quantidade de Agentes de IA que podem ser incluídos em uma conta.

Existia apenas o parâmetro **includedAgents**, que se refere aos usuários da conta. Além disso, a quantidade de Agentes de IA informada na criação da conta não era respeitada.

🚀 **O que há de novo?**

* Os endpoints Listar, Criar, Obter por ID, Atualizar e Ativar passam a retornar o parâmetro includedAIAgents, com a quantidade de Agentes de IA que podem ser incluídos na conta
* A criação de contas respeita a quantidade de Agentes de IA informada no parâmetro **aiAgents**
* Os campos chatBots, chatbotAutomations, panels, sequences e aiAgents aceitam o valor **999** para configurar o recurso como **Ilimitado**, deixando essa informação clara para o usuário.
* A documentação desses campos foi atualizada com os valores aceitos

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FxOYJ9kV9UED4sFDwhHrL%2Fimage.png?alt=media&amp;token=1f36ea2a-a517-4de7-9310-8e4d21180f4d" alt=""><figcaption></figcaption></figure>
