Skip to main content
As variáveis de sistema permitem personalizar mensagens, conduzir decisões do bot e registrar informações durante o atendimento.

​
Tipos de Variável

Dois tipos com escopos diferentes:
TipoSintaxeOnde pode ser usado
Global@NomePessoaIDR, templates, campanhas, HSM, API
Base de Dados{{contactname}}Apenas no fluxo de IDR (chatbot)
Exceção: @identificadororiginal (Global) é usada apenas em fluxos de IDR.
Exemplos de uso:
  • {{contactfirstname}} → retorna o primeiro nome do contato no fluxo IDR
  • @PrimeiroNome → retorna o primeiro nome em templates, campanhas e HSM

​
Variáveis de Contato

Dados cadastrais e de identificação do contato.
VariávelTipoDescrição
{{contactname}} / @NomePessoaBase de dados / GlobalNome completo do contato
{{contactfirstname}} / @PrimeiroNomeBase de dados / GlobalPrimeiro nome do contato
{{contactlastname}}Base de dadosÚltima palavra do nome do contato
{{contactemail}}Base de dadosE-mail principal do contato
{{contactid}} / @CPFCNPJBase de dados / GlobalCPF ou CNPJ cadastrado no Invenio
{{contactcustomcode}} / @ChaveClienteBase de dados / GlobalCódigo do cliente no Invenio
{{contactphonenumber}}Base de dadosNúmero de telefone completo (DDI + DDD + número)
{{contactphonenumberareacode}}Base de dadosApenas o DDD do contato
{{contactphonenumbermain}}Base de dadosNúmero sem DDI e DDD
{{contactrobbuid}}Base de dadoshashPessoa (ID do contato) para uso em fluxos disparados externamente

​
Variáveis de Atendimento

Dados sobre o atendimento, operador, segmento e protocolo.
VariávelTipoDescrição
{{segmentname}}Base de dadosSegmento (carteira) atual do contato
{{protocol}}Base de dadosNúmero do protocolo de atendimento
{{username}} / @NomeUsuarioBase de dados / GlobalNome do operador que enviou a última mensagem
{{loyalusername}}Base de dadosNome do operador atualmente fidelizado ao contato
{{lastloyalusername}}Base de dadosNome do último operador que atendeu o contato
{{internalwhatsappnumber}}Base de dadosNúmero do WhatsApp utilizado pelo bot
{{lastsentmessage}}Base de dadosÚltima mensagem enviada ao contato
{{fileurl}}Base de dadosURL do arquivo recebido/baixado durante o atendimento

​
Variáveis de Data e Hora

VariávelTipoDescrição
{{currentdate}}Base de dadosData atual no formato dd/MM/yyyy
{{currentdatetime}}Base de dadosData e hora no formato dd/MM/yyyy HH:mm:ss:ff
{{currenttime}}Base de dadosHora atual no formato HH:mm:ss:ff
{{currenthour}}Base de dadosHora atual no formato HH:mm
{{currentdateformat}}Base de dadosData formatada de acordo com o CodPais do cliente

​
Variáveis Coringa

Campos livres para personalização temporária por contato. Amplamente usados em campanhas, fluxos automatizados e templates.
VariávelTipoLimite
{{contactjoker1}} / @Coringa1Base de dados / GlobalAté 300 caracteres
{{contactjoker2}} / @Coringa2Base de dados / GlobalAté 300 caracteres
{{contactjoker3}} / @Coringa3Base de dados / GlobalAté 300 caracteres
{{contactjoker4}} / @Coringa4Base de dados / GlobalAté 300 caracteres
{{contactjoker5}} / @Coringa5Base de dados / GlobalAté 300 caracteres
Exemplo de uso em mensagem: "Olá, @PrimeiroNome! Sua parcela com @Coringa1 vence em @Coringa2." No envio, cada variável é substituída pelo valor do contato na campanha.

​
Variáveis Técnicas e de Integração

