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: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áveis de Atendimento

Dados sobre o atendimento, operador, segmento e protocolo.

​
Variáveis de Data e Hora

​
Variáveis Coringa

Campos livres para personalização temporária por contato. Amplamente usados em campanhas, fluxos automatizados e templates.
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áveis de Localização e Navegação

@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)

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):
Variáveis Globais (templates, campanhas, HSM):
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.