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

Firebird

O módulo Firebird executa uma consulta SQL diretamente em um banco de dados Firebird da sua empresa, sem sair do fluxo. É útil para buscar ou atualizar informações em sistemas próprios que usam Firebird durante o atendimento.

Para SQL Server, MySQL ou PostgreSQL, use o módulo Consulta em Banco de Dados. Para Oracle, use o módulo Oracle DB.

🧭 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 Integração (identificada pela cor azul).

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

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

🔌 Conexão

Campo
O que preencher

Host

Endereço do servidor do banco de dados

Porta

Porta de conexão do banco de dados

Usuário

Usuário de acesso ao banco

Senha

Senha de acesso ao banco

Nome do banco

Nome ou caminho do banco de dados Firebird a ser acessado

📝 Consulta SQL

No campo de consulta, escreva o comando SQL a ser executado. Você pode usar variáveis do fluxo dentro da consulta.

Exemplo:

🔀 Saídas do módulo

O módulo tem duas saídas:

  • Sucesso — a consulta foi executada, com o resultado (uma lista de registros) disponível para os próximos módulos do fluxo.

  • Erro — não foi possível executar a consulta (por exemplo, erro de conexão, credenciais inválidas ou erro de sintaxe na consulta).

💡 Caso de uso

Cenário: uma empresa quer consultar o status de um pedido, armazenado em um banco de dados Firebird próprio, para informar o cliente durante o atendimento.

Configuração:

  1. Adicione o módulo Firebird ao fluxo.

  2. Preencha os dados de conexão com o banco de dados da empresa.

  3. Na consulta SQL, escreva: SELECT STATUS FROM PEDIDOS WHERE CODIGO = '{{input.codigoPedido}}'.

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

Resultado: o fluxo consulta automaticamente o status do pedido informado pelo cliente e pode usar essa informação na resposta.

📌 Dicas úteis

  • Sempre teste a consulta com dados reais antes de publicar o fluxo em produção.

  • Evite consultas que possam alterar ou apagar muitos registros de uma vez sem uma condição bem definida.

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

  • Guarde os dados de conexão (host, usuário, senha) em variáveis de ambiente sempre que possível, em vez de digitá-los diretamente no módulo.

📝 Resumo

  • O módulo Firebird executa uma consulta SQL em um banco de dados Firebird.

  • Os dados de conexão são preenchidos diretamente no módulo, sem credencial centralizada.

  • Nunca insira texto do cliente diretamente na consulta sem validação, para evitar manipulação indevida do banco de dados.

  • O módulo tem uma saída de Sucesso, com o resultado disponível para o fluxo, e uma saída de Erro.