Como podemos ajudar você hoje?

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.

Seção Variáveis com o nome como dado do contato e as outras como valor fixo

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

Lista de origens de uma variável: Valor fixo e Dado do contato

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".

Lista de campos do contato, com os campos padrão e os importados por planilha

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

Aviso de variável sem valor reserva

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.

Variável de imagem do cabeçalho, preenchida com o link da mídia do modelo
  • 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.

Pré-visualização da mensagem com as variáveis preenchidas

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

Atualizado em 07 de novembro de 2026

Este artigo foi útil?