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á 3 meses • 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.

7. Nas notificações

Ao configurar notificações em ações de automação, as variáveis permitem inserir dinamicamente informações nas notificações, como nome de usuário, número do pedido ou nome da oferta. Isso simplifica e acelera o processo de criação de notificações, tornando-as mais intuitivas e adaptáveis para diferentes cenários.

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)