For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

📷 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

🔍 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

📷 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.