Supabase

O módulo Supabase permite consultar, inserir, atualizar ou remover dados em um banco de dados Supabase, ou chamar uma função personalizada (RPC) cadastrada no seu projeto, sem sair do fluxo.

A conexão com o Supabase usada por este módulo tem acesso total ao banco de dados, ignorando as regras de segurança por linha (RLS) configuradas no seu projeto. Sempre preencha o campo Filtros com uma condição específica nas operações de Atualizar e Remover — deixá-lo vazio pode afetar todas as linhas da tabela.

📷 Inserir print: visão geral do módulo Supabase na área de trabalho do fluxo

🧭 Como acessar

1. No menu lateral, clique em Gerenciamento de aplicativos.

2. Em seguida, clique em Fluxos.

3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.

4. No painel de módulos, localize a categoria Ação.

5. Arraste o módulo Supabase para a área de trabalho do fluxo.

📷 Inserir print: painel de módulos com a categoria Ação expandida e o módulo Supabase visível

Antes de usar este módulo: é necessário ter uma integração do tipo Supabase já cadastrada, com o endereço do projeto e a chave de acesso.

🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

📷 Inserir print: painel de configuração do módulo Supabase aberto

🔌 Integração

Selecione a integração Supabase já cadastrada.

📷 Inserir print: campo Integração com a credencial Supabase selecionada

🗂️ Fonte

Selecione a tabela ou a função do seu projeto Supabase com a qual deseja trabalhar. A lista é carregada automaticamente do seu projeto.

📷 Inserir print: campo Fonte com tabelas e funções disponíveis

🧩 Configuração — Tabelas

Ao selecionar uma tabela, escolha a Operação:

• Listar — busca vários registros.

• Buscar um — busca um único registro.

• Inserir — cria um novo registro.

• Inserir/Atualizar vários — cria ou atualiza vários registros de uma vez.

• Atualizar — edita registros existentes.

• Remover — exclui registros.

Dependendo da operação, preencha:

Campo	Quando aparece	O que preencher
Filtros	Listar, Buscar um, Atualizar, Remover	Condição em formato JSON para selecionar os registros afetados
Dados	Inserir, Atualizar, Inserir/Atualizar vários	Os valores a serem gravados, em formato JSON
Limite	Listar	Quantidade máxima de registros retornados

Nas operações Atualizar e Remover, sempre preencha o campo Filtros com uma condição específica (por exemplo, {"id": "{{input.id}}"}). Deixar o filtro vazio afeta todos os registros da tabela.

📷 Inserir print: configuração de uma operação em tabela, com Filtros preenchidos

🧩 Configuração — Funções

Ao selecionar uma função (RPC), os campos exibidos correspondem aos parâmetros esperados por ela, preenchidos automaticamente conforme a definição da função no seu projeto Supabase.

Se a tabela selecionada tiver colunas de busca vetorial (embeddings), o módulo pode exigir também uma integração com a OpenAI para gerar o vetor de busca automaticamente.

📷 Inserir print: configuração de uma função com seus parâmetros

🔀 Saídas do módulo

O módulo tem duas saídas:

• Sucesso — a operação foi concluída, com o resultado disponível para os próximos módulos do fluxo.

• Erro — não foi possível concluir a operação (por exemplo, tabela/função inexistente, dados inválidos ou falha de conexão).

📷 Inserir print: módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro

💡 Caso de uso

Cenário: uma empresa quer consultar o histórico de pedidos de um cliente, armazenado em uma tabela do Supabase.

Configuração:

1. Adicione o módulo Supabase ao fluxo.

2. Selecione a integração Supabase e a tabela "pedidos" como Fonte.

3. Na Operação, selecione Listar.

4. No campo Filtros, informe {"telefone": "{{input.phone}}"}.

5. Conecte a saída Sucesso a um módulo que use o resultado na conversa.

Resultado: o fluxo consulta automaticamente os pedidos do cliente pelo telefone informado.

📌 Dicas úteis

• Sempre preencha o campo Filtros com uma condição específica nas operações de Atualizar e Remover.

• Teste a operação com dados reais antes de publicar o fluxo em produção.

• Sempre conecte a saída Erro a algum tratamento, já que operações de banco de dados podem falhar por diversos motivos.

• Para usar busca vetorial (embeddings), tenha uma integração OpenAI configurada.

📝 Resumo

• O módulo Supabase consulta, insere, atualiza ou remove dados em tabelas, ou chama funções do seu projeto Supabase.

• A conexão usada tem acesso total ao banco — use sempre filtros específicos em Atualizar e Remover.

• Suporta busca vetorial (embeddings) integrada com a OpenAI.

• O módulo tem uma saída de Sucesso e uma de Erro.