Upload de Arquivos
O Leavo permite fazer upload de imagens, áudios, vídeos e documentos para uso em mensagens e conversas.
Imagens
.jpg, .jpeg, .pngMáx: 10 MB (compressão automática acima de 2 MB)
Áudio
.mp3, .wav, .ogg, .m4aMáx: 10 MB
Vídeo
.mp4, .webm, .aviMáx: 10 MB
Documentos
.pdf, .doc, .docx, .xls, .xlsx, .csv, .txtMáx: 10 MB
Fluxo de Upload
Envie o arquivo
Faça um POST /backend/uploads com o arquivo em multipart/form-data.
Receba a URL
A API retorna os metadados do arquivo, incluindo a file_url pública.
Use em mensagens
Utilize a file_url para enviar mídia em mensagens ou referenciá-la em outros contextos.
Compressão Automática de Imagens
Imagens maiores que 2 MB são automaticamente comprimidas:
- Dimensão máxima: 1920 x 1920 pixels (mantendo proporção)
- Qualidade: 85% (JPEG)
- Formato de saída: JPEG
Status do Upload
| Status | Descrição |
|---|
PENDING | Upload realizado, ainda não vinculado a nenhuma entidade |
ASSOCIATED | Upload vinculado a uma mensagem ou conversa |
Uploads com status PENDING por mais de 24 horas podem ser automaticamente removidos pelo processo de limpeza.
Endpoints
| Método | Endpoint | Descrição |
|---|
POST | /backend/uploads | Upload de arquivo |
GET | /backend/uploads/{id} | Obter upload por ID |
GET | /backend/uploads/tenant/{tenantId} | Listar uploads do tenant |
DELETE | /backend/uploads/{id} | Excluir upload |
PUT | /backend/uploads/{id}/status | Atualizar status |
POST | /backend/uploads/cleanup | Limpar uploads órfãos |
