Central de ajuda KWIGA Serviços, integrações, API, Configurações Configurações gerais Uso de variáveis no projeto, lista de variáveis disponíveis

Uso de variáveis no projeto, lista de variáveis disponíveis

Artigos:

há 2 semanas • Atualizado

Este artigo explica como utilizar variáveis no seu projeto — onde aplicá-las, quais dados estão disponíveis e como usá-las para automação e personalização. Inclui uma lista com descrições e exemplos para e-mails, webhooks, botões, aulas e muito mais.

Informações gerais sobre variáveis

Variáveis são uma maneira conveniente de inserir dados personalizados em vários elementos do seu projeto. Elas podem ser usadas nos seguintes locais:

1. Webhooks em automações

As variáveis podem ser inseridas:

no URL do webhook, por exemplo:
https://example.com/hook?user={user.email}
nos parâmetros do corpo da solicitação
nos cabeçalhos

Isso permite enviar dados pessoais para serviços de terceiros automaticamente.

2. CTA (Call to Action)

Em botões e links, as variáveis podem ser usadas para:

personalizar o texto do botão
transmitir dados através de links, como ID do usuário ou tags UTM

3. Nos parâmetros

As variáveis podem ser usadas em parâmetros de formulários ou outros elementos:

email do usuário
ID da assinatura
códigos únicos e tags
qualquer outra variável disponível no contexto

4. No link de redirecionamento (se não for usado para pagamento)

Você pode adicionar variáveis manualmente no link de redirecionamento:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. Nos blocos de informação das aulas

As variáveis funcionam dentro dos textos dos blocos de informação. Por exemplo:

Saudação pelo nome: Olá, {user.first_name}!
Exibição do nome do curso, data, status, etc.

6. Nos emails

O uso de variáveis nos emails permite tornar a comunicação mais personalizada e eficaz. Com variáveis como {nome}, {data} ou {nome do curso}, o email parece pessoalmente direcionado ao cliente. Isso aumenta a confiança, o engajamento e a probabilidade de o usuário ler o email até o fim ou realizar a ação desejada. Além disso, as variáveis simplificam a automação de envios em massa sem perder o toque individual.

Lista de variáveis disponíveis

Lista de variáveis disponíveis em todos os locais onde as variáveis podem ser usadas.

Variável	Valor
contact.id	ID do contato
contact.user_id	ID do usuário
contact.first_name	Nome do contato
contact.last_name	Sobrenome do contato
contact.middle_name	Nome do meio do contato
contact.name	Nome completo do contato
contact.email	Email do contato
contact.phone	Telefone do contato
contact.country	País do contato. Por exemplo: Ucrânia
contact.timezone	Fuso horário do contato. Por exemplo: Europe/Kyiv
contact.currency	Moeda do contato. Por exemplo: USD
contact.city	Cidade do contato
contact.utm_source	Lista de utm_source únicos do contato (separador ", ")
contact.utm_medium	Lista de utm_medium únicos do contato (separador ", ")
contact.utm_campaign	Lista de utm_campaign únicos do contato (separador ", ")
contact.utm_term	Lista de utm_term únicos do contato (separador ", ")
contact.utm_content	Lista de utm_content únicos do contato (separador ", ")
contact.field_<id>	Campos personalizados (descrição abaixo)
datetime	Data e hora em UTC no formato YYYY-MM-DD HH:mm:ss
contact.visit_source	Fonte da visita

Campos personalizados

{contact.field_<id>}

Exemplo {contact.field_123}

<id> - id do campo que pode ser obtido nas configurações dos campos de contato (exemplo https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Variáveis que podem ser usadas adicionalmente em CTA

nos parâmetros
no link de redirecionamento (se não for usado para pagamento)

Variável	Valor
first_name	Nome do pedido
last_name	Sobrenome do pedido
middle_name	Nome do meio do pedido
name	Nome completo do pedido
email	Email do pedido
phone	Telefone do pedido
field_<id>	Campos personalizados Telefone do pedido (descrição abaixo)
utm_source	utm_source - especificamente da visita em que o pedido foi feito
utm_medium	utm_medium - especificamente da visita em que o pedido foi feito
utm_campaign	utm_campaign - especificamente da visita em que o pedido foi feito
utm_term	utm_term - especificamente da visita em que o pedido foi feito
utm_content	utm_content - especificamente da visita em que o pedido foi feito
widget_landing	Url da landing page de onde o pedido foi enviado
widget_landign_referer	Referer que estava na landing page quando o pedido foi enviado
Também em determinados formulários podem estar disponíveis variáveis, descritas abaixo em Variáveis disponíveis nos webhooks de automação Por pedido ({order.}) - Se a opção de formulário Acesso ao produto (Acesso total/Por oferta) for selecionada Por produto({product.}) - Se a opção de formulário Acesso ao produto + Acesso total for selecionada Por oferta ({offer.*}) - Se a opção de formulário Acesso ao produto + Por oferta for selecionada

Campos personalizados

{field_<id>}

Exemplo {contact.field_123}

<id> - id do campo que pode ser obtido nas configurações dos campos de contato (exemplo https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Se na página onde o CTA ou script Kwiga para rastreamento de visitas estiverem, houver visitas com tags utm, e o cliente fizer uma solicitação na landing page já sem as tags utm, então nessas variáveis elas estarão ausentes. Mas estarão disponíveis nas variáveis {contact.utm_...}, que estão descritas acima.

Variáveis disponíveis em webhooks de automação (url, parâmetros, emails)