Formatos de mensagem e imagem do WhatsApp

Aqui estão os requisitos de estrutura de mensagem, componentes e ativos de mídia para criar mensagens e modelos do WhatsApp.

Existem dois tipos de mensagens do WhatsApp na Braze: mensagens de modelo e mensagens de resposta.

As mensagens de modelo devem ser enviadas à Meta para aprovação, o que pode levar até 24 horas. Após a aprovação, elas podem ser enviadas a qualquer momento. As mensagens de resposta (chamadas de “mensagens de sessão” na documentação da Meta) só podem ser enviadas enquanto uma janela de conversa ativa estiver aberta — dentro de 24 horas da última mensagem recebida do usuário.

Mensagens de modelo

As mensagens de modelo do WhatsApp são formatos de mensagem pré-aprovados usados para comunicação iniciada pela empresa. Na Braze, elas são construídas a partir de componentes que você define antes de enviar à Meta. Todas as mensagens de modelo são baseadas em categorias: marketing, utilidade ou autenticação.

Modelos de marketing

Os modelos de marketing são o tipo mais comum usado na Braze. Eles consistem em até quatro componentes:

Comprimento de caracteres

Tipos de botão

Formatação de parâmetros

As variáveis de modelo podem usar parâmetros nomeados (como {{first_name}}) ou parâmetros posicionais (como {{1}}). Na Braze, as variáveis podem ser substituídas por Liquid ou texto simples. Sempre inclua valores padrão para variáveis Liquid; mensagens com valores de variáveis ausentes não serão enviadas.

Modelos de carrossel de cartões de mídia

Os modelos de carrossel exibem um corpo de mensagem seguido de 2 a 10 cartões de produto roláveis horizontalmente, cada um com seu próprio ativo de mídia e botões. Eles estão disponíveis apenas para mensagens de modelo de marketing.

Mensagem de nível superior

Especificações por cartão

Comprimento de caracteres por cartão

Mensagens de resposta

As mensagens de resposta (também chamadas de “mensagens de sessão” pela Meta) só podem ser enviadas dentro da janela de conversa de 24 horas. Elas são abertas e redefinidas quando um usuário envia uma mensagem para a sua empresa.

As mensagens de resposta compostas diretamente no editor de Campaign ou Canvas da Braze não requerem aprovação da Meta.

A Braze suporta sete layouts de mensagem de resposta:

Componentes de mensagem de lista

Componentes de resposta rápida

Especificações de mídia

As especificações a seguir se aplicam a todas as mídias em cabeçalhos de modelos do WhatsApp, mensagens de resposta ou mensagens de mídia independentes.

Nota

A Biblioteca de mídia da Braze oferece suporte apenas a imagens e vídeos. Arquivos de áudio e documentos devem ser referenciados por meio de uma URL hospedada.

Imagens

Essas especificações se aplicam a cabeçalhos de modelo, mensagens de mídia de resposta e mensagens de imagem.

Vídeo

As especificações a seguir se aplicam a cabeçalhos de modelo, mensagens de mídia de resposta, mensagens de vídeo e cabeçalhos de cartões de carrossel.

Importante

A Meta tem um problema conhecido que pode impedir a reprodução de alguns vídeos MP4 em dispositivos Android devido a configurações específicas de codificação ou contêiner. Até que uma correção permanente esteja disponível, reformatar o arquivo MP4 resolve o problema para a maioria dos remetentes. Teste todos os vídeos em dispositivos Android para confirmar a entregabilidade correta.

Você pode reformatar o arquivo MP4 usando uma ferramenta online, como o CloudConvert. Faça upload do seu arquivo MP4 na ferramenta, converta-o para MP4 novamente e depois baixe o arquivo convertido.

Compatibilidade com Android

O perfil H.264 “High” codificado com B-frames não é suportado em clientes WhatsApp para Android. Use o perfil H.264 “Main” sem B-frames ou o perfil “Baseline” para a maior compatibilidade. Se estiver recodificando com ffmpeg, use a flag -movflags faststart para posicionar os boxes moov antes dos boxes mdat.

Áudio

As especificações a seguir se aplicam a mensagens de mídia de resposta e mensagens de áudio, e são baseadas no tipo de áudio: mensagem de voz ou mensagem de áudio básica.

Mensagem de voz

Uma mensagem de voz funciona como uma nota de voz gravada, com controles de reprodução e suporte a transcrição.

Mensagem de áudio básica

As especificações a seguir se aplicam ao compartilhamento padrão de arquivos de áudio (clipes de música, anúncios em áudio e arquivos de som).

Considerações

Nota

A Biblioteca de mídia da Braze oferece suporte apenas a imagens e vídeos. Arquivos de áudio e documentos devem ser referenciados por meio de uma URL hospedada.

• Não há suporte a legendas para mensagens de áudio.
• Um erro comum é a incompatibilidade de tipos MIME. Verifique se o tipo MIME do seu arquivo corresponde à sua extensão antes de enviar.

Documentos

As especificações a seguir se aplicam a cabeçalhos de modelos (formato de documento), mensagens de mídia de resposta e mensagens de documento.

Considerações

Nota

A Biblioteca de mídia da Braze oferece suporte apenas a imagens e vídeos. Arquivos de áudio e documentos devem ser referenciados por meio de uma URL hospedada.

• Legendas são opcionais e podem ter no máximo 1.024 caracteres.
• O nome do arquivo é opcional. O WhatsApp usa a extensão do arquivo para determinar qual ícone de documento exibir na conversa.
• Apenas os formatos listados são oficialmente suportados. Outros tipos de arquivo podem ser enviados, mas não há garantia de que serão renderizados corretamente no WhatsApp.

Referência rápida: especificações de mídia do WhatsApp