Brife
Automações

Ferramenta: Tabela - Deletar Registro

Atualizado em 25 de fevereiro de 2026


Quando usar

Use este node para remover registros de uma tabela automaticamente. Exemplos comuns:

  • Remover registros duplicados apos uma verificacao automatica

  • Limpar dados temporarios criados durante o processamento de um workflow

  • Excluir registros antigos que nao sao mais necessarios

  • Permitir que um Chatbot IA delete registros a pedido do usuario
  • ---

    Como funciona

    O node recebe o ID de um registro e o remove da tabela (soft delete). A remocao e permanente do ponto de vista do workflow -- nao ha como desfazer a acao automaticamente apos a execucao.

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

    ---

    Configuracoes

    ID do Registro

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

    Exemplos de uso:

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

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

  • `{{iterator.item.id}}` -- ID do item atual em um loop For Each
  • > Atencao: O registro sera removido permanentemente (soft delete). Esta acao nao pode ser desfeita pelo workflow.

    ---

    Dados de saida

    | Variavel | Tipo | Descricao |
    |----------|------|-----------|
    | `deleted` | Booleano | `true` se o registro foi removido com sucesso |
    | `rowId` | Texto | ID do registro que foi removido |

    ---

    Saidas do node

    | Saida | Quando ativa |
    |-------|-------------|
    | Sucesso | O registro foi removido da tabela |
    | Erro | Falha na remocao (ex: registro nao encontrado, ID invalido) |

    ---

    Dicas

  • Tenha cuidado ao usar este node -- a remocao nao pode ser desfeita automaticamente. Considere adicionar uma verificacao (node If/Else) antes de deletar.

  • Um padrao seguro e: buscar o registro primeiro (Tabela: Buscar Registros), verificar se e realmente o correto (If/Else), e so entao deletar.

  • Este node pode ser usado como ferramenta do Chatbot IA, mas considere se e adequado dar essa permissao ao agente. Em cenarios criticos, prefira exigir confirmacao humana.

  • Para deletar multiplos registros, combine com o node Para Cada (For Each) iterando sobre os IDs a serem removidos.

  • O campo `deleted` na saida permite verificar se a operacao foi bem-sucedida antes de prosseguir.

Este artigo foi útil?

© 2026 Brife Tecnologia LTDA - 30.766.618/0001-28. Todos os direitos reservados.