Pular para o conteúdo principal
A galeria é a biblioteca de mídia da sua conta: imagens, vídeos, áudios e documentos que a equipe reutiliza no painel, por exemplo nos atendimentos e nas campanhas. Use os endpoints abaixo para manter a galeria sincronizada com uma biblioteca de arquivos externa (DAM, CMS etc.). Todas as requisições exigem o cabeçalho Authorization: Bearer {BearerToken}.

Enviar arquivo para a galeria

O envio é um formulário (multipart/form-data), não JSON. Exemplo com cURL:
A resposta traz, em data, um item por arquivo enviado, com o id (use-o para excluir), originalName, fileName (nome gerado pelo sistema), fileType, mimeType, fileSize, description e mediaUrl (endereço público do arquivo).
Se a pasta for excluída durante o envio, os arquivos já salvos ficam sem pasta e os demais não são salvos: a rota responde 400 ERR_GALLERY_FOLDER_NOT_FOUND. Confira na listagem o que entrou antes de reenviar.

Listar arquivos da galeria

Na resposta, ao lado de pagination, vem folderFilter: o filtro de pasta que a rota entendeu (all, none ou o id da pasta). Cada arquivo traz folderId (null = sem pasta). Se a resposta não trouxer folderFilter, as pastas da galeria ainda não estão ativas e o folderId foi ignorado: vêm todos os arquivos.

Listar pastas da galeria

Retorna as pastas da galeria em ordem alfabética, com a quantidade de arquivos de cada uma. As pastas são criadas e organizadas no painel, na tela Galeria (botão Nova pasta).
Use o id de uma pasta no folderId da listagem de arquivos, para ver só os arquivos dela, e do envio de arquivos, para enviar os arquivos direto para ela.

Excluir arquivo da galeria

Nenhum corpo de requisição é necessário.
A exclusão é permanente. Confirme o id pela listagem antes de excluir.

Resposta Padrão

Exemplo de gallery/list:
Em gallery/list, data é a lista de arquivos da página, e a paginação vem fora dele, em pagination: total (quantidade de arquivos) e hasMore (true quando há mais páginas). Ao lado de pagination vem folderFilter, o filtro de pasta aplicado, e cada arquivo traz folderId (null = sem pasta). Em gallery/upload, data é a lista dos arquivos enviados. Em gallery/delete, data confirma a exclusão com deleted: true e o id do arquivo.