> 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/01-09-2026.md).

# 01/09/2026

### 🔗 API: Novos endpoints para gerenciamento de etiquetas

A API de etiquetas contava apenas com o endpoint de listagem. Não era possível criar, atualizar ou excluir etiquetas, nem consultar as cores disponíveis diretamente pela API, o que limitava integrações que precisavam gerenciar etiquetas de forma programática.

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

Quatro novos endpoints estão disponíveis na API de etiquetas:

* É possível listar todas as cores disponíveis para etiquetas, com seus respectivos valores de cor de fundo e texto em hexadecimal
* É possível criar etiquetas informando nome e cor. Quando a cor é omitida, a etiqueta é criada em GRAY\_600 por padrão
* É possível atualizar o nome e a cor de uma etiqueta existente. Quando a cor é omitida na atualização, a cor atual é mantida
* É possível excluir etiquetas. Quando a etiqueta está vinculada a contatos, a exclusão exige confirmação via parâmetro removeFromContacts, que remove a etiqueta de todos os contatos associados

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FVKBDMU3csr4tfHH70ZiB%2Fimage.png?alt=media&amp;token=2d66cac3-df6c-4b0e-9115-d5cc5a057062" alt=""><figcaption></figcaption></figure>

### 📊 Relatório de cancelamentos de contas disponível para parceiros

Os parceiros não tinham acesso a uma visão consolidada das contas canceladas, o que dificultava o acompanhamento do churn e a identificação de padrões de saída ao longo do tempo. O relatório está disponível em **Admin → Relatório de cancelamento**.

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

O Relatório de cancelamento está disponível para todos os parceiros. Com ele é possível:

* Visualizar o total de cancelamentos distribuídos por motivo em um gráfico de pizza, com percentual de cada categoria
* Acompanhar a evolução de cancelamentos ao longo dos meses em um gráfico de barras
* Consultar a listagem completa de contas canceladas com data de início e fim de faturamento, motivo do cancelamento e descrição
* Filtrar os dados por período, com suporte a meses anteriores, mês atual e próximo mês

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FPBgKrCmEWDWBR4GXvOEy%2Fimage.png?alt=media&amp;token=5316d344-3bf6-4190-bd1f-1f8f617114e7" alt=""><figcaption></figcaption></figure>
