> 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/agosto-2025/18-08-2025-prod.md).

# 18/08/2025 - Prod

Confira nossa última melhoria.

### **➡️ Melhoria no Endpoint de Criação de Contatos**

Implementamos novos parâmetros nos endpoints de **Criação de Contatos** e **Salvar Contatos em Massa** para oferecer maior flexibilidade e controle na gestão de dados.

* **Parâmetro upsertFields:** Permite definir quais campos devem ser modificados quando a operação for um upsert (se o contato já existir, será atualizado). Com este parâmetro, é possível indicar exatamente quais informações devem ser atualizadas sem afetar os outros campos do contato.
* **Parâmetro upsertTagOperation:** Quando a opção upsert é utilizada, este parâmetro permite definir como as etiquetas do contato serão tratadas. As opções disponíveis são:
  * **insertIfNotExists:** Adiciona as etiquetas da requisição que ainda não existirem no contato.
  * **deleteIfexists**: Remove as etiquetas do contato que não estiverem presentes na requisição.
  * **replaceAll:** Remove todas as etiquetas do contato e as substitui pelas novas da requisição.

Essas melhorias simplificam a gestão de contatos, tornando o processo de atualização mais eficiente e preciso, especialmente em casos de sincronização de dados.

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FVw3tjICniG89H0TMydwN%2F1808%20-criar%20release%20notes.png?alt=media&amp;token=a03ae04c-a8c2-458a-8bb3-73c9771f36ed" alt=""><figcaption></figcaption></figure>
