Mídia

Para usar mídia em mensagens, o arquivo de mídia deve ser enviado para o endpoint de mídia. Após o upload ser concluído, você pode enviar uma mensagem referenciando o ID da mídia.

Quando uma mensagem de mídia é enviada, a mídia é armazenada nos servidores do WhatsApp por 7 dias. Se um usuário solicitar o download da mídia após 7 dias, os servidores do WhatsApp solicitarão o mesmo arquivo de mídia do cliente da API WhatsApp Business. Se a mídia foi removida, o usuário será notificado de que a mídia está indisponível. Não é seguro assumir que a mídia foi baixada apenas com base nos recibos de entrega e leitura. Geralmente, é seguro remover a mídia após 30 dias, mas você deve adotar uma estratégia que melhor se ajuste ao seu negócio.

nota

Se você estiver enfrentando problemas ao carregar sua imagem, isso pode ser causado por atributos ocultos no arquivo da imagem. Recomendamos usar o site imagecompressor.com para remover esses atributos e tentar novamente.

Enviando Mídia

$ curl -X POST https://whatsapp.turn.io/v1/media \
    -H 'Authorization: Bearer token' \
    -H 'Content-Type: image/jpeg' \
    --data-binary @caminho-do-seu-arquivo

> {
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

Para enviar mídia para o cliente da API WhatsApp Business, utilize o endpoint de mídia. O corpo do POST deve conter os dados binários da mídia e o cabeçalho Content-Type deve ser configurado para o tipo da mídia sendo enviada. Consulte a seção Tipos de Arquivos Suportados para informações sobre os tipos de arquivos compatíveis.

cuidado

O WhatsApp processa a mídia enviada. Embora o tamanho máximo do arquivo de mídia que pode ser enviado ao endpoint de mídia seja de 64 MB, existem limites de pós-processamento para os diversos tipos de mídia, conforme descrito na tabela de Limites de Tamanho de Mídia Pós-Processamento abaixo.

Uma resposta bem-sucedida retorna o campo id, que é a informação necessária para recuperar mensagens e enviar uma mensagem de mídia para seus clientes.

Tipos de Arquivos Suportados

Mídia	Tipos Suportados
`audio`	`audio/aac`, `audio/mp4`, `audio/mpeg`, `audio/amr`, `audio/ogg` (somente codecs opus, áudio base/ogg não é suportado)
`document`	`text/plain`, `application/pdf`, `application/vnd.ms-powerpoint`, `application/msword`, `application/vnd.ms-excel`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document`, `application/vnd.openxmlformats-officedocument.presentationml.presentation`, `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`
`image`	`image/jpeg`, `image/png`. As imagens devem ser 8-bit, RGB ou RGBA.
`sticker`	`image/webp`
`video`	`video/mp4`, `video/3gp`. Apenas o codec de vídeo H.264 e o codec de áudio AAC são suportados. Vídeos com uma única faixa de áudio ou sem faixa de áudio são suportados.

cuidado

Certifique-se de utilizar apenas os tipos de conteúdo suportados listados acima, já que a Turn.io garante apenas o envio e recebimento desses tipos de conteúdo.

Limites de Tamanho de Mídia Pós-Processamento

Os seguintes limites de tamanho pós-processamento são impostos pelo WhatsApp nos diversos tipos de mídia. O WhatsApp não entregará mensagens com arquivos de mídia cujo tamanho pós-processamento exceda os limites descritos abaixo.

Tipo de Mídia	Tamanho
áudio	16 MB
documento	100 MB
imagem	5 MB
sticker animado	500 KB
sticker estático	100 KB
vídeo	16 MB

Stickers

Os stickers devem ter fundo transparente, dimensões de exatamente 512 x 512 pixels e tamanho inferior a 100 KB. Conforme indicado na tabela de Tipos de Arquivos Suportados, apenas arquivos no formato webp são aceitos. Outros tipos de arquivos podem ser transformados em webp online usando sites de conversão de arquivos como o cloudconvert.

Recuperando Mídia

$ curl -X GET https://whatsapp.turn.io/v1/media/id-da-midia

Após concluir com sucesso o Envio de Mídia, você receberá uma resposta contendo um ID de mídia. Esse ID será usado na solicitação para recuperar a mídia armazenada no cliente da API WhatsApp Business.

Recuperar mídia é particularmente útil quando um usuário carrega uma imagem enviada para o seu Webhook. Quando uma mensagem com mídia é recebida, o cliente da API WhatsApp Business fará o download da mídia. Após o download ser concluído, você receberá uma notificação por meio do webhook. Utilize o ID da mídia encontrado nessa notificação para recuperar a mídia.

Excluindo Mídia

Para excluir mídia no cliente da API WhatsApp Business, envie uma solicitação DELETE para o endpoint de mídia junto com o ID da mídia que deseja excluir. Use o ID obtido na resposta do Envio de Mídia ou de uma mensagem de mídia recebida via Webhook.

$ curl -X DELETE https://whatsapp.turn.io/v1/media/id-da-midia

Enviando Mídia​

Tipos de Arquivos Suportados​

Limites de Tamanho de Mídia Pós-Processamento​

Stickers​

Recuperando Mídia​

Excluindo Mídia​