# 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.
---
# 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/julho-2025/09-07-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.