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?

    Quando você pede uma automação de WhatsApp, a IA cria um modelo de mensagem (template oficial aprovado pela Meta) em vez de escrever um texto livre. É 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 oficial já conectado. Veja Conectar o WhatsApp.
    • 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. 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.

    4. A automação é 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.

    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.