> 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="/files/PVy2q9pg5dGrAf9m2Km3" 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="/files/XzPK8l9k2O5wn6ZdXEDj" 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="/files/xrmOYKvWe269TsSU2vwV" 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="/files/lGrY8c6sgnd33UGgqoW4" alt=""><figcaption></figcaption></figure>