> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/firebase-cloud-storage.md).

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

<figure><img src="/files/6PEfkfsemzUtvct8uHmc" alt=""><figcaption><p>Imagem 1 - Exemplo do módulo Firebase Cloud Storage.</p></figcaption></figure>

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

<figure><img src="/files/QCk8KeK4B7fBsnWoy9v9" alt=""><figcaption><p>Imagem 2 - Painel de configuração do módulo Firebase Cloud Storage aberto.</p></figcaption></figure>

***

#### 🔌 Integração

Selecione a integração Firebase já cadastrada.

<figure><img src="/files/I15gmLEGG1EIDIJWPnsY" alt=""><figcaption><p>Imagem 3 - Campo Integração com a credencial Firebase selecionada.</p></figcaption></figure>

***

#### 🪣 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.

<figure><img src="/files/GbaVMcNJwthxDJxdY49Z" alt=""><figcaption><p>Imagem 4 - Campo Bucket com a lista de buckets carregada automaticamente.</p></figcaption></figure>

{% hint style="warning" %}
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.
{% endhint %}

***

#### 🧩 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.

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="/files/bVx4oDg0sJv0LihsrCVj" alt=""><figcaption><p>Imagem 5 - Campo Operação com as opções disponíveis.</p></figcaption></figure>

***

#### 📄 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.

<figure><img src="/files/WM1mH1iMfEJ9RXlsGqKu" alt=""><figcaption><p>Imagem 6 - Campo Caminho do arquivo preenchido com um exemplo de caminho.</p></figcaption></figure>

***

#### 📎 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.

<figure><img src="/files/RJ2LU8rl1YGM2X7URXPd" alt=""><figcaption><p>Imagem 7 - Campo Arquivo preenchido com uma variável do fluxo.</p></figcaption></figure>

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.

<figure><img src="/files/8J1ZgHkn2wBznsLesw5c" alt=""><figcaption><p>Imagem 8 - Seção Opções avançadas expandida com o campo Headers.</p></figcaption></figure>

***

#### 🔀 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).

<figure><img src="/files/55bJRTbHbAu1a4T4jxbn" alt=""><figcaption><p>Imagem 9 - Módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro.</p></figcaption></figure>

***

### 💡 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**.