> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crmspark.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelos de mensagem

> Modelos de mensagem no Spark, variáveis manuais e automáticas (dados do chat), oficiais vs internos, e onde preencher variáveis em disparos, atalhos e API.

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](https://crmspark.com.br/dash/templates), 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.

<Note title="Resumo">
  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.
</Note>

## 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](https://crmspark.com.br/dash/templates), 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:

| Origem              | O que entra na variável                                                                                   |
| ------------------- | --------------------------------------------------------------------------------------------------------- |
| Nome do chat        | Nome exibido no chat; em conversas individuais, pode usar o nome do participante se o chat não tiver nome |
| Contato do chat     | Telefone ou identificador de contato exibido no chat                                                      |
| Aniversário         | Data de nascimento do participante (formato dd/mm/aaaa)                                                   |
| Campo personalizado | Valor de um [campo personalizado](/conceitos/campos-personalizados) 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.

<Tip title="Combine os dois tipos">
  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.
</Tip>

### Onde as variáveis entram em ação

| Uso                                       | Variáveis manuais                              | Variáveis automáticas                     |
| ----------------------------------------- | ---------------------------------------------- | ----------------------------------------- |
| [Disparos](/conceitos/disparos)           | Preenchidas ao **iniciar** o disparo           | Resolvidas por contato no envio           |
| [Atalhos](/conceitos/atalhos)             | Diálogo antes de enviar ou inserir no composer | Resolvidas para o chat aberto             |
| Automações                                | Definidas no nó que envia o modelo             | Resolvidas para cada chat da execução     |
| [API pública](/conceitos/desenvolvedores) | Campo `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](https://crmspark.com.br/dash/templates) no painel.