> 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/janeiro-2026/21-01-2026-api.md).

# 21/01/2026 - API

### 🔌 Integrações e API

#### **Atualização de Campos Personalizados**

**🔧**Ao atualizar campos personalizados do tipo **Data, Horário ou Data e Horário** via API, quando o valor era enviado vazio, o conteúdo anteriormente salvo **não era removido**, permanecendo indevidamente na plataforma.

**✅** Agora, se você enviar um comando para limpar um campo de data ou horário (enviando valor vazio), o sistema removerá a informação corretamente do cadastro, mantendo sua base de dados higienizada.

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2F84MnVpjobhEycKyPzSc3%2Fimage.png?alt=media&amp;token=408a9240-bb16-4197-aaa3-30e543f238a6" alt=""><figcaption></figcaption></figure>

#### **Disponibilidade de Usuários via API**

**🔧**Com o objetivo de tornar o processo de criação e gerenciamento de usuários via API mais eficiente e flexível, **implementamos a possibilidade de definir a disponibilidade do usuário diretamente pela API.**

**✅Melhoria implementada:** Foi adicionado o novo parâmetro **Availability** nos endpoints de **listar, criar, obter por ID e atualizar usuários**, permitindo verificar, criar ou atualizar usuários como disponíveis ou indisponíveis.

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FQqcRxRoxHIaLZIodpoal%2Fdisponibilidade%20do%20usuario%20via%20API%20(1).png?alt=media&amp;token=a4390559-431b-4f0f-8f71-3db8094fc4a9" alt=""><figcaption></figcaption></figure>

#### **Enviar Mensagem via API**

**🔧**Ao enviar uma mensagem via API **(Mensagem → Enviar ou Mensagem → Enviar Síncrono)** definindo um atendente específico, o sistema distribuía a conversa, mas não mostrava visualmente quem era o dono. O atendimento aparecia na aba "Novos" como se estivesse livre, causando confusão na equipe.

**✅Melhoria implementada:** Agora, os atendimentos direcionados a um usuário específico via API **possuem identificação visual clara** no histórico da conversa.

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FKYEaayYUJ6RpVINsc55W%2Fatribuido%20para%20(1).png?alt=media&amp;token=769842ae-a990-46e8-8b76-6da692fdf773" alt=""><figcaption></figcaption></figure>

**Transferência de Atendimentos via API**

**🔧**A API permitia a transferência de atendimentos (Conversas → Transferir) para **usuários ou equipes excluídas**, gerando inconsistências no fluxo e possíveis falhas operacionais.

**✅**&#x41;gora, o sistema valida o destino antes da operação: se o usuário ou equipe não existirem mais, a transferência é bloqueada e um aviso claro é retornado.

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2Fe4xddhBBID9B2EFWsqpU%2Fimage.png?alt=media&amp;token=ee7658ac-5724-4a65-92c2-b49a15f92349" alt=""><figcaption></figcaption></figure>