Skip to main content
Um modelo de mensagem é uma estrutura de mensagem reutilizável associada a uma conta do WhatsApp Business (WABA). Você a envia para análise da Meta antes de usá-la para enviar mensagens baseadas em modelos. Use um modelo quando precisar enviar uma mensagem a um cliente fora da janela de atendimento ao cliente. Você também pode usar modelos enquanto a janela estiver aberta. Consulte Mensagens de serviço para saber mais sobre as regras da janela.
A aprovação do modelo não concede permissão para entrar em contato com um cliente. Verifique o consentimento do cliente e as preferências de cancelamento (opt-out) antes de enviar.

​
Escolha uma categoria de modelo

Escolha a categoria com base na finalidade da mensagem, e não no preço que você preferiria pagar. Uma mensagem que combina a atualização de uma transação com uma oferta não é puramente de utilidade. A Meta trata o conteúdo misto de utilidade e promoção como marketing. Para obter critérios de categorias e exemplos, consulte as diretrizes de categorização de modelos da Meta.
Exemplo de marketing da Meta com uma oferta de desconto e componentes rotulados.

A promotional offer illustrates marketing content.

Fonte: Exemplo oficial da Meta.

​
Entenda o modelo e a mensagem

O modelo define a estrutura analisada. A mensagem enviada preenche os valores necessários para um destinatário. Por exemplo, um modelo fictício de atualização de pedido pode conter:
Ao enviar, você fornece a referência do pedido e qualquer outro conteúdo necessário. Mantenha os valores das variáveis consistentes com a finalidade aprovada do modelo. Não use variáveis para inserir conteúdo promocional não relacionado. O exemplo é ilustrativo, não um modelo pré-aprovado.

​
Componentes e formatos

Dependendo da categoria e do formato selecionados, um modelo pode incluir:
  • Um cabeçalho.
  • Um corpo.
  • Um rodapé.
  • Botões.
  • Variáveis e valores de exemplo.
As categorias descrevem a finalidade. Os formatos descrevem a apresentação. Um carrossel ou cabeçalho de mídia é uma escolha de formato, não uma quarta categoria de modelo. Nem todos os componentes ou formatos estão disponíveis para todas as categorias ou fluxos de trabalho. Verifique as opções suportadas no guia de criação de modelos do YCloud antes de criar a mensagem. Consulte Componentes e formatos de modelo para ver a comparação de formatos e guias detalhados.

​
Crie um primeiro modelo utilizável no YCloud

  1. Abra Modelos. Se você gerencia várias WABAs, alterne primeiro para a WABA desejada; um modelo aprovado em outra WABA não fica automaticamente disponível para esse remetente.
  2. Insira um nome estável usando letras minúsculas, números e sublinhados suportados pelo editor. Escolha um nome que descreva o evento, como booking_confirmation.
  3. Escolha Marketing, Utilidade ou Autenticação com base no caso de uso real.
  4. Selecione a variante de idioma exata. Um modelo pode ter várias versões de idioma, mas cada versão precisa do conteúdo correto e de seu próprio resultado de análise.
  5. Configure o cabeçalho, corpo, rodapé e botões suportados. Forneça valores de exemplo para variáveis e mídias de exemplo quando solicitado.
  6. Verifique a pré-visualização do cliente, envie e confirme. Aguarde o resultado da análise antes de vincular o modelo a um envio em produção.
Editor de modelo de marketing em inglês com variável no corpo, exemplo Alex e pré-visualização do cliente.

Provide sample values for variables and check the customer preview before submitting.

O guia completo do console contém a sequência detalhada de telas. As principais decisões e requisitos são abordados aqui; você não precisa das ferramentas de desenvolvedor da Meta para este fluxo de trabalho no console.

​
Idioma e reutilização: mal-entendidos comuns

  • Um idioma aprovado não significa todos os idiomas. Enviar en_US não é equivalente a enviar en. Escolha a variante exata que foi aprovada.
  • O idioma do modelo não traduz os valores das variáveis. Seu sistema deve fornecer as datas, rótulos e valores corretos voltados ao cliente.
  • A aprovação pertence ao recurso de modelo em sua respectiva WABA. Um modelo com nome semelhante em outra WABA é um recurso diferente.
  • Um modelo não é uma lista de destinatários. Criá-lo não o envia nem inscreve ninguém.
  • Um corpo aprovado não é a mensagem concluída. Variáveis ausentes, mídia incorreta ou um parâmetro de botão errado ainda podem causar falha no envio.
Para o seu primeiro teste, use um destinatário de teste que esteja esperando a mensagem, inspecione o conteúdo entregue e todos os botões e verifique o status final da mensagem. Um envio bem-sucedido no editor não é um teste de ponta a ponta.

​
Do rascunho à entrega

  1. Defina o objetivo. Identifique a ação do cliente ou evento de negócios que deve disparar a mensagem.
  2. Escolha a categoria e o conteúdo. Mantenha a mensagem clara e forneça exemplos representativos para as variáveis.
  3. Crie e envie o modelo. Use o fluxo de trabalho de gerenciamento de modelos ou a API da YCloud.
  4. Verifique o resultado da análise. Não envie um modelo que ainda esteja aguardando aprovação ou indisponível.
  5. Envie e monitore. Forneça os valores obrigatórios e acompanhe a entrega da mensagem e o feedback do cliente.
Status de análise e qualidade são dimensões diferentes. A aprovação não garante disponibilidade permanente: feedbacks posteriores ou controles da plataforma podem afetar um modelo. Consulte Análise e ciclo de vida do modelo para entender os resultados de análises e alterações seguras, e Controles de qualidade e entrega para controles de envio.

​
Antes de enviar

  • Confirme que o cliente espera a comunicação.
  • Verifique se o modelo selecionado pertence à WABA pretendida.
  • Use a versão de idioma aprovada correta.
  • Forneça todos os valores e mídias obrigatórios.
  • Verifique o status atual do modelo.
  • Confirme os preços atuais e quaisquer restrições de envio.
  • Trate falhas de entrega e cancelamentos de recebimento (opt-outs).

​
Comece a usar modelos

Criar um modelo na YCloud

Crie e envie seu modelo por meio do console.

Gerenciar modelos com a API

Trabalhe com recursos de modelo na sua integração.

Enviar uma mensagem do WhatsApp

Forneça o modelo e os valores específicos do destinatário.

Entender as mensagens de serviço

Saiba quando você pode usar respostas em formato livre.

​
Perguntas frequentes

Os exemplos de análise ajudam a Meta a entender os marcadores de posição. Eles não são os valores de envio específicos do seu cliente. No momento do disparo, forneça todos os parâmetros obrigatórios na estrutura e no idioma aprovados. Teste com valores sintéticos para que uma amostra de análise não seja reutilizada acidentalmente como número de pedido, nome ou código de verificação.
Você deve enviar uma versão de idioma aprovada que exista sob a WABA e o nome de modelo pretendidos. Selecionar outro código de idioma não traduz o conteúdo nem aprova uma nova versão. Encaminhe os destinatários para uma versão aprovada correspondente ou use um fallback adequado existente.
Verifique as WABAs de ambos os números. Um modelo é um recurso de uma WABA, não um nome disponível globalmente na sua conta da YCloud. Compare a WABA, o nome, o idioma, o status e os componentes fornecidos para o envio com falha. Se uma migração ou substituição alterou os recursos, atualize as referências do chamador em vez de tentar repetidamente a combinação antiga.