## Visão geral

A Biblioteca de Mídia é alimentada de duas formas complementares, e ambas **reaproveitam o mesmo
arquivo já existente na plataforma** — sem copiar nem duplicar espaço:

- **Captura automática**: salva sozinha as **mídias novas** que chegam (ou saem) nas conversas, à
  medida que acontecem. Você não precisa fazer nada — o arquivo entra na biblioteca já organizado.
- **Importação / backfill**: traz para a biblioteca as **mídias que já existem** em conversas
  antigas, no CRM, nas tarefas e no catálogo. É a "varredura do passado": popula a biblioteca de uma
  vez com tudo o que a conta já acumulou.

Em resumo: a **captura** cuida do que é novo, a **importação** cuida do que já existe. As duas
apontam para o mesmo arquivo original, então nada é baixado de novo e o armazenamento não cresce por
causa delas.

## Pré-requisitos

- O módulo **Biblioteca de Mídia** habilitado para a sua conta (recurso opcional, controlado por
  flag). Se você não encontrar a Biblioteca na navegação, fale com um administrador.
- **Ler** as configurações de captura, importação e retenção é permitido a **agentes**.
- **Alterar** essas configurações e **disparar a importação** (que é uma operação pesada) são ações
  restritas a **administradores**.
- O limite de armazenamento da conta é definido pelo operador da plataforma.

## Passo a passo

### Captura automática

1. Por padrão, a captura está **ligada para todas as conexões**: qualquer mídia nova das conversas é
   salva na biblioteca automaticamente, sem seleção manual.
2. Se preferir um controle mais fino, um administrador pode **desligar** a captura geral e escolher
   **caixas de entrada específicas** (opt-in por inbox): só as conexões selecionadas passam a capturar.
3. Os arquivos capturados são **organizados em pastas por origem**, seguindo a hierarquia
   **caixa de entrada → contato → conversa**, para você reencontrá-los pelo contexto.
4. A captura é **deduplicada**: um mesmo arquivo (mesmo conteúdo) **não é salvo duas vezes** — se a
   mensagem for reenviada ou reprocessada, a biblioteca ignora a repetição.

### Importação / backfill

1. Em uma conta que já vinha sendo usada, um administrador pode **disparar a importação** das mídias
   antigas com um único clique (ação de administrador) para popular a biblioteca de uma vez.
2. A importação varre as mídias já existentes em **conversas, CRM, tarefas e catálogo** e as registra
   na biblioteca, reaproveitando o arquivo original (sem novo upload e sem ocupar espaço extra).
3. A operação é **idempotente**: rodar de novo **não duplica** nada — itens já presentes são apenas
   ignorados.
4. Além da importação única, há uma **varredura incremental** que roda periodicamente e olha **apenas
   os itens novos** desde a última passagem, mantendo a biblioteca em dia de forma barata.

## Configurações & opções

- **Captura para todas as conexões × lista de caixas**: ligada para todas por padrão; um administrador
  pode desligá-la e definir a lista de caixas que devem capturar (opt-in por inbox).
- **Limpeza automática da lixeira** (`auto_purge_trash_days`): itens na lixeira são removidos em
  definitivo após um período configurável — **padrão de 30 dias**. A limpeza usa o mesmo fluxo durável
  da exclusão manual: só conclui depois da confirmação do storage e preserva os históricos com placeholder.
  Se o mesmo arquivo ainda tiver um alias ativo ou dentro do próprio prazo de retenção, a limpeza adia
  aquele blob em vez de apagar o alias antes da hora.
- **Reorganização retroativa única**: na primeira varredura, os arquivos antigos que estavam soltos são
  re-arquivados na nova hierarquia de pastas **uma única vez**, sem repetir o processo depois.

## Casos de uso

- Uma operação que quer **todo arquivo de cliente salvo automaticamente**, sem depender de a equipe
  lembrar de guardar cada mídia.
- Uma conta antiga, cheia de histórico, que precisa **popular a biblioteca de uma vez** com tudo o que
  já trafegou em conversas, CRM, tarefas e catálogo.
- Restringir a captura apenas às **conexões oficiais** (opt-in por inbox), deixando caixas de teste de
  fora.

## Dicas, limites e boas práticas

- A captura roda **fora do caminho crítico** (de forma assíncrona): ela não atrasa o envio nem o
  recebimento das mensagens; o arquivo aparece na biblioteca logo em seguida.
- A **cota de armazenamento** é definida pelo operador da plataforma — acompanhe o medidor e arquive o
  que não usa mais.
- A importação completa de uma conta grande é **pesada**; prefira dispará-la em um **horário tranquilo**
  para não concorrer com o pico de atendimento.
- Como captura e importação **reaproveitam o mesmo arquivo**, é normal o espaço **não crescer** quando
  você reaproveita uma mídia que já estava na conta.

## Solução de problemas

- **A captura não aparece**: confirme se a captura geral está ligada ou se aquela **caixa está na lista
  de opt-in**; conexões fora da seleção não capturam.
- **A importação demorou**: ela é **assíncrona** e roda em segundo plano — em contas grandes leva
  alguns minutos; os itens vão surgindo aos poucos na biblioteca.
- **O espaço não cresceu após importar**: isso é **esperado** — a importação reutiliza o arquivo
  original, então não há duplicação nem aumento de armazenamento.
- **Rodei a importação duas vezes**: tudo bem — a operação é idempotente e **não duplica** os itens já
  importados.

## Veja também

- [Visão geral da Biblioteca de Mídia](/hc/ajuda/articles/media-overview-pt-br)
- [Biblioteca: pastas, lixeira e medidor de armazenamento](/hc/ajuda/articles/media-biblioteca-pastas-lixeira-medidor-pt-br)