Mídia

/v1/media

Use o nó media para carregar, recuperar ou excluir mídias.

Bordas

As seguintes bordas estão relacionadas ao nó:

Antes de começar

As mídias enviadas por meio de mensagens são armazenadas nos servidores do WhatsApp por 14 dias. Se um usuário fizer uma solicitação para baixar a mídia depois desse período, os servidores do WhatsApp solicitarão o mesmo arquivo de mídia do cliente local do WhatsApp Business. Se a mídia tiver sido removida, o usuário será notificado de que ela está indisponível.

Não é seguro supor que o download foi concluído apenas com base nos recibos de entrega e leitura. No geral, as mídias de saída podem ser removidas depois de 30 dias, mas use a estratégia que melhor se adapta à sua empresa.

Limitações

• Caso você use o processo de carregamento de mídia em vez de um link para a URL da mídia em questão, o arquivo precisará ser carregado no volume de mídia. Quando o carregamento for concluído, envie uma mensagem usando o ID de mídia.
• O aplicativo processa a mídia carregada antes que ela seja enviada ao servidor. O tamanho máximo da mídia que pode ser carregada no nó media é 100 MB. No entanto, há limites após o processamento para os vários tipos de mídia descritos na tabela Tamanho de mídia após o processamento abaixo.
• O armazenamento de mídia precisa ser gerenciado pela empresa. Se o volume de mídia alcançar o limite, o envio de mensagens começará a falhar.
• Não há suporte às seguintes ações:

  • Envio de mídia por streams de bytes
  • Envio de mensagens com figurinhas animadas

Como carregar

Faça uma solicitação POST para /v1/media a fim de carregar a mídia. O corpo da solicitação local deve conter os dados de mídia binária, e o cabeçalho Content-Type precisa ser definido de acordo com o tipo de mídia carregado. Consulte a seção Tipos de conteúdo compatíveis para ver as opções aceitas.

Enviar os dados binários em uma solicitação POST HTTP é o método-padrão para carregar dados binários. Por exemplo, se quiser carregar uma imagem, envie uma solicitação POST com os bytes reais da imagem na carga. Outra opção é usar --data-binary caso você queira que cURL leia e use o arquivo fornecido em binários exatamente como ele está.

Exemplo

Carregamento de mídia:

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

Carregamento de mídia com cURL:

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

Em ambos os casos, uma resposta bem-sucedida retorna o campo id, necessário para recuperar mídias ou enviar mensagens de mídia aos clientes.

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

Se você receber uma mensagem de erro, consulte Mensagens de erro e status para saber mais.

Tipos de conteúdo compatíveis

Tamanho de mídia após o processamento

Este é o tamanho máximo permitido do arquivo de mídia após os processos de compactação e criptografia.

Perguntas frequentes

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

Saiba mais

• Best Practices
• Messages
• Reference