> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar modelo

## O que é um modelo de mensagem?

Um modelo de mensagem do WhatsApp é um formato de mensagem que uma empresa cria e envia à Meta para análise. Após a aprovação, ele pode ser usado para comunicações repetíveis iniciadas pela empresa, incluindo mensagens enviadas fora da janela de atendimento ao cliente.

Os modelos podem conter texto fixo, variáveis, mídia e botões compatíveis. Sua categoria, conteúdo, status de aprovação e regras de mensagens são gerenciados pela Meta.

Para uma introdução detalhada aos conceitos, categorias, formatos, análise e ciclo de vida dos modelos, consulte [Modelos de mensagens](/pt/documentation/whatsapp-business-platform/messaging/message-templates/index).

## Propriedade e identidade do modelo

Um modelo é um recurso de uma conta do WhatsApp Business (WABA) específica. Ele só pode ser usado por números de telefone comerciais que pertencem a essa WABA.

Um modelo é identificado exclusivamente pela combinação de seu **nome** e **idioma**. Modelos com o mesmo nome, mas em idiomas diferentes, são versões localizadas separadas. Ao enviar uma mensagem de modelo, use o nome e o idioma exatos do modelo aprovado para a respectiva WABA.

## Tutorial para criação de modelos de marketing e utilidade

### Etapa 1: Acessar a página de Modelos

1. Navegue até Modelos no menu de navegação à esquerda. Usuários com várias contas WABA devem alternar o espaço da WABA no canto superior direito.

<Frame caption="Select New Template to choose the category for your message.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/templates-clean-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=07270054f340878943d4ba5143e8fe24" alt="Página de modelos com Novo Modelo destacado." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/templates-clean-annotated.svg" />
</Frame>

2. Acesse Modelos a partir das contas do WhatsApp.

<img src="https://mintcdn.com/lchnan/OHXF2GuR7cl6iMeG/product-assets/channels-2026-09-22/whatsapp-accounts.png?fit=max&auto=format&n=OHXF2GuR7cl6iMeG&q=85&s=34239908e4589a9858c9682b55d747e9" alt="Contas do WhatsApp com Gerenciar Modelo para a WABA selecionada" width="3024" height="1656" data-path="product-assets/channels-2026-09-22/whatsapp-accounts.png" />

### Etapa 2: Dar nome e selecionar o tipo de modelo

Clique em **Novo Modelo**. Escolha uma categoria e selecione **Começar do zero** ao criar um modelo de Marketing ou Utilidade.

1. Nome do modelo: o nome do modelo. Os nomes aceitam apenas números, letras minúsculas e sublinhados \_.

<Info>
  Observação: o nome é exclusivo e é o nome chamado ao enviar pela interface.
</Info>

2. Categoria: o tipo de modelo. Existem três tipos de modelos; selecione com base no conteúdo:
   1. Utilidade: modelos transacionais. Usados para enviar mensagens de notificação.
   2. Marketing: modelos de marketing. Todas as mensagens com fins de marketing, bem como todas as mensagens de saudação.
   3. Autenticação: modelos de código de verificação. Conteúdo fixo; oferece suporte apenas ao envio de códigos de verificação.

Para uma explicação detalhada sobre as categorias, consulte a [Visão geral dos modelos](/pt/documentation/whatsapp-business-platform/messaging/message-templates/index)

<Frame caption="Set the template name and category before editing the selected language.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/template-editor-clean-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=b51d5b1e8f50191715b1b330f82d04f1" alt="Editor de modelo com Nome do modelo e Categoria destacados." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/template-editor-clean-annotated.svg" />
</Frame>

### Etapa 3: Escolher o idioma

O conteúdo de um modelo pode ser configurado em vários idiomas. Clique em Adicionar idioma para continuar adicionando.

Vários idiomas podem ser editados juntos e depois enviados.

<Frame caption="Select Add language, search for the required language, and choose its exact locale.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/template-language-clean-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=d9d98be0567aba8f3bede8626287c86c" alt="Menu de adição de idioma filtrado para Inglês." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/template-language-clean-annotated.svg" />
</Frame>

Clique no botão Editar no lado direito do idioma para editar ou excluir o idioma.

