# Modelos do WhatsApp ## O que são modelos do WhatsApp? Os modelos do WhatsApp são formatos de mensagem pré-aprovados que permitem iniciar ou reabrir conversas com contatos. Ao contrário das mensagens comuns, cada modelo deve ser revisado e aprovado pela Meta (empresa controladora do Facebook, que é proprietária do WhatsApp) antes que você possa usá-lo. **Por que o WhatsApp exige aprovação?** Para proteger os usuários contra spam. O WhatsApp é uma plataforma de mensagens pessoais, e a Meta revisa todas as mensagens iniciadas por empresas para garantir que sejam relevantes e não abusivas. Esse processo de aprovação mantém o WhatsApp confiável tanto para empresas quanto para seus clientes. Os modelos são necessários porque o WhatsApp impõe uma **janela de mensagens de 24 horas**. Após a última mensagem de um contato, você tem 24 horas para responder livremente. Assim que essa janela se fecha, a única maneira de entrar em contato com o usuário novamente é enviando um modelo aprovado. --- ## Onde os modelos ficam Os modelos agora têm sua própria página de nível superior — clique em **Modelos** em **AI STUDIO** na barra lateral esquerda (antes ficava dentro de Configurações). Tudo abaixo continua funcionando da mesma forma; apenas o caminho de navegação mudou. --- ## Por que você precisa de modelos? - **Iniciar conversas de saída** — Ao iniciar uma transmissão, a primeira mensagem enviada para cada contato deve ser um modelo. - **Reabrir conversas encerradas** — Se tiverem se passado 24 horas desde a última mensagem de um contato, você precisará de um modelo para retomar o chat. - **Sequências de acompanhamento** — Mensagens de acompanhamento automatizadas usam modelos para reengajar contatos que não responderam. - **Manter a conformidade** — A Meta exige que todas as mensagens iniciadas por empresas no WhatsApp usem modelos aprovados. Mensagens enviadas sem modelos aprovados falharão na entrega. **Exemplo real:** Imagine que você gerencia uma clínica odontológica e um paciente lhe enviou uma mensagem ontem sobre clareamento dental. Hoje (mais de 24 horas depois), você deseja enviar os detalhes de preço. Você não pode simplesmente digitar uma mensagem — você precisa enviar um modelo aprovado primeiro para reabrir a conversa. --- ## Criando um modelo 1. Na barra lateral esquerda, em **AI STUDIO**, clique em **Modelos**. 2. Clique no botão **Novo modelo**. 3. Um pop-up intitulado **Novo modelo do WhatsApp** será aberto. Ele possui duas partes para preencher, com uma visualização em tempo real ao lado: - Em **Identidade**: o **Nome do modelo** (seu nome interno — não exibido aos contatos), o **Idioma** e o **Tipo de modelo** — **Geral** (um modelo de saída padrão) ou **Acompanhamento inteligente** (um modelo usado para reengajar contatos que não responderam — consulte [Modelos de Acompanhamento Inteligente](#smart-follow-up-templates)). - Em **Corpo**: digite a mensagem real que seus contatos verão. Máximo de **1.024 caracteres**. 4. Adicione quaisquer **variáveis**, se necessário — espaços reservados `{{token}}` que são preenchidos com os detalhes de cada contato quando a mensagem é enviada, explicados em [Variáveis de Modelo](#template-variables). O painel de visualização possui duas guias — **Variáveis** (a visualização padrão — destaca cada `{{token}}` no local, diretamente no seu texto bruto) e **Visualizar preenchido** (substitui pelos valores reais de um contato de exemplo para que você veja exatamente o que um contato recebe). 5. Clique em **Criar modelo**. Os modelos são salvos primeiro como um **rascunho** — nada é enviado à Meta até que você o submeta. 6. Na lista de modelos, clique em **Enviar para aprovação** para enviá-lo à Meta para análise. ### Modelos de Acompanhamento Inteligente Um modelo de **Acompanhamento inteligente** permite que a IA preencha um espaço reservado com o tópico real da conversa, em vez de você escrever uma linha de reengajamento fixa. Eles devem conter um espaço reservado `{{personal_context|...}}` **com uma instrução após a barra vertical** — por exemplo, `{{personal_context|ask about their order}}` — que diz à IA o que escrever ali. Uma tag `{{personal_context}}` simples, sem instrução, é deixada vazia no momento do envio. O aplicativo avisa você e bloqueia a aprovação se o espaço reservado estiver totalmente ausente, já que a Meta rejeitará o envio sem ele. ### Diretrizes para o corpo do modelo - Mantenha sua mensagem clara, profissional e relevante para o seu negócio. - O comprimento máximo do corpo é de **1.024 caracteres**. - Evite linguagem promocional agressiva que possa levar à rejeição (por exemplo, "GRÁTIS!!!", excesso de letras maiúsculas ou frases de clickbait). - Não inclua links para sites suspeitos ou não verificados. **Dica:** Mantenha suas mensagens de modelo curtas e pessoais para obter melhores taxas de aprovação. Uma mensagem concisa e amigável tem mais chances de ser aprovada — e mais chances de obter uma resposta de seus contatos. --- ## Variáveis de modelo As variáveis permitem personalizar modelos com conteúdo dinâmico. Elas usam o nome do campo entre chaves duplas, por exemplo `{{first_name}}`, `{{last_name}}`, `{{company}}`, `{{email}}` e `{{phone_number}}`. Você também pode usar qualquer campo de contato personalizado pelo nome dele. Algumas regras importantes: - Os nomes diferenciam maiúsculas de minúsculas e devem corresponder exatamente ao campo — use `{{company}}`, não `{{Company}}`. - **Não** digite espaços reservados numerados como `{{1}}` ou `{{2}}`. A plataforma corresponde às variáveis pelo nome, portanto, `{{1}}` não será preenchido e aparecerá literalmente na mensagem que seu contato receber. **Exemplo:** > Olá {{first_name}}, obrigado pelo seu interesse em nossos serviços. Adoraríamos ajudar você a começar. Responda a esta mensagem e entraremos em contato em breve. Quando o modelo é enviado, `{{first_name}}` é substituído automaticamente pelo primeiro nome real de cada contato. Portanto, se o nome do contato for Sarah, a mensagem será: "Olá Sarah, obrigado pelo seu interesse..." A guia **Visualizar** mostra a mensagem preenchida com um contato de exemplo (John Doe, Acme Corp) — mensagens reais usam os dados do destinatário real. Ao visualizar a partir do registro de um contato existente, ele mostra os detalhes reais dele — exatamente o que ele receberia; um campo para o qual ele não possui valor é enviado vazio. **Dica:** Para reabrir conversas encerradas, você pode criar modelos simples sem variáveis. Eles geralmente são aprovados mais rapidamente porque são diretos. --- ## Enviando para aprovação Após criar seu modelo, clique em **Enviar para aprovação** — a plataforma o envia automaticamente para a Meta analisar. Como ele chega lá depende da conexão do WhatsApp que o número utiliza: em uma conexão gerenciada do WhatsApp, ele é enviado através do seu provedor de mensagens, e se o número utiliza sua própria Conta do WhatsApp Business, o modelo é criado diretamente nessa conta (veja [Usando modelos com sua própria conta Meta WhatsApp](#using-templates-with-your-own-meta-whatsapp-account) abaixo). De qualquer forma, é a Meta quem faz a análise. > **O editor de modelos não possui um seletor de categoria — a Meta decide a categoria.** Um modelo que você cria aqui é enviado sem uma categoria declarada, o que significa que ele começa como **Utilidade** e a Meta o reclassifica (geralmente para Marketing) se o conteúdo parecer promocional. As estimativas de custo no aplicativo usam a taxa de Marketing quando a categoria de um modelo ainda não é conhecida, portanto, a estimativa é feita com cautela. Se você precisar declarar uma categoria específica, crie o modelo através da [API de Modelos](../api/templates.md). ### O que acontece durante a análise: 1. O status do seu modelo muda para **Pendente**. 2. A Meta analisa o conteúdo para garantir que ele siga suas políticas de mensagens. 3. O modelo é **Aprovado** ou **Rejeitado**. ### Quanto tempo leva a aprovação? A aprovação pode levar de alguns minutos a vários dias — a maioria dos modelos é analisada em até uma hora. Veja o que afeta o tempo: - **Contas comerciais verificadas** tendem a obter aprovações mais rápidas. - Modelos simples e diretos são aprovados mais rapidamente. - Modelos com conteúdo promocional intenso ou links externos podem levar mais tempo ou serem rejeitados. **Dica:** Envie seus modelos alguns dias antes de planejar o lançamento de uma transmissão, para que você não fique esperando aprovações de última hora. --- ## Usando modelos com sua própria conta Meta WhatsApp Se o seu número do WhatsApp utiliza sua própria Conta do WhatsApp Business — seja configurada com [Conectar através do nosso aplicativo Meta](../messaging-channels/connect-through-our-meta-app.md) ou [Conectar seu próprio aplicativo Meta](../messaging-channels/connect-your-own-meta-app.md) — a página de Modelos funciona exatamente como descrito acima, com algumas diferenças que vale a pena conhecer. Uma pequena nota no topo da página informa quando esse é o caso, e os modelos que residem na sua Conta do WhatsApp Business possuem um pequeno rótulo **Meta** na lista. - **Os modelos são criados na sua própria Conta do WhatsApp Business.** Quando você envia um, ele é criado nessa conta e revisado diretamente pela Meta — o mesmo modelo aparece no seu Gerenciador do WhatsApp. - **As aprovações vêm da Meta.** Os status **Aprovado**, **Pendente** e **Rejeitado** que você vê aqui são decisões da própria Meta, e eles são atualizados nesta página assim que a Meta os define (incluindo o motivo de uma rejeição). - **As regras de nomenclatura da Meta são aplicadas para você.** A Meta aceita apenas letras minúsculas, números e sublinhados no nome de um modelo. Digite o que parecer melhor — o aplicativo converte o nome ao criar o modelo, então `agendar-01` se torna `agendar_01`. - **Os modelos que você já possui aparecem automaticamente.** Tudo o que já existe no seu Gerenciador do WhatsApp aparece na lista quando você abre a página de Modelos, então não há nada para recriar. Se você adicionar ou alterar um modelo no Gerenciador do WhatsApp enquanto estiver trabalhando, clique em **Sincronizar da Meta** para importá-lo imediatamente. - **Excluir também o remove da Meta.** Excluir um modelo aqui também o exclui da sua Conta do WhatsApp Business, portanto, aponte qualquer coisa que ainda o esteja usando para outro modelo primeiro. - **Categoria:** os modelos que você cria no aplicativo são enviados sem uma categoria declarada — eles começam como **Utilidade** e a Meta reclassifica o conteúdo promocional (geralmente para Marketing) durante a revisão. Uma categoria específica pode ser declarada ao criar um modelo através da [API de Modelos](../api/templates.md). - **O envio permanece inalterado.** Modelos aprovados são usados exatamente como antes — em transmissões, acompanhamentos e para reabrir uma conversa fora da janela de 24 horas. Apenas modelos aprovados podem ser enviados. **Se a página solicitar que você conclua sua conexão**, sua Conta do WhatsApp Business ainda não está totalmente vinculada — volte para **Configurações → Canais**, conclua a conexão e os modelos ficarão disponíveis imediatamente. --- ## Rastreamento de Status de Modelos A página **Modelos** mostra cada modelo com seu status atual, além de blocos de estatísticas para Total, Aprovado, Em análise e Rejeitado. Pesquise e filtre por status para encontrar um modelo específico. | Status | O que significa | |---|---| | **Rascunho** | Criado, mas ainda não enviado para a Meta. | | **Pendente** | Enviado e aguardando a análise da Meta. | | **Aprovado** | Passou na análise e está pronto para uso em transmissões e conversas. | | **Rejeitado** | Não passou na análise. Leia o feedback da Meta, revise sua mensagem e envie novamente. | Se um modelo for rejeitado, não se preocupe — você pode editar o conteúdo e enviá-lo novamente quantas vezes for necessário. ### Editando um Modelo Aprovado Um modelo aprovado não pode ser editado diretamente — a Meta bloqueia a versão aprovada. Para alterar um, **Duplique-o**, edite a cópia e envie a cópia para aprovação; seus envios continuarão usando o modelo aprovado antigo até que o novo seja aprovado. Rascunhos e modelos rejeitados podem ser editados livremente. ### Enviando um Modelo Diretamente para um Contato Na página de Modelos, clique na ação de envio em qualquer modelo **Aprovado** para enviá-lo diretamente a um de seus contatos recentes — útil para uma reabertura única sem precisar criar uma transmissão completa. Isso entrega uma mensagem real do WhatsApp, abre uma sessão de chat e utiliza créditos, portanto, o aplicativo solicitará uma confirmação antes do envio. ### Reenviando uma Mensagem de Abertura de Transmissão Rejeitada A primeira mensagem de uma Transmissão de saída é um modelo, portanto, ela também passa pela aprovação da Meta. Se ela retornar como **Rejeitada**, você pode corrigi-la e reenviá-la sem sair do assistente de transmissão: 1. Abra a transmissão. 2. Clique na etapa **Mensagem**. 3. A mensagem de abertura mostrará o motivo da rejeição da Meta. 4. Edite o texto sinalizado pela Meta. 5. Reenvie a partir dessa etapa. A mensagem de abertura voltará para **Pendente** enquanto a Meta a analisa novamente. ::: warning **Importante:** Apenas reescrever a mensagem de abertura e salvar **não** a reenvia para aprovação — use a ação de reenvio da etapa para que a nova versão seja realmente enviada à Meta. Até que uma nova versão seja aprovada, a transmissão não poderá ser enviada para contatos fora da janela de 24 horas. Você também pode gerenciar e reenviar o mesmo modelo na página de **Modelos**. ::: --- ## Geração de Modelos com IA A plataforma pode gerar modelos automaticamente para você usando IA. Isso economiza tempo e ajuda você a escrever mensagens com maior probabilidade de serem aprovadas. Modelos gerados por IA são especialmente úteis para: - **Mensagens de abertura** — Quando você cria uma Transmissão e fornece seu site ou páginas de vendas, a plataforma gera um modelo de abertura apropriado com base no seu negócio. - **Sequências de acompanhamento** — A IA cria uma série de modelos de acompanhamento projetados para reengajar contatos em diferentes intervalos (por exemplo, dia 1, dia 3 e dia 7). - **Otimização** — Quando você otimiza uma Transmissão ou Agente existente, os modelos podem ser regenerados para corresponder à sua estratégia de mensagens atualizada. --- ## Reabrindo Conversas Encerradas Quando a janela de mensagens do WhatsApp de 24 horas se fecha, a interface de chat em Chats exibe uma notificação informando que a conversa foi encerrada. Para reabri-la: 1. No chat, você verá uma mensagem informando que a janela de conversa foi encerrada. 2. Clique no botão **Reabrir** ou selecione um modelo no menu suspenso. 3. Escolha um modelo aprovado da lista. 4. O modelo é enviado ao contato, reabrindo a conversa. 5. Assim que o contato responder, a janela de 24 horas é reiniciada e você pode enviar mensagens livremente novamente. --- ## Modelos de Acompanhamento Os modelos de acompanhamento reengajam automaticamente os contatos que não responderam a um envio de saída. A plataforma suporta até **9 modelos de acompanhamento**, enviados em intervalos que você configura (por exemplo, 1 dia, 3 dias e 7 dias após a mensagem inicial). - Os modelos de acompanhamento são configurados na guia **Acompanhamentos** do Agente de IA que gerencia o canal. Essa guia não possui um botão de geração de modelo por IA, portanto, escreva cada acompanhamento você mesmo ou escolha um modelo aprovado existente. - Cada acompanhamento é um modelo aprovado separado. - A IA personaliza cada acompanhamento para criar uma progressão natural de mensagens — para que seus contatos não recebam a mesma mensagem repetidamente. **Dica:** Espaçar seus acompanhamentos ao longo de vários dias tende a ser mais eficaz do que enviá-los em sequência imediata. Dê tempo aos contatos para responder antes que o próximo acompanhamento seja enviado. --- ## Melhores práticas para obter aprovação de modelos 1. **Seja direto** — Escreva mensagens claras e profissionais. Evite linguagem de vendas agressiva como "Compre agora!" ou "Oferta por tempo limitado!!!" 2. **Mantenha a relevância** — Os modelos devem estar diretamente relacionados a uma interação esperada com o contato. Se alguém se inscreveu em sua newsletter, um acompanhamento sobre seus serviços faz sentido. Uma mensagem promocional aleatória, não. 3. **Use gramática correta** — Mensagens bem escritas têm mais chances de passar na revisão. 4. **Evite formatação excessiva** — Não use todas as letras maiúsculas, pontos de exclamação em excesso ou linhas de emojis. 5. **Limite links externos** — Se incluir links, certifique-se de que levem a páginas legítimas e verificadas. 6. **Comece simples** — Se você é novo no uso de modelos, comece com uma saudação simples ou um acompanhamento antes de tentar conteúdos promocionais complexos. 7. **Combine com seu negócio** — Certifique-se de que o conteúdo do modelo esteja alinhado com a categoria da sua conta Meta Business verificada. --- ## Modelos para WhatsApp Web Se sua transmissão usa apenas o **WhatsApp Web** (não a API do WhatsApp Business), os modelos são aprovados automaticamente sem a revisão da Meta. Isso ocorre porque as mensagens do WhatsApp Web são enviadas através da sua conexão pessoal ou comercial do WhatsApp, que não passa pelo mesmo processo de aprovação. **O que isso significa para você:** Se você estiver usando o WhatsApp Web, pode criar e usar modelos imediatamente sem esperar pela aprovação. No entanto, o WhatsApp Web possui outras limitações (como estabilidade de conexão), por isso muitas empresas preferem a API Business para mensagens de alto volume. --- ## Precisa de ajuda? If your templates are consistently being rejected or you need guidance on template creation, reach out via our [email support](mailto:hi@youraiconnector.com).