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

# Modelos de Mensagem

> Crie, envie e gerencie modelos aprovados pela Meta no Tipefy.

Os modelos de mensagem são formatos pré-aprovados pela Meta, exigidos sempre que sua empresa envia a primeira mensagem em uma conversa, ou quando retoma contato com um cliente após o encerramento da janela de atendimento de 24 horas.

Após o envio do modelo, se o cliente responder, a janela de 24 horas é aberta e seus atendentes podem responder livremente, sem necessidade de modelo.

## Quando os modelos são obrigatórios

<CardGroup cols={2}>
  <Card title="Campanhas" icon="megaphone">
    Todas as mensagens ativas em massa devem usar um modelo aprovado. Veja [Criar uma nova campanha](/guides/send-campaign).
  </Card>

  <Card title="Contato proativo" icon="arrow-up-right">
    Enviar a primeira mensagem para um cliente que não entrou em contato recentemente exige o uso de um modelo.
  </Card>

  <Card title="Notificações" icon="bell">
    Confirmações de pedido, alertas de envio, lembretes de consulta e avisos de pagamento.
  </Card>

  <Card title="Reabrir conversas encerradas" icon="rotate-ccw">
    Se a janela de atendimento de 24 horas expirou, é necessário usar um modelo para retomar o contato com o cliente.
  </Card>
</CardGroup>

## Categorias de modelos

A Meta exige que você declare uma categoria ao enviar um modelo. A categoria influencia a forma como a conversa é cobrada pela Meta.

