Runbook — Biblioteca de mídias

Recurso em Configurações → Bibliotecas, rota /library. A Biblioteca centraliza imagens, vídeos, áudios, documentos e stickers para uso manual, em fluxos e pela IA.

Navegação e operação

1. Abrir Configurações → Bibliotecas (/library).
2. Escolher a aba Imagens, Vídeos, Áudios, Documentos ou Stickers.
3. Usar busca e filtros por categoria, origem, sem descrição ou IA desligada.
4. Para inserir, clicar em upload direto (até 10 arquivos por envio), preencher descrição/categoria quando necessário e confirmar.
5. Categorias podem ter cor; crie, edite ou remova categorias antes de organizar lotes.
6. Ações em lote estão disponíveis para itens selecionados.

Mídias publicadas por fluxos aparecem automaticamente. No Flowbuilder, o bloco Conteúdo pode selecionar fonte Biblioteca, sem reupload.

Item, descrição e IA

• Nome: máximo de 255 caracteres.
• Descrição: máximo de 500 caracteres; é o texto que a IA usa para decidir o que mostrar e quando enviar.
• A IA não vê, ouve ou interpreta o arquivo diretamente; descreva produto, contexto, público e gatilho de envio.
• Switch IA pode usar controla a disponibilidade para o assistente.
• Badge IA significa descrição preenchida + IA ligada.
• Embedding pode ficar pendente; use reindexação quando necessário.

No editor do assistente, configure o vínculo em Biblioteca de mídias:

GET /assistents/{id}/library
PUT /assistents/{id}/library

{
  "libMediaEnabled": true,
  "libMediaMode": "on_request",
  "libMediaMaxPerReply": 1,
  "categoryIds": []
}

libMediaMode aceita on_request ou proactive; libMediaMaxPerReply aceita de 1 a 3. A IA envia o texto e depois a mídia. Canais: WhatsApp, WhatsApp Oficial e Instagram; Instagram permite apenas imagens e vídeos.

API da Biblioteca

Método	Rota	Uso
GET	/library/summary	Resumo/contagens
GET	/library/categories	Lista categorias
POST/PUT/DELETE	/library/categories	Gerenciar categorias
GET	/library/{type}	Listar mídias por tipo
POST	/library/{type}	Upload
PUT/DELETE	/library/{type}/{id}	Editar/excluir item
PATCH	/library/bulk	Ação em lote
POST	/library/reindex	Reindexar embeddings

Upload multipart:

POST /library/{type}
Content-Type: multipart/form-data

Campos: medias, descriptions e categoryId opcional.

Limites e formatos

• Até 10 arquivos por envio; 50 MB por arquivo.
• Imagens: image/*.
• Vídeos: video/*, incluindo mp4, mov, webm, mkv, avi.
• Áudios: audio/*, incluindo mp3, ogg, opus, wav, m4a, aac.
• Documentos: pdf, doc, docx, xls, xlsx, csv, txt, zip, rar, json, pptx.

Origem e exclusão

Origens observadas: flow, library e chat.

• Origem flow: excluir remove apenas o item da Biblioteca e preserva arquivo/fluxo.
• Origem library: excluir também apaga o arquivo do storage.
• Origem chat: trate como mídia importada do atendimento; confirme impacto antes de excluir.

Checklist seguro vs. disparador

Seguro: abrir/listar, buscar, filtrar, criar categoria, revisar descrição e consultar resumo. Upload é reversível enquanto o item não for usado em atendimento.

Disparador: ativar IA pode usar, alterar modo para proactive, aumentar limite por resposta, ações em lote, reindexar em massa e qualquer exclusão. Antes de executar, confirme canal, categoria, origem e impacto no storage; em produção, faça primeiro em uma mídia de teste.