# Downloads

> O espaço que compartilha arquivos (planilhas, e-books, PDFs, modelos) num repositório ou num arquivo só, grátis, vendido ou incluído no plano. Quem envia, a aprovação, o carimbo nos PDFs, Meus downloads e os contadores da equipe.

O módulo **Downloads** é o lugar de distribuir arquivos para a comunidade: uma planilha, um e-book, um PDF, um modelo, um pacote ZIP. O espaço pode ser um **repositório** (vários itens, cada um com um ou mais arquivos) ou um **arquivo só**. Cada item é grátis para quem vê o espaço, vendido por um [produto](/monetizacao/produtos) ou incluído num [plano](/monetizacao/planos).

Os arquivos ficam guardados em área **privada**. Ninguém recebe um endereço permanente: cada download gera, na hora, um link que vale **5 minutos**.

## Para que serve

| Comunidade | Downloads |
|---|---|
| Escola online | O e-book do curso, vendido à parte, e a planilha de exercícios, grátis para os alunos |
| Associação | Atas, estatutos e modelos de documento, só para os associados |
| Consultoria | Um kit de modelos em ZIP, incluído no plano premium |
| Coworking | O manual da casa, em PDF, num espaço de um arquivo só |

## Como funciona

### Repositório ou um arquivo só

Na criação do espaço, o passo **Como o espaço funciona** pede o modo:

| Modo | O que o espaço mostra |
|---|---|
| **Repositório** (padrão) | Vários itens, cada um com um ou mais arquivos, filtráveis por categoria. Não há limite de itens nem de arquivos por item |
| **Um arquivo só** | O espaço mostra um único arquivo, direto. Para trocá-lo, **substitua** o arquivo: um segundo item ou um segundo arquivo é recusado |

Em **Repositório**, as **categorias** são opcionais (a tela sugere *Planilhas*, *E-books* e *Modelos*). Cada item tem no máximo uma categoria, e uma categoria que tem itens só pode ser removida depois de mover ou apagar esses itens.

### O item