Consulte os valores para cada categoria clicando [aqui](https://business.whatsapp.com/products/platform-pricing?lang=pt_BR\&country=Brasil\&currency=D%C3%B3lar%20\(USD\)\&category=Marketing).

| Categoria        | Casos de uso                                                                           |
| ---------------- | -------------------------------------------------------------------------------------- |
| **Marketing**    | Ofertas promocionais, anúncios de produtos, campanhas para gerar vendas                |
| **Utilidade**    | Confirmações de pedido, atualizações de envio, lembretes de consulta, alertas de conta |
| **Autenticação** | Senhas de uso único (OTP) e códigos de verificação                                     |

<Note>
  Escolha a categoria que melhor descreve a finalidade do seu modelo. Uma classificação incorreta pode levar a Meta a reprovar o modelo ou reclassificá-lo, o que pode alterar a tarifa de cobrança.
</Note>

## Criar um modelo de mensagem

<Steps>
  <Step title="Abrir Modelos de mensagens">
    Em [app.tipefy.com](https://app.tipefy.com), acesse  **Modelos de mensagens**.
  </Step>

  <Step title="Clique em Novo modelo de mensagens">
    Clique em \*\*Novo modelo de mensagens \*\*para abrir o editor de modelos.
  </Step>

  <Step title="Preencha os dados do modelo">
    * **Canal**, selecione ao qual o modelo será vinculado
    * **Nome**, use apenas letras minúsculas, números e underscores\
      (ex: `confirmacao_pedido`, `lembrete_consulta`). Esse nome é interno e não aparece para os destinatários
    * **Categoria**, selecione de acordo com a finalidade: Marketing, Utilidade ou Autenticação
    * **Idioma**, escolha o idioma em que o modelo será enviado

    <Tip>
      Se você atende clientes em mais de um idioma, crie um modelo separado para cada idioma.
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/1OT4jkiz5Qn9PWtN/images/image-27.png?fit=max&auto=format&n=1OT4jkiz5Qn9PWtN&q=85&s=08cbb76389f436469fb14671f340f38d" alt="Image" width="2272" height="248" data-path="images/image-27.png" />
    </Frame>
  </Step>

  <Step title="Escrever o corpo da mensagem">
    Escreva o conteúdo da mensagem. Use chaves duplas para as variáveis, ou seja, os valores que serão preenchidos individualmente para cada destinatário no momento do envio:

    ```text theme={null}
    Olá {{1}}, sua consulta está confirmada para {{2}} às {{3}}.
    Responda SIM para confirmar ou NÃO para cancelar.
    ```

    As variáveis devem ser numeradas sequencialmente a partir de `{{1}}`.

    Exemplo com os dados preenchidos:

    <Frame>
      <img src="https://mintcdn.com/orbe-4cb8e231/1OT4jkiz5Qn9PWtN/images/image-28.png?fit=max&auto=format&n=1OT4jkiz5Qn9PWtN&q=85&s=abe25ed40259ae819931c65ff8671c6d" alt="Image" width="2197" height="897" data-path="images/image-28.png" />
    </Frame>

    <Tip>
      Mantenha o corpo da mensagem claro e objetivo. Os revisores da Meta verificam se a mensagem corresponde à categoria declarada. Linguagem excessivamente promocional em um modelo de Utilidade é uma causa comum de reprovação ou alteração de categoria.
    </Tip>
  </Step>

  <Step title="Adicionar componentes opcionais">
    Você pode enriquecer o modelo com componentes adicionais:

    <Tabs>
      <Tab title="Cabeçalho">
        Adicione um cabeçalho em texto, imagem, vídeo ou documento acima do corpo da mensagem. Os cabeçalhos ajudam os destinatários a identificar rapidamente o assunto da mensagem.
      </Tab>

      <Tab title="Rodapé">
        Adicione uma linha curta de texto abaixo do corpo, usada frequentemente para instruções de descadastro, por exemplo: "Responda PARAR para cancelar o recebimento."
      </Tab>

      <Tab title="Botões">
        Adicione até 3 botões interativos. As opções incluem:

        * **Resposta rápida**: respostas com um toque (ex.: "Sim", "Não", "Mais informações")
        * **Chamada para ação**: link para uma URL ou acionamento de uma ligação telefônica
      </Tab>
    </Tabs>
  </Step>

  <Step title="Enviar para revisão da Meta">
    Clique em **Criar**. O Tipefy encaminha o modelo para revisão da Meta. O status será alterado para **Pendente** e deve ser aguardado a Meta avaliar o modelo.
  </Step>
</Steps>

## Status de aprovação do modelo

| Status        | Significado                                                                                              |
| ------------- | -------------------------------------------------------------------------------------------------------- |
| **Pendente**  | Enviado e aguardando revisão da Meta. Normalmente leva de alguns minutos a algumas horas.                |
| **Aprovado**  | Pronto para uso em campanhas e mensagens ativas.                                                         |
| **Reprovado** | A Meta não aprovou o modelo. Verifique o motivo da reprovação e reenvie com as correções necessárias.    |
| **Pausado**   | A Meta pausou temporariamente o modelo devido a sinais de baixa qualidade, como altas taxas de bloqueio. |

<Warning>
  Um modelo reprovado não pode ser editado diretamente. Você deve criar um novo modelo com um nome diferente e o conteúdo corrigido, e então reenviá-lo para revisão.
</Warning>

## Usar um modelo em uma campanha

Assim que um modelo estiver **Aprovado**, ele ficará disponível para seleção ao criar uma campanha. Consulte [Enviar uma campanha em massa](/guides/send-campaign) para ver o passo a passo completo.

## Boas práticas para modelos

<AccordionGroup>
  <Accordion title="Escolha a categoria com honestidade">
    Se o seu modelo promove um produto ou oferta, selecione Marketing, mesmo que haja algum elemento transacional. Tentar enviar uma mensagem promocional como Utilidade é uma causa comum de reprovação.
  </Accordion>

  <Accordion title="Teste a substituição de variáveis antes de enviar">
    Antes de lançar uma campanha, visualize o modelo com valores reais para confirmar que a personalização está sendo aplicada corretamente. Uma variável vazia visível para o destinatário causa má impressão e pode reduzir a confiança na sua empresa.
  </Accordion>

  <Accordion title="Evite os motivos comuns de reprovação">
    A Meta costuma reprovar modelos que contenham:

    * Conteúdo vago ou enganoso
    * Solicitações de informações pessoais sensíveis
    * Conteúdo que não corresponde à categoria declarada
    * URLs que direcionam para páginas não relacionadas à empresa registrada no Meta Business Manager
  </Accordion>
</AccordionGroup>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Quanto tempo leva a revisão da Meta?">
    A maioria dos modelos é revisada em poucos minutos a algumas horas. Modelos mais complexos ou incomuns podem levar até 24 horas.
  </Accordion>

  <Accordion title="Posso editar um modelo já aprovado?">
    Não. Modelos aprovados não podem ser editados. Se precisar alterar o conteúdo, crie um novo modelo com um novo nome e envie para revisão. O modelo aprovado original continuará disponível até que você o exclua.
  </Accordion>

  <Accordion title="Preciso de um modelo separado para cada idioma?">
    Sim. Cada versão de idioma de um modelo é um envio separado. Você pode criar variantes em vários idiomas usando o mesmo nome de modelo.
  </Accordion>

  <Accordion title="O que acontece depois que a janela de 24 horas expira?">
    Quando a janela de 24 horas após a última mensagem do cliente se encerra, é necessário usar um modelo aprovado para enviar a próxima mensagem. Assim que o cliente responder novamente, uma nova janela de 24 horas é aberta.
  </Accordion>
</AccordionGroup>
