Ferramenta: Tabela - Atualizar Registro

Quando usar

Use este node para modificar dados de um registro ja existente em uma tabela. Exemplos comuns:

• Atualizar o status de um pedido apos processamento


• Modificar os dados de um contato com informacoes recebidas por e-mail


• Marcar um registro como "processado" para evitar reprocessamento


• Permitir que um Chatbot IA edite registros durante uma conversa com o usuario

---

Como funciona

O node localiza um registro pelo seu ID e atualiza apenas os campos mapeados na configuracao. Campos nao mapeados permanecem inalterados. Voce seleciona a tabela e pagina para resolver os nomes dos campos, e informa o ID do registro a ser atualizado.

O fluxo segue pela saida Sucesso* quando o registro e atualizado, ou pela saida *Erro se houver falha.

---

Configuracoes

ID do Registro

Identificador unico do registro (row) a ser atualizado. Aceita variaveis dinamicas.

Exemplos de uso:


• `{{tabela_buscar.rows[0].id}}` -- ID obtido de uma busca anterior


• `{{trigger.body.rowId}}` -- ID recebido por webhook


• `{{chatbot.rowId}}` -- ID definido pelo Chatbot IA

Tabela

Seleciona a tabela onde o registro esta. Necessaria para carregar os campos disponiveis.

Pagina

Apos selecionar a tabela, escolha a pagina correspondente. So aparece quando ha paginas disponiveis.

Valores a atualizar

Lista de campos e seus novos valores. Cada entrada tem:

| Campo | Descricao |
|-------|-----------|
| Campo | Coluna da tabela a ser atualizada. A lista e carregada automaticamente da pagina selecionada. |
| Novo valor | Conteudo que substituira o valor atual. Aceita variaveis dinamicas. |

Use o botao + (Adicionar Campo) para incluir novos campos e o icone de lixeira para remover.

---

Dados de saida

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `row` | Objeto | O registro atualizado, com os novos valores aplicados |

---

Saidas do node

| Saida | Quando ativa |
|-------|-------------|
| Sucesso | O registro foi atualizado com exito |
| Erro | Falha na atualizacao (ex: registro nao encontrado, ID invalido) |

---

Dicas

• Mapeie apenas os campos que precisa alterar. Campos nao listados na configuracao permanecem com seus valores originais.


• O ID do Registro* geralmente vem de um node anterior. Um padrao comum e usar o node *Tabela: Buscar Registros antes para encontrar o registro, e depois usar `{{buscar.rows[0].id}}` como ID.


• Este node pode ser usado como ferramenta do Chatbot IA, permitindo que o agente atualize registros em tempo real durante uma conversa.


• Para atualizar multiplos registros, combine com o node Para Cada (For Each) iterando sobre os resultados de uma busca.


• Caso o ID informado nao corresponda a nenhum registro, o node seguira pela saida Erro.