<Frame caption="Select Edit beside the language tabs to reveal their removal controls; select Done when finished.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/template-edit-language-clean-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=6e7cd0dff75943d272b58bd821c99b42" alt="Controles de edição de idioma com Inglês e Concluído destacados." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/template-edit-language-clean-annotated.svg" />
</Frame>

### Etapa 4: Editar o conteúdo do modelo

Tomando como exemplo os modelos de **marketing** e de **notificação** :

1. Cabeçalho (opcional): tipos de cabeçalho compatíveis: texto, imagem, vídeo, arquivo.
2. Corpo (obrigatório): conteúdo do texto. Suporta emojis, negrito e outros estilos de texto.
3. Rodapé (opcional): rodapé em texto.
4. Botão (opcional)
   1. Podem ser adicionados até 10 botões
   2. Os tipos de botão incluem:
      1. Resposta rápida
      2. Acessar site
      3. Ligar para número de telefone
      4. Copiar código de oferta
5. Variáveis: variáveis podem ser adicionadas no Cabeçalho, Corpo ou Acessar site. Ao adicionar variáveis, uma Amostra deve ser fornecida para que os revisores possam avaliar o conteúdo de todo o modelo. A Amostra é usada apenas para análise, e o valor real da variável deve ser enviado durante o disparo.

<Frame caption="Configure the body and provide a sample for each variable; review the message preview.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/template-copy-editor.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=00e9b38e664607d645eb0e3b1a4c4009" alt="Editor de modelo atual com variável do corpo, amostra, rodapé e pré-visualização" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/template-copy-editor.png" />
</Frame>

Detalhes sobre o conteúdo do modelo podem ser encontrados na documentação de [Modelos de mensagens](/pt/documentation/whatsapp-business-platform/messaging/message-templates/template-components-and-formats)

<Frame caption="Configure the button text, URL type, and destination URL. The preview shows the unsaved example.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/template-url-button-clean-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=947dc997e26b1aed58747db2255c60ca" alt="Botão de modelo Acessar site com o texto do botão e a URL de destino destacados." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/template-url-button-clean-annotated.svg" />
</Frame>

### Etapa 5: Enviar o modelo

Depois que todos os idiomas forem editados, role até o final da página e clique no botão de envio.

<Frame caption="Scroll to the bottom of the editor and click Submit.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/template-copy-submit.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=642c9c2ff371dde6beb7554b4adf7e97" alt="Editor de modelo exibindo rodapé, resposta rápida e Enviar" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/template-copy-submit.png" />
</Frame>

Confirme se o conteúdo do modelo está correto e clique em Confirmar.

<Frame caption="Select the completed languages you want to submit, then click Confirm.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/template-submit-confirmation.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=59257a66a1f9772524610824009570a5" alt="Confirmação de envio com o idioma Inglês selecionado e os campos obrigatórios preenchidos" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/template-submit-confirmation.png" />
</Frame>

### Etapa 6: Aguardar a aprovação

O modelo é analisado pela Meta, por favor, aguarde. Geralmente, a análise é concluída dentro de um dia.

Use o filtro **Status** para encontrar modelos **Em análise** ou **Rejeitados** . Se um modelo for rejeitado, você poderá acessar a página de edição para ver o motivo e modificar o modelo ou solicitar uma revisão conforme a instrução.

<Frame caption="Use Status to find templates that need attention. No rejected templates are present in this example.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/template-review-status-filter.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=de2c55b2201d070201aec0f2225007ad" alt="Página completa de Modelos com Rejeitado selecionado no filtro de Status" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/template-review-status-filter.png" />
</Frame>

## Criar modelos de autenticação

As etapas para criar modelos de autenticação são as mesmas descritas acima; esta seção apresenta principalmente as configurações para modelos de código de verificação.

### Métodos de entrega de código

Existem 3 métodos para entrega do código de verificação, com três opções:

* [Copiar código](/pt/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/copy-code-authentication)
* [Preenchimento automático](/pt/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/one-tap-authentication)
* [Zero Tap](/pt/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/zero-tap-authentication)

#### Modelo de copiar código

