# 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="/files/eVxexbSh8jRJcDPh4JdR" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helena.app/duvidas-e-novidades/novidades-de-produto/agosto-2025/18-08-2025-prod.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