| Campo | Para quê |
|---|---|
| **Título** | Obrigatório |
| **Descrição** | Texto formatado |
| **Capa** | Opcional. JPG, PNG, WEBP ou GIF, até 20 MB |
| **Categoria** | Uma das categorias do espaço (só no repositório) |
| **Arquivos** | Os arquivos do item, enviados na página dele |
| **Carimbar PDFs** | Ver [Carimbar PDFs](#carimbar-pdfs) |

Um item novo nasce em **Rascunho** (só a equipe e o autor veem). **Publicar** exige pelo menos **um arquivo**. Despublicar devolve o item a rascunho.

### Arquivos aceitos

| Tipo | Formatos |
|---|---|
| Imagens | PNG, JPG, WEBP, GIF |
| Planilhas | XLS, XLSX, ODS, CSV |
| PDF | PDF |
| Documentos | DOC, DOCX, ODT, TXT, MD, PPT, PPTX |
| Compactados | ZIP |

- **Até 200 MB por arquivo.** Não há limite de quantidade de arquivos.
- **Nenhum executável** e nenhum outro tipo de arquivo. A Memberfy confere o **conteúdo** do arquivo, não só a extensão: um executável renomeado para `.pdf` é recusado e apagado.
- O envio vai direto do seu navegador para o armazenamento, com barra de progresso, e dá para enviar vários arquivos de uma vez, arrastando.
- Os arquivos entram na conta de armazenamento da comunidade, que **só avisa** quando passa do limite: o armazenamento nunca bloqueia um envio.
- Cada pessoa pode fazer até **60 envios de mídia por hora** (arquivos de Downloads e outras mídias hospedadas); passado disso, a tela pede para tentar de novo mais tarde.
- **Substituir** põe outro arquivo no lugar; **Remover** pede confirmação (*"Quem já baixou fica com a cópia."*). Quem baixar depois recebe o arquivo novo. Remover o último arquivo de um item publicado o devolve a rascunho.
- A ordem dos arquivos muda com **Subir** e **Descer**.

### Quem envia e quem configura

| Ação | Quem |
|---|---|
| Configurar o espaço (modo, categorias, aprovação) | Proprietário e administrador |
| Criar item e enviar arquivos | Quem o **Quem pode postar** do espaço permite. Por padrão, só a equipe (proprietário, administrador, moderador e financeiro), também quando o espaço é criado pela API ou pelo assistente |
| Editar, trocar arquivos, publicar e apagar um item | O autor do item e a equipe |
| Baixar | Quem tem acesso ao item, como descrito em [Quem baixa](#quem-baixa) |
| Ver os contadores | A equipe |

O proprietário e o administrador podem liberar o envio para os **membros** em **Quem pode postar**. Isso soma a regra de acesso do espaço: quem não vê o espaço não envia nem baixa.

### Aprovação dos itens dos membros

Com **Analisar os itens dos membros** ligado na configuração do espaço, o item criado por um membro fica **Em análise**, invisível para os outros, até a equipe decidir pela fila de [moderação](/membros/moderacao). A aba **Em análise** do espaço mostra a fila.

- **Aprovar** publica o item **na hora**, se ele já tem arquivo (o autor não precisa publicar de novo).
- **Recusar** pede o motivo, e o autor é avisado.
- **Editar** um item publicado de um membro o **devolve para análise**.
- Os itens da equipe não passam pela fila.

### Preço e venda

Cada item nasce com um **produto** ligado a ele, em rascunho e **gratuito**. Na página do item, a equipe vê a faixa **Preço e venda**, que abre o produto para definir preço, estoque, planos e publicar. Esse produto tem o tipo **Download** e não se apaga à parte: apagar o item arquiva o produto. Ver [Tipos de produto](/monetizacao/produtos#tipos-de-produto).

### Quem baixa

| Situação do item | Quem baixa |
|---|---|
| Sem preço (produto em rascunho, inativo ou de preço zero) | Qualquer pessoa que veja o espaço |
| Com preço e produto publicado | Quem **comprou** (compra confirmada e ativa) e quem tem um **plano que inclui o produto** |
| Sempre | A equipe e o autor do item |

- **Quem não tem acesso** vê o item com um cadeado: título, capa, preço e o botão **Comprar**, sem os nomes dos arquivos e sem link.
- **Reembolso, contestação (chargeback), fim do prazo de acesso e saída do plano** fecham o acesso a novos downloads. Quem já baixou fica com a cópia que tem, mas **ter baixado antes não garante acesso**: vale só a regra de agora.
- **Item que era grátis e passa a ter preço:** quem não comprou e não tem um plano que o inclua passa a precisar comprar, mesmo que já tenha baixado antes.
- **Estoque (opcional):** se o produto tem estoque e acaba, o item aparece como esgotado e entra a [lista de espera](/monetizacao/produtos#vagas-e-lista-de-espera). Com estoque definido, até um item de preço zero passa por uma confirmação de "obter grátis" para tomar a unidade.
- O e-mail de confirmação da compra de um download leva a **Meus downloads** (pede login), nunca a um link de arquivo.

### Meus downloads

Cada membro vê o que pode baixar em **Faturamento › Minhas compras › Meus downloads**: os itens comprados, incluídos no plano ou gratuitos, com a origem do acesso (**Comprado**, **No seu plano**, **Grátis**), a data da compra, o último download e, quando há prazo, *"Acesso até"*. A lista só mostra o que a pessoa realmente pode baixar, nas datas no fuso da comunidade.

### Carimbar PDFs

Em **Editar** o item, quem gerencia o item que tem pelo menos um PDF vê o interruptor **Carimbar PDFs** (desligado por padrão). Ligado, **quem baixar um PDF** recebe uma **cópia** com uma linha pequena, em cinza, no rodapé da **última página**: *"Baixado por {e-mail} em {data e hora}"*, no fuso da comunidade.

- **A equipe e o autor baixam sem carimbo**, para conferir o arquivo. O original nunca é alterado.
- **PDF acima de 25 MB**, protegido por senha ou corrompido sai **sem carimbo**, e o download funciona normalmente.
- Outros tipos de arquivo não recebem carimbo.
- O carimbo **ajuda a rastrear um vazamento, mas não o impede**: quem tem o arquivo pode compartilhá-lo.

### Contadores para a equipe

Na página do item, a equipe vê quantos downloads houve, em total e por pessoas diferentes, por item e por arquivo, e a data do último. Os downloads da própria equipe não entram na conta. O membro não vê contadores. Os números mostram quantos, não quem.

## Passo a passo

### Criar o espaço

*Papel: proprietário ou administrador.*

1. Em **Adicionar Espaço**, escolha o módulo **Downloads**.
2. No passo **Como o espaço funciona**, escolha **Repositório** ou **Um arquivo só**.
3. No repositório, acrescente as **Categorias** (opcional) e, se os membros forem enviar, ligue **Analisar os itens dos membros**.
4. Defina a visibilidade e **Quem pode postar**, e crie o espaço.

Para mudar o modo, as categorias ou a aprovação depois, use **Configurar o espaço** na barra **Gestão do espaço**. Passar para **Um arquivo só** com um item de dois arquivos ou mais é recusado.

### Criar um item e enviar os arquivos

*Papel: quem o espaço deixa criar.*

1. No espaço, clique em **Novo download** (no modo de um arquivo, **Adicionar o arquivo**).
2. Preencha **Título**, **Descrição**, **Categoria** e a **Capa**, e clique em **Criar e adicionar arquivos**.
3. Na página do item, em **Arquivos**, arraste os arquivos ou use **Escolher arquivos**.
4. Quando todos terminarem, clique em **Publicar**.

### Vender o item

*Papel: proprietário ou administrador.*

1. Na página do item, clique em **Preço e venda**.
2. Defina o **Preço** e, se quiser, o estoque, os planos em que o item é incluído e publique o produto. Ver [Produtos](/monetizacao/produtos). Publicar um produto com preço pede a [Informação Comercial](/pagamentos/informacao-comercial) aprovada; produto gratuito não pede.
3. Quem não tem acesso passa a ver o preço e **Comprar**.

### Baixar

1. Abra o item e clique em **Baixar** ao lado do arquivo (*"O link de download é gerado quando você clica e vale por 5 minutos."*).
2. Para rever o que você tem, abra **Meus downloads**.

## Exemplos

**E-book do curso.** Espaço **Materiais** (Repositório, visibilidade **Privada**). O item *E-book Excel do Zero* é publicado com preço de R$ 29. Os alunos veem o cadeado e **Comprar · R$ 29,00**; quem comprou baixa. O item *Planilha de exercícios*, sem preço, é de todos os alunos.

**Manual da casa.** Espaço **Manual** no modo **Um arquivo só**: só a equipe envia, e todo membro baixa o PDF. Para publicar uma versão nova, a equipe usa **Substituir** no arquivo.

**Modelos dos associados.** Repositório com a categoria *Modelos*. O administrador libera o envio aos membros e liga a análise: o modelo enviado por um associado só aparece depois que a equipe aprova.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *Esse tipo de arquivo não é aceito. Use PDF, planilhas, documentos, imagens ou ZIP.* | Converta para um dos formatos aceitos |
| *O arquivo tem mais de …* | O limite é de 200 MB por arquivo; reduza ou divida |
| *O arquivo está vazio.* | Escolha outro arquivo |
| *Você ainda não tem acesso a este arquivo.* | O item é pago: compre, ou use o plano que o inclui |
| *Este item está esgotado.* | Entre na lista de espera |
| *Downloads demais em pouco tempo. Tente de novo em alguns minutos.* | Espere alguns minutos |
| O botão **Publicar** não funciona | Envie pelo menos um arquivo antes |
| O membro não vê **Novo download** | O **Quem pode postar** do espaço é só da equipe |

## Perguntas frequentes

**O link do arquivo pode ser compartilhado?**
Ele vale 5 minutos e é gerado para quem clicou. Quem quiser rastrear a origem de um vazamento de PDF pode ligar o [carimbo](#carimbar-pdfs).

**Posso vender um arquivo sem criar um produto?**
Não: todo item tem o seu produto, em rascunho e gratuito, e o preço é definido nele.

**Quem comprou o item perde o acesso se eu trocar o arquivo?**
Não. O arquivo novo vale para os próximos downloads; o acesso continua.

**Dá para baixar todos os arquivos de um item de uma vez?**
Ainda não: cada arquivo tem o seu botão.

**Há antivírus?**
Não. A Memberfy bloqueia executáveis e confere o tipo pelo conteúdo, mas não varre os arquivos em busca de vírus.

## Pelo assistente

O assistente configura o espaço, cria os itens, envia os arquivos (por link ou arquivo), publica, mostra os contadores e, para quem baixa, lista os downloads e entrega o link de 5 minutos. Ver [Ferramentas · Downloads](/mcp/ferramentas-downloads).

## Na API

`GET` e `PUT /api/downloads/spaces/{spaceId}` (modo, categorias, aprovação); `GET` e `POST /api/downloads/items`, `GET`, `PUT` e `DELETE /api/downloads/items/{id}`; os arquivos em `/api/downloads/items/{id}/files` (`upload-url`, `confirm`, `reorder`, `{fileId}/replace` e `DELETE {fileId}`); `POST /api/downloads/files/{fileId}/download` (devolve o link de 5 minutos e `stamped`); `GET /api/me/downloads`; `GET /api/downloads/items/{id}/stats`; e a fila `GET /api/moderation/downloads/pending`. A comunidade vem do cabeçalho `X-CommunityId`. O produto 1:1 vem no campo `product` do item.

## Relacionados

- [Produtos](/monetizacao/produtos)
- [Planos](/monetizacao/planos)
- [Moderação](/membros/moderacao)
- [Módulos](/conceitos/modulos)
- [Faturamento do membro](/pagamentos/faturamento-do-membro)