Escolha Copiar código. Você pode personalizar o nome do botão.

<img src="https://mintcdn.com/lchnan/OHXF2GuR7cl6iMeG/product-assets/channels-2026-09-22/authentication-copy-code.png?fit=max&auto=format&n=OHXF2GuR7cl6iMeG&q=85&s=b000911e902a3c48990d3dc47beb207e" alt="Modelo de autenticação com envio por Copiar código e configurações de mensagem" width="3024" height="1656" data-path="product-assets/channels-2026-09-22/authentication-copy-code.png" />

#### Modelo de Preenchimento Automático

Selecione **Autofill** como o método de envio do código. Você pode personalizar o rótulo do botão e adicionar até cinco configurações de pacote do aplicativo. Cada configuração requer o nome do pacote do aplicativo e o hash de assinatura.

O preenchimento automático requer que seu aplicativo ofereça suporte ao handshake usado para o envio de código de verificação com um toque.

<img src="https://mintcdn.com/lchnan/OHXF2GuR7cl6iMeG/product-assets/channels-2026-09-22/authentication-autofill.png?fit=max&auto=format&n=OHXF2GuR7cl6iMeG&q=85&s=1b6ff7cb4cfa64e8e9e7485cc20481e7" alt="Modelo de autenticação com Preenchimento Automático e configuração de pacote de aplicativo" width="3024" height="1656" data-path="product-assets/channels-2026-09-22/authentication-autofill.png" />

#### Modelo Zero-Tap

Selecione **Zero Tap** como o método de envio do código. Adicione o nome do pacote do aplicativo e o hash de assinatura, ative a opção Zero-tap e aceite os termos aplicáveis. Você pode adicionar até cinco configurações de pacote de aplicativo.

O Zero-tap se baseia no fluxo de Preenchimento Automático, portanto, seu aplicativo também deve oferecer suporte ao handshake necessário.

<Frame caption="Enable Zero-tap under Autofill, configure your app, and review the applicable terms.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/authentication-zero-tap.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=7119b1b6ee3cc7cc2c09d6fbebdc89b7" alt="Editor de autenticação completo mostrando a configuração do Zero-tap e do aplicativo" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/authentication-zero-tap.png" />
</Frame>

### Configurações de Conteúdo do Modelo

Embora o conteúdo do modelo de código de verificação seja fixo, você ainda pode adicionar a validade do código de verificação e dicas de segurança por meio de interruptores.

<Frame caption="Add a security recommendation and an expiration time to the authentication message.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/authentication-content-validity-annotated.svg?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=5b5b118278e41bf732997c174222ed11" alt="Conteúdo da mensagem do modelo de autenticação e opções de expiração" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/authentication-content-validity-annotated.svg" />
</Frame>

### Período de validade da mensagem

Caso contrário, as mensagens do WhatsApp podem permanecer qualificadas para entrega por até 30 dias. Essa janela é longa demais para mensagens de autenticação, pois os códigos de verificação geralmente expiram em minutos.

Os modelos de autenticação permitem definir um período de validade de mensagem mais curto. Se o WhatsApp não conseguir entregar a mensagem dentro desse período, ele interromperá as tentativas de entrega e nenhuma taxa será cobrada.

<Warning>
  Defina o período de validade da mensagem para um valor menor ou igual ao período de validade real do código de verificação em seu aplicativo.
</Warning>

Por exemplo, suponha que você defina o período de validade da mensagem como cinco minutos, enquanto o código de verificação no seu aplicativo permanece válido por dez minutos. Se o destinatário estiver offline e a mensagem ainda estiver sendo processada após cinco minutos, o WhatsApp interromperá a tentativa de entrega e nenhuma taxa será cobrada. Se o destinatário se reconectar e abrir o WhatsApp após a janela de cinco minutos, a mensagem não aparecerá.

Entrada de configuração:

<Frame caption="Set Message validity period in Advanced settings; this example uses five minutes.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/authentication-validity-period-annotated.svg?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=ff7b4d120445d3c84fa54b01c6971422" alt="Modelo de autenticação com um período de validade de mensagem de cinco minutos" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/authentication-validity-period-annotated.svg" />
</Frame>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.