> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/conectores/categorias/manipulacao-de-dados/message-change.md).

# Message Change

Efetua alterações no objeto da mensagem recebida na sua entrada e devolve a mensagem alterada.

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FFTcATqr85yVaUPXoDuxa%2Fimage.png?alt=media&amp;token=d4d2e5cd-7292-4d6d-a9ac-a82565d25406" alt="" width="375"><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

{% hint style="info" %}
Os campos podem variar de acordo com a funcionalidade aplicada.
{% endhint %}

<table data-full-width="true"><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>Descrição</td><td>Campo de texto</td><td>Elemento visual usado para descrever a funcionalidade do conector dentro do fluxo. </td></tr><tr><td>Dados para alterar</td><td>Tabela de Parâmetros</td><td>Permite definir os dados que serão adicionados, movidos, removidos ou copiados no objeto message, além do seu caminho e valor.</td></tr><tr><td>Alteração</td><td>Seletor</td><td>Seletor para copiar, mover, escrever ou remover um valor específico no objeto message.</td></tr><tr><td>Caminho</td><td>Campo de texto</td><td>Define a origem ou caminho do dado no objeto message.</td></tr><tr><td>Destino</td><td>Campo de texto</td><td>Define o destino ou valor dos dados.</td></tr></tbody></table>

{% endtab %}

{% tab title="Funções" %}
Com o Message Change podemos obter alguns comportamentos sobre as cargas de dados do nosso fluxo, sendo possível copiar, mover, escrever e remover valores. Vamos observar o comportamento sobre cada uma das funções.

## Objeto de entrada

Como exemplo, teremos a carga de payload do Manual Trigger, passando como parâmetro um formulário para as entradas de dados dos campos nome e sobrenome.&#x20;

<div><figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FsZXcwVExWk0DXVWwyJSZ%2Fimage.png?alt=media&amp;token=e34f6e2b-f57b-484b-87fc-708d4604680f" alt="" width="358"><figcaption><p>Entrada de dados no fluxo</p></figcaption></figure> <figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FTYuP7o3vMv8jWCLrGvpB%2Fimage.png?alt=media&amp;token=7ddd9f36-8664-4ded-a1f4-a20e83f91230" alt="" width="451"><figcaption><p>Dados em objeto message</p></figcaption></figure></div>

## Copiar valor

Cria uma cópia do atributo ou payload completo de acordo com a configuração dos parâmetros.

<div data-full-width="true"><figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2F6TWVx88bqby9r0SIcA2m%2Fimage.png?alt=media&amp;token=ee359913-8c44-44bd-85f1-1ef2eca7f3ee" alt=""><figcaption><p>Configuração de cópia</p></figcaption></figure> <figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FDjZTYjtqKw6TaK2CbxXM%2Fimage.png?alt=media&amp;token=d471d2d8-987a-4b66-8882-1b1c0b8e398d" alt="" width="451"><figcaption><p>Cópia de atributos name e last_name</p></figcaption></figure></div>

## Mover valor

Seu comportamento tem por padrão renomear a carga de payload original com uma nova atribuição.&#x20;

<div><figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2Fogd4Qh5fCcNr77Y7BVKq%2Fimage.png?alt=media&amp;token=56a8ae17-9182-47ec-be5c-0f341c00ba9b" alt=""><figcaption><p>Configuração de mover valores</p></figcaption></figure> <figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FRGXtGZatNpjgtIokGed4%2Fimage.png?alt=media&amp;token=bfa65f0d-7bea-4843-a76d-f380acb6946f" alt=""><figcaption><p>Atributos name e last_name copiados para outro local</p></figcaption></figure></div>

## Escrever valor

Adicione novos campos a sua carga de payload original através da função escrever valor. No exemplo abaixo, criamos um novo atributo chamado role e adicionamos o valor 'Support analyst'.

<div data-full-width="true"><figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FbMFquCTCocB5vyn55wNv%2Fimage.png?alt=media&amp;token=5cc6d331-515c-4f80-9dea-7c164ad0aea0" alt=""><figcaption><p>Configuração de escrever valores</p></figcaption></figure> <figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2F8AuEfKZxBO7iS8DLRSz2%2Fimage.png?alt=media&amp;token=02cd8960-06f5-4294-8b37-22e975389316" alt=""><figcaption><p>Escreve novos atributos em caminho</p></figcaption></figure></div>

### Remover valor

Recebe o caminho de um objeto e remove o atributo ou o payload completo. No exemplo abaixo, o campo last\_name foi removido do payload\_manualtrigger.

<div><figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FE8pAlzcAuWkcOYsAXgIK%2Fimage.png?alt=media&amp;token=f538c9ce-baec-4b99-a7cf-d6552eb957d8" alt=""><figcaption><p>Configuração de remover valores</p></figcaption></figure> <figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FYLZPYyi6YoLskexiEzVr%2Fimage.png?alt=media&amp;token=07852ff7-f51e-4790-922e-f46afb18a46e" alt=""><figcaption><p>Remove atributos em caminho</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.floui.io/guia/conectores/categorias/manipulacao-de-dados/message-change.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
