For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/max/create-whatsapp-template-with-ai.md.
  • Português

      • Como a IA cria um modelo de mensagem do WhatsApp?

      Peça direto no chat — "cria um template de boas-vindas pro WhatsApp e manda pra aprovação" — ou peça uma automação de WhatsApp. Nos dois casos a IA cria um modelo de mensagem (template oficial aprovado pela Meta), mostra o texto final, envia para a Meta só depois da sua confirmação e fecha com um botão que abre os templates do número. É a única forma de a mensagem realmente chegar em quem não falou com você nas últimas 24 horas.

      Antes de começar:

      • Papel: Proprietário, Administrador ou Editor.
      • Um número de WhatsApp conectado pela API oficial. Veja Conectar o WhatsApp. Sem ele, a IA explica o que é preciso e abre a tela de conexão — veja Como pedir para a IA conectar um canal?.
      • O WhatsApp Web não usa modelos da Meta: ele envia texto livre. Se você só tem número pelo WhatsApp Web, a IA avisa que modelo exige a API oficial.
      • Tenha em mente o texto que você quer enviar e quais partes mudam por contato (nome, número do pedido, data).

      Por que modelo e não mensagem livre

      O WhatsApp só permite mensagem escrita na hora dentro da janela de atendimento de 24 horas — as 24 horas seguintes à última mensagem que o contato enviou para você. Fora dessa janela, só um modelo aprovado é entregue.

      Automação disparada por funil, etiqueta, agendamento ou compra não tem janela aberta: o contato não falou com você antes. Por isso a IA usa modelo nesses casos, e só usa texto livre quando a própria automação começa com uma mensagem recebida no WhatsApp.

      Isso é uma questão de entrega, não de custo: a Meta cobra por conversa dos dois jeitos.

      1. A IA procura antes de criar

      Na ordem, ela tenta:

      1. Um modelo que você já tem aprovado e que já diz o que você quer — nada a esperar, envia hoje.
      2. A biblioteca da Meta, quando o caso é comum (código de verificação, atualização de pedido, lembrete de agendamento). São modelos que a Meta já revisou, com aprovação quase imediata.
      3. Um modelo novo, escrito do zero quando nenhum dos anteriores serve.

      2. O texto é conferido antes de salvar

      Um modelo novo é conferido contra as regras da Meta antes de ser gravado, e todos os problemas voltam de uma vez para a IA corrigir. As regras principais:

      • as variáveis são numeradas em sequência e o texto não pode começar nem terminar com uma delas — sempre há texto fixo em volta;
      • cada variável precisa de um valor de exemplo real (a Meta revisa o exemplo, não só o modelo);
      • corpo de até 1024 caracteres, cabeçalho e rodapé de até 60;
      • no máximo 10 emojis no corpo, e nenhum emoji, quebra de linha ou formatação no cabeçalho de texto;
      • botões com rótulo de até 25 caracteres, no máximo 2 botões de link, e o botão de cupom só em modelos de marketing.

      O nome do modelo é ajustado automaticamente para o formato que a Meta aceita: "Boas Vindas" vira boas_vindas.

      3. Peça ajustes comentando o modelo

      A IA mostra o modelo no balão do WhatsApp, com cabeçalho, rodapé e botões, como o contato vai ver. Para pedir mudanças, comente direto no balão:

      • Num trecho: selecione o trecho no balão e clique em Comentar. O campo abre por cima do texto, junto do trecho.
      • Na mensagem toda: clique no modelo. O campo abre por cima do texto, no ponto do clique.

      Escreva o que mudar e aperte Enter (Shift+Enter quebra a linha). Para fechar o campo sem comentar, clique de novo no modelo. Você pode deixar quantos comentários quiser: eles aparecem embaixo do modelo e num chip acima do campo de mensagem. Na próxima mensagem que você mandar, a IA recebe todos de uma vez, ajusta o rascunho e mostra o modelo revisado. Para tirar um comentário, use o X dele; para descartar todos, o X do chip.

      Os comentários ficam só na tela: se você recarregar a página antes de mandar a mensagem, eles se perdem. Para comentar outras partes da conversa (texto, cards de página ou funil) junto com o modelo, veja Como comentar uma resposta do Max?.

      4. Você confirma o texto antes do envio para análise

      Enviar o modelo para a Meta é uma ação externa e praticamente irreversível: a análise leva de horas a dias, e um modelo recusado afeta a nota de qualidade do seu número. Por isso a IA mostra o texto final e só envia para análise depois da sua confirmação.

      5. Pergunte se os modelos foram aprovados

      "Meus templates foram aprovados?" A IA lê a situação real de cada modelo do número (com mais de um número oficial, ela pergunta qual):

      • Rascunho: salvo na Clickmax, ainda não foi para a Meta.
      • Em análise: a Meta está revisando.
      • Aprovado: já pode ser enviado.
      • Reprovado ou Pausado: a IA mostra o motivo que a Meta deu e oferece reescrever.
      • Falha no envio: não chegou à Meta; a IA mostra o motivo e oferece corrigir e enviar de novo.

      Se a Meta mudou a categoria do modelo (por exemplo, de utilidade para marketing), a IA mostra as duas.

      6. Dentro de uma automação, ela é montada mesmo com o modelo em análise

      A IA não espera a Meta para terminar seu trabalho: ela monta a automação inteira e já aponta o passo de WhatsApp para o modelo em análise. O restante da automação funciona de imediato; o envio pelo WhatsApp começa quando a Meta aprovar o modelo.

      Fora de automação, a IA para no modelo enviado e no botão para os templates do número. Acompanhe a situação do modelo na área de WhatsApp. Veja também Criar modelos de mensagem do WhatsApp.

      Relacionados

      Se não funcionou

      • A IA disse que não pode escrever uma mensagem livre no seu caso: a automação não começa por uma mensagem recebida no WhatsApp, então a janela de 24 horas está fechada — peça o modelo, que é o caminho que entrega.
      • O modelo está há dias em análise: o prazo é da Meta, não da Clickmax; acompanhe pela área de WhatsApp.
      • O modelo foi recusado pela Meta: peça para a IA reescrever a partir do motivo da recusa e enviar de novo. Veja Modelo do WhatsApp com envio recusado.
      • Uma ação foi bloqueada por um erro: veja os Códigos de erro.