Skip to main content
Um modelo de mensagem é um texto (e, quando fizer sentido, imagem ou arquivo) que você guarda pronto para usar de novo: no atendimento, em campanhas ou em fluxos automáticos. Em vez de redigir a mesma coisa do zero, você escolhe o modelo, ajusta o que for variável — como o nome do cliente — e envia com consistência.

Para que servem no dia a dia

  • Agilidade: respostas e comunicações repetidas ficam padronizadas.
  • Qualidade: o time fala com a mesma voz e com menos erro de digitação.
  • Campanhas e lembretes: mensagens pensadas de antemão, com revisão e alinhamento.
No Spark, os modelos ficam na área de modelos de mensagem, onde você cria, edita e organiza a biblioteca da sua operação.

Dois tipos: o que muda na prática

Modelos não oficiais (internos)

São os modelos que só existem na sua operação: você monta o texto como quiser (dentro do que cada canal permite) e reaproveita no atendimento, campanhas ou automações. Onde dá para usar: em qualquer plataforma que você use no Spark (WhatsApp, Instagram, Telegram, etc.) — o modelo em si não fica preso a um canal só. Limitação no Instagram e no WhatsApp Business: nesses canais, mensagens “livres” como as dos modelos não oficiais só podem ser enviadas dentro da janela de resposta — ou seja, enquanto as regras daquele canal consideram que você ainda está respondendo a uma conversa recente com aquela pessoa. Passou esse período, não adianta tentar empurrar o mesmo tipo de mensagem só com modelo interno; aí o caminho no WhatsApp é o modelo oficial (abaixo). Em outros canais, as regras podem ser diferentes; o Spark ainda assim usa o mesmo conceito de modelo interno como atalho.

Modelos oficiais (WhatsApp Business)

Servem para mandar mensagem em qualquer momento, mesmo quando a janela de resposta já fechou — mas somente no WhatsApp Business (conta comercial ligada ao WhatsApp). Não existem como “oficiais” no Instagram ou no Telegram da mesma forma. Na prática:
  • o texto precisa ser enviado para aprovação do WhatsApp antes de usar;
  • cada envio costuma gerar custo (cobrança ligada ao uso de modelo aprovado — valores e regras são do próprio WhatsApp);
  • o conteúdo segue formato definido (partes fixas e partes que você preenche, como nome ou número do pedido);
  • as variáveis no texto seguem o padrão numérico da Meta: {{1}}, {{2}}, {{3}} (em sequência);
  • cada variável precisa de título e exemplo na configuração do modelo (o exemplo para aprovação na Meta tem limite de 15 caracteres);
  • depois de aprovado, mudanças grandes podem exigir mandar de novo para análise.
Tipos que o WhatsApp usa para classificar, em linguagem simples:
  • Promoções e ofertas — divulgar algo e convidar à ação.
  • Utilidade — confirmações, lembretes, atualização de pedido ou agendamento.
  • Códigos e confirmações de acesso — validar identidade ou entregar um código.
Não oficiais: qualquer plataforma; no Instagram e no WhatsApp Business, só dentro da janela de resposta. Oficiais: qualquer hora no WhatsApp Business, com aprovação e custo por uso.

Variáveis no modelo

Modelos podem ter trechos dinâmicos no texto — por exemplo, o nome do cliente ou a data de um evento. No Spark, cada variável é identificada no conteúdo como {{1}}, {{2}}, {{3}} e assim por diante (formato alinhado à Meta nos modelos oficiais). Ao criar ou editar um modelo em Modelos de mensagem, use o botão Variável no editor de texto para inserir campos. Depois, configure cada variável na seção de definições: título (o que a equipe vê ao preencher), exemplo (prévia e, nos oficiais, envio à Meta) e tipo de preenchimento.

Variáveis manuais

São valores que você informa uma vez antes de enviar (ou na configuração da automação). O mesmo valor vale para todo o envio naquele contexto:
  • em um disparo, o valor é igual para todos os destinatários da campanha;
  • em um atalho no chat, você preenche na hora e a mensagem sai para aquele contato;
  • na API pública, você envia os valores no corpo da requisição;
  • em uma automação, você define os valores fixos no nó que envia o modelo — eles serão reutilizados em cada execução.
Quando o modelo tem variáveis manuais, o Spark abre um diálogo Preencher variáveis do modelo antes de continuar (disparo, atalho etc.). Só é possível seguir depois de preencher todos os campos obrigatórios.

Variáveis automáticas (dados do chat)

São preenchidas pelo Spark, para cada destinatário, com informações do chat — você não digita na hora do envio. Use quando quiser personalizar por pessoa sem montar lista manual. Na configuração do modelo, escolha o tipo Automático — dados do chat e indique a origem:
OrigemO que entra na variável
Nome do chatNome exibido no chat; em conversas individuais, pode usar o nome do participante se o chat não tiver nome
Contato do chatTelefone ou identificador de contato exibido no chat
AniversárioData de nascimento do participante (formato dd/mm/aaaa)
Campo personalizadoValor de um campo personalizado vinculado ao chat (por slug do campo)
Em disparos, cada contato recebe a mensagem com suas variáveis automáticas resolvidas; as manuais continuam iguais para todos.
Exemplo: {{1}} manual com o nome da promoção (“Black Friday”) e {{2}} automática com o nome do chat — uma campanha única com texto personalizado por destinatário.

Onde as variáveis entram em ação

UsoVariáveis manuaisVariáveis automáticas
DisparosPreenchidas ao iniciar o disparoResolvidas por contato no envio
AtalhosDiálogo antes de enviar ou inserir no composerResolvidas para o chat aberto
AutomaçõesDefinidas no nó que envia o modeloResolvidas para cada chat da execução
API públicaCampo commonVariables (var1, var2, …)Preenchidas pelo Spark; não envie no body
Se um modelo não tiver variáveis manuais, o envio segue direto, sem diálogo extra.

Boas práticas

  • Nomeie os modelos de um jeito que qualquer pessoa do time entenda (“Lembrete agendamento”, “Pós-venda NPS”, não só “Modelo 3”).
  • Revise antes de pedir aprovação nos oficiais: erros e promessas confusas costumam ser motivo de reprovação.
  • Menos é mais: textos claros e curtos costumam funcionar melhor que blocos enormes.
  • Combine com a operação: modelo oficial de marketing não substitui bom atendimento quando o cliente responde no chat — use cada tipo onde faz sentido.
  • Em variáveis automáticas, garanta que o chat tenha os dados necessários (nome, contato, campos personalizados); se estiver vazio, a variável pode sair em branco na mensagem.
  • Títulos claros nas variáveis manuais ajudam o time na hora do disparo (“Código do cupom”, não só “Variável 1”).
Para criar ou gerenciar modelos, abra Modelos de mensagem no painel.