> ## 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.
# Visão geral dos modelos
> Entenda quando usar um modelo do WhatsApp, escolha uma categoria e prepare-se para a análise e o envio.
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](/pt/documentation/whatsapp-business-platform/messaging/service-messages#customer-service-window) 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.
| Categoria | Finalidade | Cenário de exemplo |
| - | - | - |
| [Marketing](/pt/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates) | Promover, recomendar, reengajar ou incentivar uma compra ou outra ação. | Compartilhar uma oferta com clientes inscritos para receber atualizações de marketing. |
| [Utilidade](/pt/documentation/whatsapp-business-platform/messaging/message-templates/utility-templates) | Enviar uma atualização não promocional relacionada à solicitação, transação, conta do cliente ou outra finalidade essencial qualificada. | Confirmar um agendamento específico ou atualizar um pedido existente. |
| [Autenticação](/pt/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/index) | Autenticar um usuário com uma senha descartável (código de uso único). | Verificar um login ou uma solicitação de recuperação de conta. |
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](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/new-template-guidelines/) da Meta.
Fonte: [Exemplo oficial da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/custom-marketing-templates/).
Fonte: [Exemplo oficial da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/utility-templates/utility-templates).
Fonte: [Exemplo oficial da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates/).
## 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:
```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Your order {{1}} has shipped. Track its progress using the button below.
```
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](/pt/documentation/channels/whatsapp-accounts-management/template-management/create-template/index) antes de criar a mensagem.
Consulte [Componentes e formatos de modelo](/pt/documentation/whatsapp-business-platform/messaging/message-templates/template-components-and-formats) 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.
O [guia completo do console](/pt/documentation/channels/whatsapp-accounts-management/template-management/create-template/index) 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](/pt/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle) para entender os resultados de análises e alterações seguras, e [Controles de qualidade e entrega](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/quality-and-delivery-controls) 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
Crie e envie seu modelo por meio do console.
Trabalhe com recursos de modelo na sua integração.
Forneça o modelo e os valores específicos do destinatário.
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.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.
