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
- 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.
- 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.
- Os arquivos capturados são organizados em pastas por origem, seguindo a hierarquia caixa de entrada → contato → conversa, para você reencontrá-los pelo contexto.
- 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
- 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.
- 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).
- A operação é idempotente: rodar de novo não duplica nada — itens já presentes são apenas ignorados.
- 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.