# Modelos do WhatsApp ## O que são modelos do WhatsApp? Os modelos do WhatsApp são formatos de mensagem pré-aprovados que lhe permitem iniciar ou reabrir conversas com contactos. Ao contrário das mensagens normais, cada modelo tem de ser revisto e aprovado pela Meta (a empresa-mãe do Facebook, que detém o WhatsApp) antes de poder ser utilizado. **Porque é que o WhatsApp exige aprovação?** Para proteger os utilizadores contra spam. O WhatsApp é uma plataforma de mensagens pessoal e a Meta analisa todas as mensagens iniciadas por empresas para garantir que são relevantes e não abusivas. Este processo de aprovação mantém o WhatsApp fiável tanto para as empresas como para os 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 contacto, tem 24 horas para responder livremente. Assim que essa janela fecha, a única forma de contactar novamente o utilizador é enviando um modelo aprovado. --- ## Onde residem os modelos Os modelos têm agora a sua própria página de nível superior — clique em **Modelos** em **AI STUDIO** na barra lateral esquerda (antigamente estavam integrados nas Definições). Tudo o que se segue continua a funcionar da mesma forma; apenas o caminho de navegação foi alterado. --- ## Porque precisa de modelos? - **Iniciar conversas de saída** — Quando inicia uma transmissão de saída, a primeira mensagem enviada a cada contacto tem de ser um modelo. - **Reabrir conversas fechadas** — Se tiverem passado 24 horas desde a última mensagem de um contacto, precisa de um modelo para retomar a conversa. - **Sequências de seguimento** — As mensagens de seguimento automatizadas utilizam modelos para voltar a envolver contactos que não responderam. - **Manter a conformidade** — A Meta exige que todas as mensagens de WhatsApp iniciadas por empresas utilizem modelos aprovados. As mensagens enviadas sem modelos aprovados não serão entregues. **Exemplo real:** Imagine que gere uma clínica dentária e um paciente lhe enviou uma mensagem ontem sobre branqueamento dentário. Hoje (mais de 24 horas depois), quer enviar-lhe os detalhes de preços. Não pode simplesmente escrever uma mensagem — precisa de enviar primeiro um modelo aprovado para reabrir a conversa. --- ## Criar um modelo 1. Na barra lateral esquerda, em **AI STUDIO**, clique em **Modelos**. 2. Clique no botão **Novo modelo**. 3. Abre-se uma janela pop-up intitulada **Novo modelo de WhatsApp**. Tem duas partes para preencher, com uma pré-visualização em tempo real ao lado: - Em **Identidade**: o **Nome do modelo** (o seu nome interno — não visível para os contactos), o **Idioma** e o **Tipo de modelo** — **Geral** (um modelo de envio padrão) ou **Acompanhamento inteligente** (um modelo utilizado para voltar a contactar utilizadores que não responderam — consulte [Modelos de Acompanhamento Inteligente](#smart-follow-up-templates)). - Em **Corpo**: escreva a mensagem real que os seus contactos irão ver. Máximo de **1.024 caracteres**. 4. Adicione quaisquer **variáveis**, se necessário — marcadores de posição `{{token}}` que são preenchidos com os detalhes de cada contacto quando a mensagem é enviada, explicados em [Variáveis de Modelo](#template-variables). O painel de pré-visualização tem dois separadores — **Variáveis** (a vista predefinida — destaca cada `{{token}}` no local, diretamente no seu texto não formatado) e **Pré-visualizar preenchido** (substitui os valores reais de um contacto de exemplo para que veja exatamente o que um contacto recebe). 5. Clique em **Criar modelo**. Os modelos são guardados primeiro como um **rascunho** — nada é enviado para a Meta até que o submeta. 6. A partir da lista de modelos, clique em **Submeter para aprovação** para o enviar para a Meta para análise. ### Modelos de Seguimento Inteligente Um modelo de **Acompanhamento inteligente** permite que a IA preencha um marcador de posição com o tópico real da conversa, em vez de escrever uma linha de reativação fixa. Estes devem conter um marcador de posição `{{personal_context|...}}` **com uma instrução após a barra vertical** — por exemplo, `{{personal_context|ask about their order}}` — que indica à IA o que escrever aí. Uma etiqueta `{{personal_context}}` simples, sem instruções, permanece vazia no momento do envio. A aplicação avisa-o e bloqueia a aprovação se o marcador de posição estiver totalmente em falta, uma vez que a Meta rejeitará o envio sem ele. ### Diretrizes para o corpo do modelo - Mantenha a 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 websites suspeitos ou não verificados. **Dica:** Mantenha as suas mensagens de modelo curtas e pessoais para obter melhores taxas de aprovação. Uma mensagem concisa e amigável tem mais probabilidades de ser aprovada — e mais probabilidades de obter uma resposta dos seus contactos. --- ## Variáveis de modelo As variáveis permitem-lhe personalizar modelos com conteúdo dinâmico. Utilizam o nome do campo dentro de chavetas duplas, por exemplo `{{first_name}}`, `{{last_name}}`, `{{company}}`, `{{email}}` e `{{phone_number}}`. Também pode utilizar qualquer campo de contacto personalizado pelo seu nome. Algumas regras importantes: - Os nomes diferenciam maiúsculas de minúsculas e devem corresponder exatamente ao campo — utilize `{{company}}`, não `{{Company}}`. - **Não** escreva marcadores de posição numerados como `{{1}}` ou `{{2}}`. A plataforma associa as variáveis pelo nome, por isso `{{1}}` não será preenchido e aparecerá literalmente na mensagem que o seu contacto receber. **Exemplo:** > Olá {{first_name}}, obrigado pelo seu interesse nos nossos serviços. Adoraríamos ajudá-lo a começar. Responda a esta mensagem e entraremos em contacto brevemente. Quando o modelo é enviado, `{{first_name}}` é automaticamente substituído pelo nome próprio real de cada contacto. Portanto, se o nome do contacto for Sarah, a mensagem lê-se: "Olá Sarah, obrigado pelo seu interesse..." O separador **Pré-visualização** mostra a mensagem preenchida com um contacto de exemplo (John Doe, Acme Corp) — as mensagens reais utilizam os dados reais do destinatário. Ao pré-visualizar a partir do registo de um contacto existente, mostra os seus detalhes reais em vez disso — exatamente o que receberiam; um campo para o qual não têm valor é enviado vazio. **Dica:** Para reabrir conversas fechadas, pode criar modelos simples sem variáveis. Estes são frequentemente aprovados mais rapidamente porque são diretos. --- ## Submissão para Aprovação Após criar o seu modelo, clique em **Submeter para aprovação** — a plataforma envia-o automaticamente para a Meta para revisão. A forma como chega lá depende da ligação WhatsApp em que o número funciona: numa ligação WhatsApp gerida, é submetido através do seu fornecedor de mensagens e, se o número funcionar na sua própria conta WhatsApp Business, o modelo é criado diretamente nessa conta (consulte [Utilizar Modelos com a Sua Própria Conta Meta WhatsApp](#using-templates-with-your-own-meta-whatsapp-account) abaixo). De qualquer forma, é a Meta quem o revê. > **O editor de modelos não possui um seletor de categorias — a Meta decide a categoria.** Um modelo que cria aqui é submetido sem uma categoria declarada, o que significa que começa como **Utilidade** e a Meta reclassifica-o (normalmente para Marketing) se o conteúdo parecer promocional. As estimativas de custos na aplicação utilizam a taxa de Marketing quando a categoria de um modelo ainda não é conhecida, pelo que a estimativa é feita por precaução. Se precisar de declarar uma categoria específica, crie o modelo através da [Templates API](../api/templates.md). ### O que acontece durante a revisão: 1. O estado do seu modelo muda para **Pendente**. 2. A Meta revê o conteúdo para garantir que cumpre as suas políticas de mensagens. 3. O modelo é **Aprovado** ou **Rejeitado**. ### Quanto tempo demora a aprovação? A aprovação pode demorar desde alguns minutos a vários dias — a maioria dos modelos é revista no prazo de uma hora. Eis o que afeta o tempo de espera: - **Contas empresariais 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 demorar mais tempo ou ser rejeitados. **Dica:** Submeta os seus modelos alguns dias antes de planear iniciar uma transmissão, para não ficar à espera de aprovações à última hora. --- ## Utilizar Modelos com a Sua Própria Conta Meta WhatsApp Se o seu número WhatsApp funcionar na sua própria conta WhatsApp Business — quer a tenha configurado com [Ligar Através da Nossa Aplicação Meta](../messaging-channels/connect-through-our-meta-app.md) ou [Ligar a Sua Própria Aplicação 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 breve nota no topo da página indica-lhe quando esse é o caso, e os modelos que residem na sua conta WhatsApp Business apresentam uma pequena etiqueta **Meta** na lista. - **Os modelos são criados na sua própria conta WhatsApp Business.** Quando submete um, este é criado nessa conta e revisto diretamente pela Meta — o mesmo modelo aparece no seu Gestor do WhatsApp. - **As aprovações vêm da Meta.** Os estados **Aprovado**, **Pendente** e **Rejeitado** que vê aqui são decisões da própria Meta, e são atualizados nesta página assim que a Meta os toma (incluindo o motivo de uma rejeição). - **As regras de nomenclatura da Meta são aplicadas por si.** A Meta apenas aceita letras minúsculas, números e sublinhados no nome de um modelo. Escreva o que parecer melhor — a aplicação converte-o quando cria o modelo, pelo que `agendar-01` se torna `agendar_01`. - **Os modelos que já possui aparecem automaticamente.** Tudo o que já existe no seu Gestor do WhatsApp aparece na lista quando abre a página de Modelos, pelo que não há nada para recriar. Se adicionar ou alterar um modelo no Gestor do WhatsApp enquanto trabalha, clique em **Sincronizar da Meta** para o importar imediatamente. - **Eliminar remove-o também da Meta.** Eliminar um modelo aqui também o elimina da sua conta WhatsApp Business, por isso, aponte primeiro qualquer elemento que ainda o utilize para outro modelo. - **Categoria:** os modelos que cria na aplicação são submetidos sem uma categoria declarada — começam como **Utilidade** e a Meta reclassifica o conteúdo promocional (normalmente para Marketing) durante a revisão. Pode ser declarada uma categoria específica ao criar um modelo através da [Templates API](../api/templates.md). - **O envio permanece inalterado.** Os modelos aprovados são utilizados exatamente como antes — em transmissões, seguimentos e para reabrir uma conversa fora da janela de 24 horas. Apenas os modelos aprovados podem ser enviados. **Se a página lhe pedir para concluir a sua ligação**, a sua conta WhatsApp Business ainda não está totalmente ligada — volte a **Definições → Canais**, conclua a ligação e os modelos ficarão disponíveis imediatamente. --- ## Acompanhamento do Estado dos Modelos A página **Modelos** mostra todos os modelos com o seu estado atual, além de mosaicos de estatísticas para Total, Aprovado, Em revisão e Rejeitado. Pesquise e filtre por estado para encontrar um modelo específico. | Estado | O que significa | |---|---| | **Rascunho** | Criado, mas ainda não submetido à Meta. | | **Pendente** | Submetido e à espera que a Meta o reveja. | | **Aprovado** | Passou na revisão e está pronto a usar em transmissões e conversas. | | **Rejeitado** | Não passou na revisão. Leia o feedback da Meta, reveja a sua mensagem e volte a submeter. | Se um modelo for rejeitado, não se preocupe — pode editar o conteúdo e voltar a submetê-lo as vezes que forem necessárias. ### Editar 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 submeta a cópia para aprovação; os seus envios continuam a utilizar o modelo aprovado antigo até que o novo seja aprovado. Os rascunhos e os modelos rejeitados podem ser editados livremente. ### Enviar um Modelo Diretamente a um Contacto A partir da página de Modelos, clique na ação de envio em qualquer modelo **Aprovado** para o enviar diretamente para um dos seus contactos recentes — útil para uma reabertura pontual sem ter de criar uma difusão completa. Isto envia uma mensagem WhatsApp real, abre uma sessão de chat e utiliza créditos, pelo que a aplicação pede-lhe confirmação antes de enviar. ### Reenviar uma Mensagem de Abertura de Difusão Rejeitada A primeira mensagem de uma Difusão de saída é um modelo, pelo que também passa pela aprovação da Meta. Se for devolvida como **Rejeitada**, pode corrigi-la e reenviá-la sem sair do assistente de difusão: 1. Abra a difusão. 2. Clique no passo **Mensagem**. 3. A mensagem de abertura mostra o motivo da rejeição da Meta. 4. Edite o texto sinalizado pela Meta. 5. Reenvie a partir desse passo. A mensagem de abertura volta a ficar **Pendente** enquanto a Meta a revê. ::: warning **Importante:** Simplesmente reescrever a mensagem de abertura e guardar **não** a reenvia para aprovação — utilize a ação de reenvio do passo para que a nova versão seja efetivamente enviada à Meta. Até que uma nova versão seja aprovada, a difusão não pode ser enviada para contactos fora da janela de 24 horas. Também pode gerir e reenviar o mesmo modelo a partir da página **Modelos**. ::: --- ## Geração de Modelos com IA A plataforma pode gerar automaticamente modelos para si utilizando IA. Isto poupa tempo e ajuda-o a escrever mensagens com maior probabilidade de serem aprovadas. Os modelos gerados por IA são especialmente úteis para: - **Mensagens de abertura** — Quando cria uma Difusão e fornece o seu website ou páginas de vendas, a plataforma gera um modelo de abertura adequado com base no seu negócio. - **Sequências de seguimento** — A IA cria uma série de modelos de seguimento concebidos para reinteragir com os contactos em diferentes intervalos (por exemplo, dia 1, dia 3 e dia 7). - **Otimização** — Quando otimiza uma Difusão ou Agente existente, os modelos podem ser regenerados para corresponder à sua estratégia de mensagens atualizada. --- ## Reabrir Conversas Fechadas Quando a janela de mensagens de 24 horas do WhatsApp fecha, a interface de chat em Chats mostra uma notificação de que a conversa foi encerrada. Para a reabrir: 1. No chat, verá uma mensagem a dizer que a janela de conversa fechou. 2. Clique no botão **Reabrir** ou selecione um modelo a partir do menu pendente. 3. Escolha um modelo aprovado da lista. 4. O modelo é enviado ao contacto, reabrindo a conversa. 5. Assim que o contacto responder, a janela de 24 horas reinicia e pode voltar a enviar mensagens livremente. --- ## Modelos de Seguimento Os modelos de acompanhamento reativam automaticamente os contactos que não responderam a um envio efetuado. A plataforma suporta até **9 modelos de acompanhamento**, enviados em intervalos que pode configurar (por exemplo, 1 dia, 3 dias e 7 dias após a mensagem inicial). - Os modelos de seguimento são configurados no separador **Seguimentos** do Agente de IA que gere o canal. Esse separador não possui um botão de geração de modelos por IA, por isso escreva cada seguimento manualmente ou escolha um modelo aprovado existente. - Cada seguimento é um modelo aprovado separado. - A IA adapta cada seguimento para criar uma progressão natural de mensagens — para que os seus contactos não recebam a mesma mensagem repetidamente. **Dica:** Espaçar os seus seguimentos ao longo de vários dias tende a ser mais eficaz do que enviá-los seguidos. Dê tempo aos contactos para responderem antes de enviar o seguimento seguinte. --- ## Melhores Práticas para Obter a Aprovação de Modelos 1. **Seja direto** — Escreva mensagens claras e profissionais. Evite linguagem de vendas agressiva como "Compre já!" ou "Oferta por tempo limitado!!!" 2. **Mantenha a relevância** — Os modelos devem estar diretamente relacionados com uma interação esperada com o contacto. Se alguém se inscreveu na sua newsletter, um seguimento sobre os seus serviços faz sentido. Uma mensagem promocional aleatória não faz. 3. **Use gramática correta** — Mensagens bem escritas têm maior probabilidade de passar na revisão. 4. **Evite formatação excessiva** — Não utilize todas as letras em maiúsculas, pontos de exclamação excessivos ou filas de emojis. 5. **Limite links externos** — Se incluir links, certifique-se de que conduzem a páginas legítimas e verificadas. 6. **Comece de forma simples** — Se é novo nos modelos, comece com uma saudação ou seguimento simples antes de tentar conteúdos promocionais complexos. 7. **Corresponda ao seu negócio** — Certifique-se de que o conteúdo do modelo se alinha com a categoria da sua conta Meta Business verificada. --- ## Modelos de WhatsApp Web Se a sua difusão utiliza apenas **WhatsApp Web** (não a API do WhatsApp Business), os modelos são automaticamente aprovados sem revisão da Meta. Isto acontece porque as mensagens do WhatsApp Web são enviadas através da sua ligação pessoal ou empresarial ao WhatsApp, que não passa pelo mesmo processo de aprovação. **O que isto significa para si:** Se estiver a utilizar o WhatsApp Web, pode criar e utilizar modelos imediatamente sem esperar pela aprovação. No entanto, o WhatsApp Web tem outras limitações (como a estabilidade da ligação), pelo que muitas empresas preferem a API Business para mensagens de elevado 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).