Modelos de mensagem

Os modelos são corpos de mensagem reutilizáveis que você pode enviar por WhatsApp ou e-mail, manualmente ou a partir de uma campanha.

Variáveis #

Os modelos aceitam marcadores {{variable}} que são preenchidos com as estatísticas mais recentes e o perfil do host no momento do envio. Variáveis comuns:

• {{first_name}}
• {{diamonds}}
• {{hours}}
• {{valid_days}}
• {{month}}

…e mais. O renderizador busca os valores mais recentes de cada contato, então o mesmo modelo é personalizado por destinatário.

Para um relatório semanal, {{hours_hm}} escreve as horas de live como 10h 30m, e {{month_name}} escreve o mês sem o ano (Novembro). {{period_start_day}} e {{period_end_day}} são os números de dia do intervalo que uma importação de Documentos recebeu: 1 e 8 para 2026-11-01 ~ 2026-11-08. Para um host cuja Data de início no registro de plataforma cai dentro desse intervalo, o primeiro é esse dia. Os dois são preenchidos apenas por uma importação de Documentos cuja coluna de data contém um intervalo. Caso contrário ficam vazios, inclusive depois que os números desse período são alterados à mão ou importados de novo com uma única data, e para um intervalo que passa de um mês para outro.

Uma mensagem enviada em massa (de Contatos, ou por WhatsApp aos participantes de um evento) ou por uma campanha não é enviada a um host para quem um valor usado pelo modelo está vazio quando a mensagem é enviada ou entra na fila; em um e-mail, é um valor do assunto ou do texto. A mensagem de uma etapa de integração não entra na fila para esse host; a mensagem de cada etapa é preparada quando a integração começa. O envio em massa nomeia os hosts que pulou, uma execução de campanha os conta e a integração registra cada etapa pulada no seu histórico. Um zero é um valor, não um vazio. {{level}} e {{payment_amount}}, que estão sempre vazios, nunca causam um pulo.

{{weekday_in_3_days}} escreve o dia da semana 3 dias depois do envio da mensagem, com a preposição e sem data: na sexta (em inglês, on Friday). Funciona qualquer número de 0 (hoje) a 7, por exemplo {{weekday_in_1_days}}. O dia é o da sua agência, no fuso horário dela. Uma etapa de integração conta a partir do dia em que a etapa é enviada, depois do atraso. {{TODAY+3}}, como os modelos do app antigo escreviam, funciona igual em uma mensagem; um modelo enviado para aprovação do WhatsApp precisa da forma {{weekday_in_3_days}}.

Modelos de e-mail #

Os modelos podem ter um assunto para os envios por e-mail. Um passo de uma sequência de integração referencia um modelo, e o passo é ignorado automaticamente se o contato não tiver o canal de que aquele passo precisa.

Aprovação do WhatsApp #

O WhatsApp só entrega o seu próprio texto aos hosts que escreveram para o seu número nas últimas 24 horas. Para alcançar os outros, o WhatsApp precisa antes aprovar a mensagem como modelo. Para escrever a um host pelo seu próprio WhatsApp, sem esperar a aprovação, use Abrir no WhatsApp.

Na página de um modelo, um administrador da agência que não trabalha em uma subagência pode usar Enviar ao WhatsApp. Escolha o idioma em que a mensagem está escrita, uma categoria (Utilidade para informações de que o host precisa sobre a própria conta, sem promoção; Marketing para todo o resto; o preço do WhatsApp depende da categoria), o número pelo qual enviar e um exemplo para cada variável. O WhatsApp costuma decidir em até 24 horas. A página mostra o status (Em análise, Aprovado, Rejeitado com o motivo do WhatsApp, Pausado ou Desativado), e Atualizar status do WhatsApp consulta de novo. Não é possível enviar uma mensagem que começa ou termina com uma variável, usa uma variável que este app não consegue preencher ou tem mais de 1.024 caracteres. Para enviar, é preciso um número com ID da conta do WhatsApp Business (veja WhatsApp).

Envio de um modelo aprovado #

Um modelo que você envia pelo WhatsApp, pela lista de Contatos, pelos participantes de um evento, por uma campanha ou por um passo de integração, vai ao WhatsApp como o modelo aprovado quando tudo isto vale:

• o WhatsApp o aprovou no idioma do host, e o modelo não mudou desde então. Se ele mudar depois da aprovação, um administrador da agência inteira usa Enviar ao WhatsApp de novo: até o texto novo ser aprovado, ele vai como texto comum, e a página do modelo indica isso;
• ele foi aprovado na conta do WhatsApp Business do número pelo qual a mensagem sai;
• o texto é exatamente o modelo preenchido para aquele host no momento do envio. Se você mudar qualquer coisa antes de enviar, mesmo um espaço dentro do texto, ele vai como texto comum; espaços ou quebras de linha no começo ou no fim não contam;
• sua agência envia os modelos aprovados Sempre, ou Só quando necessário e o host não escreveu para aquele número nas últimas 24 horas. Uma mensagem em um grupo não conta.

Caso contrário, vai como texto comum, como antes, e o WhatsApp só o entrega aos hosts que escreveram para aquele número nas últimas 24 horas. Um modelo com uma variável que fica vazia para um host também vai como texto comum para esse host.

Se o WhatsApp recusar um modelo aprovado, por exemplo porque foi pausado depois, a mensagem aparece como falha. Ela não é enviada de novo como texto comum.

Um administrador da agência inteira escolhe entre Sempre e Só quando necessário em Configurações → Canais, em Quando enviar modelos do WhatsApp aprovados. O WhatsApp pode cobrar pelas mensagens de modelo. Uma agência que não escolheu usa Só quando necessário. A página do modelo mostra qual a sua agência usa.

Idioma #

Nomes de meses e dias da semana, o status do host e os números são escritos no idioma do host, seja quem for que envie a mensagem — por exemplo, {{month}} fica agosto 2026 e {{hours}} fica 2,5 para um host que usa português do Brasil. Um host sem idioma salvo recebe o idioma padrão. A pré-visualização de um modelo mostra a mensagem no idioma do host escolhido. Consulte Localização.