Variáveis, valor reserva e mídia no cabeçalho
Um modelo de mensagem pode ter partes que mudam de pessoa para pessoa, como o nome do cliente, o plano dele ou a data de vencimento. Essas partes são as variáveis. No último passo da campanha, você diz de onde sai o valor de cada uma: um texto igual para todos ou um dado de cada contato.
Este artigo explica as duas origens, o valor reserva, a mídia do cabeçalho e o que acontece quando um contato não tem o dado.
Onde ficam as variáveis
No passo Revise e agende o envio, logo abaixo do resumo, fica a seção Variáveis, com a descrição "De onde sai o valor de cada variável da mensagem". Ela só aparece quando o modelo tem variáveis.

Cada linha começa com uma etiqueta colorida com o nome da variável, como nome ou plano. Ao lado ficam a origem e o valor.
As duas origens

Valor fixo
Você digita um texto e ele vai igual para todos os destinatários. Serve para o que não muda de pessoa para pessoa, como o código de um cupom ou uma data de vencimento comum.
Dado do contato
Cada destinatário recebe o dado dele. Depois de escolher Dado do contato, escolha o campo:
Primeiro nome
Sobrenome
Nome completo
E-mail
os campos personalizados que vieram de uma importação de planilha feita nesta campanha, como "cidade" ou "plano".

Os campos personalizados só aparecem aqui quando foram criados numa importação de CSV dentro desta campanha. Veja Importe contatos por CSV e corrija os recusados.
Como as variáveis já chegam preenchidas
Ao abrir o passo, a Talqui adianta parte do trabalho:
Uma variável que o modelo já liga a um campo do contato, como o nome, nasce como Dado do contato com esse campo, e com o valor padrão do modelo como valor reserva.
As outras nascem como Valor fixo, já preenchidas com o valor padrão cadastrado no modelo.
Se o modelo não tem valor padrão para uma variável, ela nasce vazia, e você precisa preencher.
Valor reserva
Quando a origem é Dado do contato, aparece a opção Usar um valor reserva, que já vem ligada. Ela decide o que acontece com quem não tem aquele dado preenchido.
Valor reserva | Quem não tem o dado |
|---|---|
Ligado | Recebe o texto do campo Valor reserva (recomendado) no lugar do dado. Exemplo: "cliente" no lugar do nome |
Desligado | Não recebe a campanha e aparece como falha no relatório. Os outros contatos recebem normalmente |

Com alguma variável sem valor reserva, a seção mostra o aviso "Variáveis sem valor reserva: contatos que não tiverem esse dado não recebem a campanha e aparecem como falha no relatório."
Deixe o valor reserva ligado sempre que o texto continuar fazendo sentido com uma palavra genérica, como "Oi, cliente!". Desligue quando o dado for indispensável, como o valor de uma fatura: é melhor não enviar do que enviar errado.
Mídia no cabeçalho
Se o modelo tem uma imagem, um vídeo ou um documento no cabeçalho, a seção ganha uma variável a mais, chamada imagem, vídeo ou documento. Ela já vem preenchida com o link da mídia cadastrada no modelo, como Valor fixo.

Para usar outra mídia nesta campanha, troque o link por outro endereço público da imagem, do vídeo ou do documento.
A variável de mídia é obrigatória. O link precisa ser válido: sem ele, nenhum contato recebe.
A prévia da mensagem
A Pré-visualização da mensagem mostra o texto com as escolhas feitas. Num valor fixo, aparece o próprio texto. Num dado do contato, aparece o valor reserva ou, sem ele, o nome do campo, porque cada pessoa vai receber o dela.

Quando o botão de envio fica bloqueado
Uma variável está pendente quando:
está como Valor fixo e o campo está vazio (espaços em branco contam como vazio);
está como Dado do contato e nenhum campo foi escolhido.
Com qualquer variável pendente, aparece "Defina a origem de todas as variáveis do modelo para continuar" e o botão Enviar agora (ou Agendar campanha) fica bloqueado.
O que acontece no envio
Na hora de enviar, a Talqui confere os destinatários:
Se uma parte não tem o dado e a variável está sem valor reserva, a campanha sai normalmente para os outros. Quem ficou sem o dado aparece como falha no relatório, com as variáveis que faltaram.
Se nenhum dos destinatários conferidos tem o dado, a campanha não é enviada e aparece "N contatos estão sem valor para uma variável obrigatória". Ligue o valor reserva ou escolha outro campo.
Perguntas frequentes
Posso usar um campo personalizado que já existe nos contatos, sem importar planilha?
Hoje não. A lista de campos do contato traz os campos padrão e os campos criados numa importação de CSV feita nesta campanha.
O valor reserva é obrigatório?
Não. Mas sem ele, quem não tem o dado não recebe. Ele é marcado como recomendado justamente por isso.
Mudei uma variável e voltei para o passo anterior. Perdi o que escolhi?
As variáveis só ficam gravadas na hora de enviar ou agendar. Se sair do passo 4 antes disso, confira as escolhas de novo ao voltar.
A variável de imagem pode ficar vazia?
Não. A mídia do cabeçalho é obrigatória para o WhatsApp entregar a mensagem.
Como sei quem ficou sem receber por falta de dado?
Baixe o relatório da campanha. Essas pessoas aparecem com o status "Falhou" e a mensagem de erro indica as variáveis sem valor. Veja Status e relatório.
Continue explorando
Campos novos: crie campos personalizados ao importar uma planilha.
Antes de enviar: configure tags, continuidade e caixa de destino.
Este artigo foi útil?