# Media
Enviar, baixar e excluir arquivos de mídia. Tipos suportados incluem imagens, vídeos, áudio, documentos e figurinhas.
## Enviar arquivo de mídia
> Envia arquivos de mídia para os servidores do WhatsApp para uso em mensagens.\
> A mídia enviada fica armazenada nos servidores da Meta e pode ser referenciada pelo ID retornado.\
> \
> \## Tipos de Arquivo Suportados\
> \
> \| Tipo | Formatos | Tamanho Máx |\
> \|------|----------|-------------|\
> \| Imagem | JPEG, PNG | 5 MB |\
> \| Vídeo | MP4, 3GPP | 16 MB |\
> \| Áudio | AAC, MP3, MP4, AMR, OGG | 16 MB |\
> \| Documento | PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT | 100 MB |\
> \| Figurinhas | WEBP (estática), WEBM (animada) | 500 KB (estática), 1 MB (animada) |\
> \
> \## Observações Importantes\
> \
> \- Arquivos de mídia são armazenados por 30 dias e depois excluídos automaticamente\
> \- O ID retornado é único para a conta WhatsApp Business\
> \- Para melhor entrega, a compactação de imagens e vídeos é recomendada antes do envio\
> \- Figurinhas devem ter exatamente 512x512 pixels com fundo transparente\
> \- Arquivos de áudio são convertidos automaticamente para Opus pelo WhatsApp
```json
{"openapi":"3.0.3","info":{"title":"Fortics BSP - API do WhatsApp Business","version":"1.2.0"},"tags":[{"name":"media","description":"Enviar, baixar e excluir arquivos de mídia. Tipos suportados incluem\nimagens, vídeos, áudio, documentos e figurinhas.\n"}],"servers":[{"url":"{baseUrl}","description":"Servidor da API BSP","variables":{"baseUrl":{"default":"https://waba.fortics.com.br/v1","description":"URL base da API - Use a URL do servidor que lhe foi atribuída"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"Chave de API para autenticação"}},"responses":{"MediaUpload":{"description":"Mídia enviada com sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único da mídia enviada"}}}}}},"Unauthorized":{"description":"Não autorizado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}}},"schemas":{"UnauthorizedResponse":{"type":"object","description":"Resposta de erro para falhas de autenticação. Verifique a configuração da chave de API se receber esta resposta.\n","properties":{"message":{"type":"string","description":"Mensagem de erro legível descrevendo a falha de autenticação.\nCausas comuns:\n- Chave de API não incluída na requisição\n- Chave de API inválida ou expirada\n- Chave de API sem permissão para esta operação\n"},"code":{"type":"string","description":"Código de erro para tratamento programático"}}}}},"paths":{"/media":{"post":{"tags":["media"],"summary":"Enviar arquivo de mídia","description":"Envia arquivos de mídia para os servidores do WhatsApp para uso em mensagens.\nA mídia enviada fica armazenada nos servidores da Meta e pode ser referenciada pelo ID retornado.\n\n## Tipos de Arquivo Suportados\n\n| Tipo | Formatos | Tamanho Máx |\n|------|----------|-------------|\n| Imagem | JPEG, PNG | 5 MB |\n| Vídeo | MP4, 3GPP | 16 MB |\n| Áudio | AAC, MP3, MP4, AMR, OGG | 16 MB |\n| Documento | PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT | 100 MB |\n| Figurinhas | WEBP (estática), WEBM (animada) | 500 KB (estática), 1 MB (animada) |\n\n## Observações Importantes\n\n- Arquivos de mídia são armazenados por 30 dias e depois excluídos automaticamente\n- O ID retornado é único para a conta WhatsApp Business\n- Para melhor entrega, a compactação de imagens e vídeos é recomendada antes do envio\n- Figurinhas devem ter exatamente 512x512 pixels com fundo transparente\n- Arquivos de áudio são convertidos automaticamente para Opus pelo WhatsApp\n","operationId":"uploadMedia","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary","description":"Conteúdo binário do arquivo de mídia a ser enviado.\nDeve ser um dos tipos de arquivo suportados listados acima.\n"}}}}}},"responses":{"201":{"$ref":"#/components/responses/MediaUpload"},"401":{"$ref":"#/components/responses/Unauthorized"},"413":{"description":"Tamanho de arquivo excede o limite máximo permitido","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"415":{"description":"Tipo de mídia não suportado","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```
## Baixar arquivo de mídia
> Recupera e baixa um arquivo de mídia enviado anteriormente usando o ID único.\
> \
> \## Comportamento da Resposta\
> \
> \- Retorna o conteúdo binário do arquivo com o cabeçalho Content-Type apropriado\
> \- O cabeçalho Content-Disposition informa o nome do arquivo original quando disponível\
> \- Se a mídia estiver expirada (após 30 dias), retorna HTTP 404\
> \
> \## Casos de Uso\
> \
> \- Download de mídias enviadas por usuários em mensagens recebidas\
> \- Recuperação de mídia enviada anteriormente para verificação\
> \- Backup do conteúdo antes da expiração de 30 dias\
> \
> \## Origem do Media ID\
> \
> IDs de mídia são obtidos a partir de:\
> \- Resposta do endpoint de upload de mídia\
> \- Webhooks de mensagens recebidas que contenham mídia\
> \- Webhooks de status de mensagens com referências de mídia
```json
{"openapi":"3.0.3","info":{"title":"Fortics BSP - API do WhatsApp Business","version":"1.2.0"},"tags":[{"name":"media","description":"Enviar, baixar e excluir arquivos de mídia. Tipos suportados incluem\nimagens, vídeos, áudio, documentos e figurinhas.\n"}],"servers":[{"url":"{baseUrl}","description":"Servidor da API BSP","variables":{"baseUrl":{"default":"https://waba.fortics.com.br/v1","description":"URL base da API - Use a URL do servidor que lhe foi atribuída"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"Chave de API para autenticação"}},"parameters":{"MediaId":{"name":"MEDIA_ID","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Identificador único do arquivo de mídia nos servidores do WhatsApp.\n\nObtido a partir de:\n- Resposta do endpoint de upload de mídia\n- Webhooks de mensagens recebidas que contenham mídia\n- Webhooks de status de mensagens com referências de mídia\n\nIDs de mídia são strings numéricas e são válidos por 30 dias após o upload.\n"}},"responses":{"Unauthorized":{"description":"Não autorizado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}}},"schemas":{"UnauthorizedResponse":{"type":"object","description":"Resposta de erro para falhas de autenticação. Verifique a configuração da chave de API se receber esta resposta.\n","properties":{"message":{"type":"string","description":"Mensagem de erro legível descrevendo a falha de autenticação.\nCausas comuns:\n- Chave de API não incluída na requisição\n- Chave de API inválida ou expirada\n- Chave de API sem permissão para esta operação\n"},"code":{"type":"string","description":"Código de erro para tratamento programático"}}}}},"paths":{"/media/{MEDIA_ID}":{"get":{"tags":["media"],"summary":"Baixar arquivo de mídia","description":"Recupera e baixa um arquivo de mídia enviado anteriormente usando o ID único.\n\n## Comportamento da Resposta\n\n- Retorna o conteúdo binário do arquivo com o cabeçalho Content-Type apropriado\n- O cabeçalho Content-Disposition informa o nome do arquivo original quando disponível\n- Se a mídia estiver expirada (após 30 dias), retorna HTTP 404\n\n## Casos de Uso\n\n- Download de mídias enviadas por usuários em mensagens recebidas\n- Recuperação de mídia enviada anteriormente para verificação\n- Backup do conteúdo antes da expiração de 30 dias\n\n## Origem do Media ID\n\nIDs de mídia são obtidos a partir de:\n- Resposta do endpoint de upload de mídia\n- Webhooks de mensagens recebidas que contenham mídia\n- Webhooks de status de mensagens com referências de mídia\n","operationId":"downloadMedia","parameters":[{"$ref":"#/components/parameters/MediaId"}],"responses":{"200":{"description":"Arquivo de mídia recuperado com sucesso","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}},"image/*":{"schema":{"type":"string","format":"binary"}},"video/*":{"schema":{"type":"string","format":"binary"}},"audio/*":{"schema":{"type":"string","format":"binary"}},"application/*":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Mídia não encontrada ou expirada","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```
## Excluir arquivo de mídia
> Exclui permanentemente um arquivo de mídia dos servidores do WhatsApp usando o Media ID.\
> \
> \## Considerações Importantes\
> \
> \- A ação é irreversível e a mídia excluída não pode ser recuperada\
> \- A exclusão não afeta mensagens já entregues\
> \- Mensagens que referenciam mídia excluída exibem "Mídia não disponível"\
> \- Recomenda-se excluir mídias sensíveis após o uso por conformidade de segurança\
> \
> \## Quando Excluir Mídia\
> \
> \- Após confirmação de entrega bem-sucedida da mensagem\
> \- Quando a mídia contiver informações sensíveis\
> \- Para liberar cota de armazenamento (quando aplicável)\
> \- Para atender a requisitos de privacidade/GDPR
```json
{"openapi":"3.0.3","info":{"title":"Fortics BSP - API do WhatsApp Business","version":"1.2.0"},"tags":[{"name":"media","description":"Enviar, baixar e excluir arquivos de mídia. Tipos suportados incluem\nimagens, vídeos, áudio, documentos e figurinhas.\n"}],"servers":[{"url":"{baseUrl}","description":"Servidor da API BSP","variables":{"baseUrl":{"default":"https://waba.fortics.com.br/v1","description":"URL base da API - Use a URL do servidor que lhe foi atribuída"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"Chave de API para autenticação"}},"parameters":{"MediaId":{"name":"MEDIA_ID","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Identificador único do arquivo de mídia nos servidores do WhatsApp.\n\nObtido a partir de:\n- Resposta do endpoint de upload de mídia\n- Webhooks de mensagens recebidas que contenham mídia\n- Webhooks de status de mensagens com referências de mídia\n\nIDs de mídia são strings numéricas e são válidos por 30 dias após o upload.\n"}},"responses":{"DeleteMedia":{"description":"Mídia excluída com sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a exclusão foi bem-sucedida"}}}}}},"Unauthorized":{"description":"Não autorizado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponse"}}}}},"schemas":{"UnauthorizedResponse":{"type":"object","description":"Resposta de erro para falhas de autenticação. Verifique a configuração da chave de API se receber esta resposta.\n","properties":{"message":{"type":"string","description":"Mensagem de erro legível descrevendo a falha de autenticação.\nCausas comuns:\n- Chave de API não incluída na requisição\n- Chave de API inválida ou expirada\n- Chave de API sem permissão para esta operação\n"},"code":{"type":"string","description":"Código de erro para tratamento programático"}}}}},"paths":{"/media/{MEDIA_ID}":{"delete":{"tags":["media"],"summary":"Excluir arquivo de mídia","description":"Exclui permanentemente um arquivo de mídia dos servidores do WhatsApp usando o Media ID.\n\n## Considerações Importantes\n\n- A ação é irreversível e a mídia excluída não pode ser recuperada\n- A exclusão não afeta mensagens já entregues\n- Mensagens que referenciam mídia excluída exibem \"Mídia não disponível\"\n- Recomenda-se excluir mídias sensíveis após o uso por conformidade de segurança\n\n## Quando Excluir Mídia\n\n- Após confirmação de entrega bem-sucedida da mensagem\n- Quando a mídia contiver informações sensíveis\n- Para liberar cota de armazenamento (quando aplicável)\n- Para atender a requisitos de privacidade/GDPR\n","operationId":"deleteMedia","parameters":[{"$ref":"#/components/parameters/MediaId"}],"responses":{"200":{"$ref":"#/components/responses/DeleteMedia"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Mídia não encontrada ou já excluída","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.fortics.com.br/bsp-api-reference/reference/media.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.