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.