> 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/09-07-2025-prod.md).
# 09/07/2025 – Prod
### **➡️ Nova API Pública para Gestão de Contas e Tokens**
Pensando em escalar suas operações e automatizar seus processos, estamos entusiasmados em anunciar o lançamento da nossa nova **API pública para Gestão de Contas**.
Até agora, a gestão de contas era um processo manual realizado em nossa plataforma. A partir de hoje, você pode integrar seus sistemas diretamente conosco para gerenciar todo o ciclo de vida de contas e seus tokens de API.
#### **🔹 Funcionalidades disponíveis**
A nova API oferece um conjunto completo de endpoints para gerenciar contas e tokens de forma programática.
#### **⚠️ Importante: Sobre a autenticação e os Tokens da API**
Para utilizar nossas APIs corretamente, é fundamental entender qual token deve ser usado para cada finalidade. Existem dois tipos principais de tokens:
**1. Token de Parceiro**
* **Onde encontrar:** Gerado na tela de Admin → Personalizar → Integrações.
* **Para que serve:** É usado exclusivamente para autenticar na nova API de Gestão de Contas (criar, listar, remover contas, etc.).
**2. Token da Conta**
* **Onde encontrar:** Gerado na tela de Ajustes → Integrações de cada conta individual.
* **Para que serve:** É usado para autenticar em todas as outras APIs relacionadas à operação daquela conta (envio de mensagens, chatbots, etc.).
**Resumindo:** Use o Token de Parceiro para gerenciar contas e o Token da Conta para operar dentro de uma conta.
#### **🔹 Benefícios e oportunidades**
* **Automação Completa:** Automatize o ciclo de vida de suas contas, desde a criação até a remoção, integrando com seus sistemas de CRM ou ERP.
* **Gestão de Segurança:** Gerencie tokens de acesso de forma programática para suas integrações, com a capacidade de criar e revogar permissões sob demanda.
### **➡️ Novo Endpoint na API Pública para exclusão de mensagens**
#### **🔹 A Necessidade**
Identificamos a necessidade de oferecer um meio programático para o gerenciamento de mensagens.
Até agora, não era possível remover mensagens via API, o que limitava a capacidade de nossos parceiros de automatizar rotinas de limpeza de dados ou de corrigir mensagens enviadas por engano através de suas integrações.
#### **🔹 Soluções implementadas**
Implementamos um novo endpoint para a exclusão de mensagens, que se comporta de maneira diferente dependendo do tipo de canal para garantir a conformidade com cada provedor.
* **Novo Endpoint: DELETE /message/{ID}**
#### **Comportamento por canal:**
* **Para canais Z-API (Não Oficial):** A exclusão acionará a função "Apagar para Todos", tentando remover a mensagem também do dispositivo do contato, sujeito às regras e limitações do próprio canal (como o tempo máximo para exclusão).
* **Para canais da API Oficial do WhatsApp:** A exclusão removerá a mensagem apenas da nossa plataforma. A mensagem permanecerá visível para o cliente final no WhatsApp, conforme as políticas da Meta.
#### **🔹Benefícios**
Este novo endpoint oferece maior controle e flexibilidade para sua integração.
Agora você pode gerenciar o histórico de conversas de forma programática, automatizar a limpeza de dados e corrigir erros de envio, tornando sua operação mais robusta e eficiente.
### **➡️ Auditoria para Gestão de Carteiras**
#### **🔹Problema identificado**
Identificamos que, em cenários raros, poderiam ocorrer inconsistências na carteirização de contatos, como um mesmo contato ser atribuído a duas carteiras da mesma equipe.
A investigação desses casos era complexa, pois não havia um registro detalhado de todas as alterações realizadas nas carteiras.
#### **🔹 Soluções implementadas**
Para garantir total transparência e controle, criamos um novo e completo log na tela de Auditoria para Carteiras, localizada em Admin → Auditoria → Histórico de Alterações.
A partir de agora, toda e qualquer ação relacionada a carteiras é registrada em detalhes, incluindo:
* Criação, edição e exclusão de carteiras.
* Associação e remoção de contatos de uma carteira.
* Todas as alterações realizadas via API.
#### **🔹 Benefícios**
Essa nova funcionalidade oferece um nível de segurança e rastreabilidade muito maior.
Agora, você tem um histórico completo de todas as modificações, o que permite identificar exatamente quem realizou cada alteração e quando.
Isso não só previne inconsistências, mas também fornece as ferramentas necessárias para um diagnóstico rápido e preciso de qualquer problema, garantindo a integridade da sua operação.