Skip to main content
Crie seu modelo com corpo, cabeçalho e rodapé opcionais e botões. Adicione variáveis para conteúdo que muda entre destinatários. Formatos de autenticação e especializados têm restrições adicionais.

​
Estrutura padrão do modelo

Esses limites não são uma garantia de que todo modelo especializado aceitará qualquer combinação. A autenticação usa texto predefinido; cartões de carrossel, ofertas por tempo limitado, modelos de comércio e componentes de chamada possuem estruturas próprias. Um layout padrão útil é:
O exemplo ilustra apenas a estrutura; ele não é pré-aprovado pela Meta.
Estrutura do modelo da Meta com cabeçalho, corpo, rodapé, URL, telefone e botões de resposta rápida rotulados.

Meta labels the standard components. This promotional example illustrates structure, not a utility-category decision.

Fonte: Exemplo oficial da Meta.

​
Escolha a ação de botão correta

Um botão de resposta rápida rotulado como Parar promoções não é uma implementação automática de cancelamento de inscrição. Seu fluxo de trabalho deve reconhecer a resposta e atualizar as preferências do cliente. Consulte Opt-out do cliente.

​
A ordem dos botões afeta a usabilidade e a compatibilidade

Coloque as ações mais importantes primeiro. Com mais de três botões, o WhatsApp exibe os dois primeiros e um controle Ver todas as opções para os demais.
Um modelo do WhatsApp com dois botões de ação visíveis e Ver todas as opções, ao lado da lista expandida contendo ações de URL, telefone e resposta rápida.

Meta's example of a template with additional actions behind See all options. Client appearance may vary.

Fonte: Componentes de modelos da Meta. Mantenha as respostas rápidas e outros tipos de botão em grupos separados:
  • Agrupamento válido: URL → Telefone → Resposta rápida → Resposta rápida.
  • Agrupamento inválido: Resposta rápida → URL → Resposta rápida.
Atualmente, a Meta documenta uma limitação no desktop para modelos com quatro ou mais botões, ou uma resposta rápida misturada com outro tipo de botão: os destinatários são solicitados a visualizar essas mensagens em um celular. Teste isso caso o uso no desktop seja importante para seu público.

​
Variáveis: criação, análise e envio são etapas separadas

Para este corpo:
Use um mapeamento que sua equipe e integração possam manter: Os exemplos de análise demonstram o significado de uma variável. Eles não configuram uma fonte de dados nem preenchem automaticamente mensagens futuras. O cabeçalho, o corpo e cada botão dinâmico têm posições de parâmetros separadas. O corpo {{1}} e o botão de URL {{1}} não precisam conter o mesmo valor. O botão index identifica a posição do botão no modelo, começando em 0; não é um número de variável do corpo.

​
Exemplo: valores do corpo e uma URL dinâmica

Suponha que o modelo analisado tenha:
  • Corpo: Your booking {{1}} is confirmed for {{2}}.
  • Botão no índice 0: https://example.com/bookings/{{1}}
O objeto de modelo da mensagem da YCloud pode mapeá-los da seguinte forma:
Este é um fragmento do objeto de modelo, não uma solicitação de envio completa. Ele pressupõe que o modelo indicado e a variante exata de idioma estejam aprovados na WABA do remetente. O parâmetro do botão fornece o sufixo, não a URL completa. Mantenha um domínio de destino estável no modelo analisado. Codifique os valores de URL corretamente e evite incluir informações privadas ou credenciais de acesso de longa duração nos links. Não use uma variável para ocultar a categoria real da mensagem.

​
Cabeçalhos de mídia: arquivos de amostra não são anexos ativos

Para um cabeçalho de imagem, vídeo ou documento:
  1. Selecione o formato de cabeçalho pretendido ao criar o modelo.
  2. Forneça uma amostra representativa para análise.
  3. No momento do envio, forneça a mídia real usando o ID de mídia ou campo de link compatível da YCloud.
  4. Confirme se o arquivo pode ser recuperado, se seu formato corresponde ao modelo e se ele atende aos limites de mídia.
  5. Teste a mensagem entregue, incluindo a legibilidade do arquivo em um telefone celular.
Não envie um parâmetro de imagem para um modelo com cabeçalho de vídeo. Uma URL privada que só funciona após o login não é um link de mídia confiável para o serviço de mensagens. Cabeçalhos de GIF aparecem nos contratos atuais, mas a Meta restringe esse recurso à rota aplicável da Marketing Messages API for WhatsApp . Não presuma que ele esteja disponível em todos os fluxos de trabalho comuns de modelo apenas porque o campo existe.

​
Selecionar um formato especializado

​
Diagnosticar um erro de componente

O guia da API de modelos da YCloud e o contrato OpenAPI definem os campos da YCloud. O suporte a componentes da Meta não garante que todos os editores, Inbox, Campanhas ou rotas da API da YCloud disponibilizem o mesmo recurso. Continue com Criar um modelo e Análise e ciclo de vida do modelo.