Ferramenta: Tabela - Criar Registro

Quando usar

Use este node para inserir novos dados em uma tabela do Brife automaticamente. Exemplos comuns:

• Cadastrar um novo cliente a partir de dados recebidos por webhook


• Registrar um pedido apos o preenchimento de um formulario


• Criar um log de auditoria para cada acao executada no workflow


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

---

Como funciona

O node se conecta a uma tabela do workspace, permite selecionar a pagina de destino e mapear os valores que serao inseridos em cada campo. Um novo registro e criado na tabela com os dados configurados.

O fluxo segue pela saida Sucesso* quando o registro e criado com exito, ou pela saida *Erro se houver falha na operacao.

---

Configuracoes

Tabela

Seleciona a tabela onde o novo registro sera criado. A lista exibe todas as tabelas do workspace.

Pagina

Apos selecionar a tabela, escolha a pagina especifica onde o registro sera inserido. So aparece quando ha paginas disponiveis.

Valores

Lista de campos e seus respectivos valores para o novo registro. Cada entrada tem:

| Campo | Descricao |
|-------|-----------|
| Campo | Coluna da tabela onde o valor sera inserido. A lista e carregada automaticamente da pagina selecionada. |
| Valor | Conteudo a ser gravado no campo. Aceita variaveis dinamicas (ex: `{{trigger.body.nome}}`). |

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

---

Dados de saida

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `row` | Objeto | O registro recem-criado, incluindo seu ID gerado e todos os valores inseridos |

---

Saidas do node

| Saida | Quando ativa |
|-------|-------------|
| Sucesso | O registro foi criado na tabela |
| Erro | Falha na criacao (ex: campo obrigatorio faltando, tabela inexistente) |

---

Dicas

• Mapeie apenas os campos necessarios. Campos nao mapeados ficam vazios no novo registro.


• Use variaveis de nodes anteriores para preencher os valores automaticamente. Exemplo: `{{webhook.body.email}}` para inserir o e-mail recebido por um webhook.


• Apos a criacao, o ID do novo registro fica disponivel em `row.id`. Use-o em nodes seguintes para atualizar ou referenciar o registro.


• Este node pode ser usado como ferramenta do Chatbot IA, permitindo que o agente cadastre novos registros durante uma conversa.


• Para inserir multiplos registros de uma vez, combine este node com o node Para Cada (For Each) iterando sobre uma lista.