Media

Enviar, baixar e excluir arquivos de mídia. Tipos suportados incluem imagens, vídeos, áudio, documentos e figurinhas.

Enviar arquivo de mídia

post

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

Autorizações

ApiKeyAuth

apikeystringObrigatório

Chave de API para autenticação

Corpo

multipart/form-data

filestring · binaryObrigatório

Conteúdo binário do arquivo de mídia a ser enviado. Deve ser um dos tipos de arquivo suportados listados acima.

Respostas

201

Mídia enviada com sucesso

application/json

401

Não autorizado.

application/json

413

Tamanho de arquivo excede o limite máximo permitido

application/json

415

Tipo de mídia não suportado

application/json

post

/media

HTTPcURLJavaScriptPython

POST /v1/media HTTP/1.1
Host: waba.fortics.com.br
apikey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

{
  "id": "1264826108109050"
}

Baixar arquivo de mídia

get

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

Autorizações

ApiKeyAuth

apikeystringObrigatório

Chave de API para autenticação

Parâmetros de rota

MEDIA_IDstringObrigatório

Identificador único do arquivo de mídia nos servidores do WhatsApp.

Obtido 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

IDs de mídia são strings numéricas e são válidos por 30 dias após o upload.

Example: 1264826108109050Pattern: ^[0-9]+$

Respostas

200

Arquivo de mídia recuperado com sucesso

application/octet-streamimage/*video/*audio/*application/*

Respostastring · binary

401

Não autorizado.

application/json

404

Mídia não encontrada ou expirada

application/json

get

/media/{MEDIA_ID}

HTTPcURLJavaScriptPython

GET /v1/media/{MEDIA_ID} HTTP/1.1
Host: waba.fortics.com.br
apikey: YOUR_API_KEY
Accept: */*

binary

Excluir arquivo de mídia

delete

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

Autorizações

ApiKeyAuth

apikeystringObrigatório

Chave de API para autenticação

Parâmetros de rota

MEDIA_IDstringObrigatório

Identificador único do arquivo de mídia nos servidores do WhatsApp.

Obtido 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

IDs de mídia são strings numéricas e são válidos por 30 dias após o upload.

Example: 1264826108109050Pattern: ^[0-9]+$

Respostas

200

Mídia excluída com sucesso

application/json

401

Não autorizado.

application/json

404

Mídia não encontrada ou já excluída

application/json

delete

/media/{MEDIA_ID}

HTTPcURLJavaScriptPython

DELETE /v1/media/{MEDIA_ID} HTTP/1.1
Host: waba.fortics.com.br
apikey: YOUR_API_KEY
Accept: */*

{
  "success": true
}