Firebase Cloud Storage

O módulo Firebase Cloud Storage permite enviar, substituir, buscar e excluir arquivos armazenados em um Bucket do Firebase, sem sair do fluxo. É útil, por exemplo, para guardar comprovantes, documentos ou imagens enviados pelo cliente durante a conversa.

Imagem 1 - Exemplo do módulo Firebase Cloud Storage.

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

Imagem 2 - Painel de configuração do módulo Firebase Cloud Storage aberto.

---

🔌 Integração

Selecione a integração Firebase já cadastrada.

Imagem 3 - Campo Integração com a credencial Firebase selecionada.

---

🪣 Bucket

Selecione o Bucket do Firebase onde os arquivos serão enviados, buscados ou excluídos. A lista é carregada automaticamente a partir do projeto vinculado à integração selecionada — ou seja, você escolhe um bucket que já existe no seu projeto Firebase.

Imagem 4 - Campo Bucket com a lista de buckets carregada automaticamente.

O módulo verifica se o bucket informado realmente existe antes de executar qualquer operação. Se o bucket não existir no projeto Firebase, a operação não é concluída e a saída Erro é acionada.

---

🧩 Operação

Escolha o que o módulo vai fazer:

• Criar — envia (faz upload de) um novo arquivo para o caminho informado.

• Atualizar — substitui um arquivo já existente no mesmo caminho.

• Buscar — gera um link temporário para download do arquivo, válido por 1 hora.

• Excluir — remove o arquivo do bucket.

Nesta versão da tela, as opções do campo Operação aparecem em inglês (CREATE, UPDATE, DELETE, GET), mesmo com o restante da configuração em português. A função de cada uma é a mesma descrita acima: Criar, Atualizar, Excluir e Buscar, respectivamente.

Imagem 5 - Campo Operação com as opções disponíveis.

---

📄 Caminho do arquivo

Informe o caminho completo do arquivo dentro do bucket, incluindo o nome e a extensão (por exemplo, uploads/comprovante.pdf). Esse mesmo caminho deve ser usado depois para buscar ou excluir o arquivo. Este campo aceita variáveis do fluxo.

Imagem 6 - Campo Caminho do arquivo preenchido com um exemplo de caminho.

---

📎 Arquivo (Criar / Atualizar)

Esse campo aparece somente quando a Operação é Criar ou Atualizar. Informe a variável do fluxo que contém o conteúdo do arquivo a ser enviado — pode ser um arquivo já recebido na conversa ou um link (URL) direto para o arquivo. Quando um link é informado, o próprio módulo baixa o conteúdo automaticamente antes de enviá-lo ao bucket, sem necessidade de nenhum passo manual adicional no fluxo.

Imagem 7 - Campo Arquivo preenchido com uma variável do fluxo.

Ao lado do campo Arquivo, existe a seção Opções avançadas, com um campo de Headers. Ele só é necessário quando o Arquivo é informado como um link (URL) que exige algum cabeçalho especial para o download funcionar (por exemplo, um token de autorização). Se o Arquivo já vier pronto (sem ser um link), esse campo pode ficar vazio.

Imagem 8 - Seção Opções avançadas expandida com o campo Headers.

---

🔀 Saídas do módulo

O módulo tem duas saídas:

• Sucesso — a operação foi concluída. No caso da operação Buscar, o link temporário do arquivo fica disponível para os próximos módulos do fluxo.

• Erro — não foi possível concluir a operação (por exemplo, bucket inexistente, arquivo não encontrado, ou falha nas credenciais da integração).

Imagem 9 - Módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro.

---

💡 Caso de uso

Cenário: uma empresa quer guardar automaticamente o comprovante de pagamento que o cliente envia durante a conversa, e depois gerar um link temporário para consultá-lo.

Configuração:

1. Adicione o módulo Firebase Cloud Storage ao fluxo, logo após o ponto em que o cliente envia o arquivo do comprovante.

2. Selecione a integração Firebase já cadastrada e o Bucket do projeto.

3. Na Operação, selecione Criar.

4. No campo Caminho do arquivo, informe algo como comprovantes/{{input.protocol}}.pdf.

5. No campo Arquivo, informe a variável do fluxo com o arquivo recebido do cliente.

6. Em outro momento do fluxo, adicione um segundo módulo Firebase Cloud Storage com a Operação Buscar, usando o mesmo Caminho do arquivo, para gerar o link temporário de consulta.

Resultado: o comprovante é salvo automaticamente no bucket do Firebase, e o fluxo consegue gerar um link temporário sempre que precisar acessá-lo.

---

📌 Dicas úteis

• Organize os caminhos dos arquivos em pastas (por exemplo, comprovantes/2026/07/arquivo.pdf) para manter o bucket organizado e mais fácil de consultar depois.

• O link gerado pela operação Buscar expira em 1 hora — use-o logo em seguida ou gere um novo link quando precisar acessar o arquivo novamente.

• Sempre conecte a saída Erro a algum tratamento, já que operações de armazenamento podem falhar por diversos motivos (bucket inexistente, arquivo não encontrado, credenciais inválidas).

• Se aparecer um erro relacionado a permissão, revise as permissões da integração Firebase cadastrada.

• Evite usar dados sensíveis diretamente no Caminho do arquivo, já que esse valor pode aparecer em registros do fluxo.

---

📝 Resumo

• O módulo Firebase Cloud Storage envia, substitui, busca e exclui arquivos em um Bucket do Firebase.

• O campo Bucket carrega automaticamente os buckets já existentes no projeto Firebase vinculado à integração.

• O campo Arquivo aceita tanto um arquivo já recebido no fluxo quanto um link — quando é um link, o próprio módulo faz o download antes de salvar.

• A operação Buscar gera um link temporário de download válido por 1 hora, não uma lista de arquivos do bucket.

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