Pular para o conteúdo principal
Os eventos de mensagem de números com Dispositivos vinculados trazem os detalhes de exibição que o WhatsApp inclui em uma mensagem. Use-os para montar o balão de mídia, mostrar uma prévia antes de baixar o arquivo ou exibir um cartão de link. Todos os campos são opcionais e são omitidos quando o remetente não os incluiu. Esses campos aparecem nas cargas de message.received, message.update e message.sent. O campo media existente não mudou; continue baixando a mídia com ele.

​
Campos de exibição

thumbnail só aparece quando o remetente incorporou uma prévia JPEG de no máximo 16 KiB. A Polymorfa não baixa prévias que o WhatsApp armazena como arquivos separados, então algumas mensagens não têm thumbnail mesmo que o WhatsApp mostre uma prévia. Prévias de figurinhas não são arquivos JPEG e não são incluídas. linkPreview.url é a URL que a prévia descreve, como aparece no texto da mensagem. previewType é o tipo de prévia do WhatsApp em letras minúsculas, por exemplo none, video ou image.

​
Pares de imagens HD

Quando um contato envia uma foto ou um vídeo em HD, o WhatsApp entrega duas mensagens: uma mensagem em qualidade padrão e uma cópia HD separada. A cópia HD chega como um evento image ou video comum com:
  • association.type: hd_image ou hd_video;
  • association.parentMessageId: o id da mensagem em qualidade padrão; e
  • quality: hd.
Mostre a cópia HD no lugar da mensagem padrão que ela indica, e não como uma segunda mensagem. Os dois eventos podem chegar em qualquer ordem. Se a cópia HD chegar primeiro, guarde-a até chegar a mensagem padrão com esse id. parentMessageId usa o mesmo identificador do id da mensagem padrão, então você pode relacioná-las diretamente. A Polymorfa descarta uma cópia HD cujo remetente seja diferente do remetente da mensagem que ela indica, assim como o WhatsApp faz.

​
Enviar imagens com prévia

Quando você envia uma imagem de um número com Dispositivos vinculados, a Polymorfa adiciona a largura, a altura e uma prévia JPEG com 100 pixels no lado maior, como os clientes do WhatsApp fazem. A sua imagem é enviada sem alterações. Imagens que a Polymorfa não consegue decodificar, ou maiores que 24 megapixels, são enviadas sem a prévia. Para vídeos e documentos, você pode fornecer a sua própria prévia em content.video.thumbnail ou content.file.thumbnail: um JPEG codificado em base64 de no máximo 16 KiB. Uma prévia que não seja JPEG ou que seja maior retorna 400 invalid_parameter. Números oficiais do WhatsApp Business ignoram essas prévias.

​
Qualidade da imagem

content.image.quality aceita standard (o padrão) ou hd. A Polymorfa não envia pares HD: uma solicitação com quality: "hd" envia a imagem uma vez, como foi fornecida, exatamente como standard, e a resposta não tem hdMessageId. hdMessageId só aparece quando uma cópia HD foi enviada; id sempre identifica a mensagem em qualidade padrão.

​
Números de teste

Números de teste enviam e recebem os mesmos campos. Imagens enviadas de um número de teste incluem o tamanho e uma prévia de 100 pixels, e as prévias de vídeo e documento que você fornece são entregues ao número de teste que as recebe.