Usadas para processos integrados com API e lógicas condicionais no fluxo.
VariávelTipoDescrição
{{message}}Base de dadosÚltima mensagem recebida do contato
{{lastapiresponse}}Base de dadosResposta da última chamada de API executada
{{lastapistatuscode}}Base de dadosCódigo de status HTTP da última chamada de API (ex: 200, 404)
{{AdData}}Base de dadosDados da publicidade que o contato acionou via Facebook/Instagram

​
Variáveis de Localização e Navegação

VariávelTipoDescrição
{{longitude/latitude}}Base de dadosCoordenadas geográficas recebidas na interação do contato
@identificadororiginalGlobal*Redireciona o contato para a última etapa de “Aguardar mensagem de resposta”
@identificadororiginal: Embora seja uma variável global (sintaxe @), ela só funciona dentro de fluxos de IDR — não é aplicável em templates, campanhas ou HSM.

Templates de WhatsApp

Usar variáveis globais em templates

Importação de Público

Preencher Coringas no mailing CSV

Campanhas de WhatsApp

Aplicar variáveis em campanhas

Campanhas de E-mail

Tags de e-mail e personalização

Campanhas de SMS

Variáveis em mensagens de SMS

Enviar Mensagem (Live)

Usar variáveis via API

​
⁉️ Perguntas Frequentes (FAQ)

CaracterísticaGlobal (@)Base de Dados ({{}})
Sintaxe@NomePessoa{{contactname}}
IDR (chatbot)✅ Sim✅ Sim
Templates WhatsApp✅ Sim❌ Não
Campanhas (WhatsApp, Email, SMS)✅ Sim❌ Não
Envio manual HSM✅ Sim❌ Não
API Send✅ Sim❌ Não
Regra prática: Se vai usar fora do chatbot → use @Variavel. Se é fluxo interno de IDR → ambas funcionam.
Variáveis de Base de Dados (IDR):
Olá, {{contactfirstname}}! Seu protocolo é {{protocol}}.
Variáveis Globais (templates, campanhas, HSM):
Olá, @PrimeiroNome! Sua chave é @ChaveCliente.
Equivalentes: {{contactname}} = @NomePessoa — use conforme o contexto.
Armazenam informações personalizadas por contato, preenchidas no arquivo de importação (CSV).Caso de uso clássico:
  • CORINGA 1 = nome da empresa do cliente
  • CORINGA 2 = data de vencimento
  • Mensagem: "Olá, @PrimeiroNome! @Coringa1 tem uma pendência com vencimento em @Coringa2."
Disponível como {{contactjoker1}} em IDR e @Coringa1 em templates/campanhas.
Após executar uma ação de chamada de API no fluxo:
  • {{lastapiresponse}} → captura o corpo da resposta JSON
  • {{lastapistatuscode}} → captura o código HTTP (use para lógica condicional: se 200 → sucesso, se 404 → não encontrado)
Exemplo de uso: Chamar API de consulta de CPF → capturar o status → criar condição {{lastapistatuscode}} == 200 para prosseguir.
Usada para retornar o contato à última etapa de “Aguardar mensagem de resposta” do fluxo IDR.Útil quando: O contato enviou uma mensagem fora do contexto esperado e você quer redirecioná-lo ao ponto onde estava antes.⚠️ Funciona exclusivamente dentro de fluxos de IDR — não aplicável em templates ou campanhas.
Sim, mas apenas variáveis Globais (@):
  • ✅ @NomePessoa, @PrimeiroNome, @CPFCNPJ, @ChaveCliente
  • ✅ @Coringa1 a @Coringa5
  • ❌ {{contactname}}, {{protocol}} e demais {{}} não funcionam em templates
Consulte: Templates de WhatsApp
Captura os dados da publicidade (ad) que o contato acionou via Facebook ou Instagram antes de iniciar a conversa.Uso: Permite identificar qual anúncio gerou o contato, para personalizar o fluxo de acordo com a campanha de origem (ex: exibir oferta específica do anúncio clicado).É uma variável Base de Dados — disponível apenas em fluxos de IDR.
Contém o hashPessoa — o identificador interno único do contato no Invenio.Quando usar: Em fluxos disparados externamente via API, onde é necessário referenciar o contato pelo seu ID interno na plataforma.É uma variável Base de Dados — disponível apenas em fluxos de IDR.