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á 8 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. No link de redirecionamento do pagamento bem-sucedido da oferta

No link de redirecionamento após o pagamento bem-sucedido da oferta, estão disponíveis variáveis dos blocos contact.*, order.* e payment.*

Exemplo: https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

5. Nos blocos de informação das aulas

Variáveis e blocos condicionais funcionam dentro dos textos dos blocos informativos. Por exemplo:

Saudação pelo nome: Olá, {user.first_name}!
Exibição do nome do curso, data, status, etc.
Dados do contacto: {contact.name}, {contact.email} e outros campos
Dados da aula atual: {lesson.title}, {lesson.slug} e outros campos da aula
Blocos condicionais @if/@endif: mostrar conteúdo diferente dependendo de o contacto ter uma tag, acesso à oferta etc.

6. Nos emails

O uso de variáveis em e-mails permite tornar a comunicação mais personalizada e eficaz. Com a ajuda de variáveis, como {имя}, {дата} ou {название курса}, o e-mail parece ser dirigido pessoalmente ao cliente. Isso aumenta a confiança, o envolvimento e a probabilidade de o utilizador ler o e-mail até ao fim ou realizar a ação desejada. Além disso, as variáveis simplificam a automatização de envios em massa sem perder a abordagem 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
Essas variáveis estão disponíveis no link de redirecionamento do pagamento bem-sucedido da oferta.

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

Como alterar o valor de uma variável

Depois da variável, pode adicionar opções para mudar a sua aparência: acrescentar texto, pôr as letras em maiúsculas ou formatar a data.

Formato geral: {variable|option:value|option}. Por exemplo: {order.id|prefix:ORDER-} ou {payment.paid_at|format:DD.MM.YYYY}.

O que quer obter	O que escrever
Adicionar texto antes do valor	`{order.id\|prefix:ORDER-}` -> vai resultar em `ORDER-123`
Adicionar texto depois do valor	`{order.id\|suffix:-EU}` -> vai resultar em `123-EU`
Tornar o número de comprimento fixo	`{payment.number\|pad:6}` -> vai resultar em `000001`
Preencher não com zeros, mas com o seu próprio símbolo	`{payment.number\|pad:6\|padchar:_}` -> vai resultar em `_____1`
Pôr todas as letras em maiúsculas	`{contact.city\|upper}` -> `KYIV`
Pôr todas as letras em minúsculas	`{contact.city\|lower}` -> `kyiv`
Tornar maiúscula apenas a primeira letra	`{contact.city\|ucfirst}` -> `Kyiv`
Mostrar a data no formato desejado	`{payment.paid_at\|format:DD.MM.YYYY}` -> vai resultar em `24.12.2026`

Se quiser o seu próprio padrão de data, pode consultar as notações prontas nas documentações públicas: para variantes como DD.MM.YYYY, MMMM YYYY, dddd, serve a documentação do Carbon. Para variantes como Y-m-d e H:i:s, serve a documentação oficial do PHP.

Importante: se pad for usado, primeiro o valor é completado até ao comprimento desejado, e só depois são aplicadas as restantes opções.

Blocos condicionais @if / @endif

Permitem mostrar ou ocultar parte do texto dependendo de uma condição. Se a condição for verdadeira, o bloco é exibido; caso contrário, é removido completamente.

Sintaxe: @if(condição)...texto...@endif

Exemplo:
@if({contact.has|offer:123})Obtenha acesso aos materiais@endif

A condição dentro de @if() é qualquer variável que retorne true ou false. No momento, há suporte para {contact.has|...} (verificação de associação do contato).

Condição contact.has — verificação do contato

Permite verificar se o contato atende a determinadas condições. Retorna true ou false. Normalmente é usado junto com blocos condicionais @if/@endif.

Sintaxe: {contact.has|tipo:valor}

Tipo	Valor	Descrição
`offer`	ID da oferta	O contato tem acesso à oferta
`order`	ID do pedido	O contato tem um pedido com esse ID
`product`	ID do produto	O contato tem acesso ao produto
`tag`	ID ou nome da tag	O contato tem uma tag (cirílico e espaços no nome são suportados)
`list`	ID da lista	O contato faz parte da lista
`course`	ID do curso	O contato está inscrito no curso
`marathon`	ID do curso	Pseudônimo para course (maratona — subtipo de curso)
`webinar`	ID do webinar	O contato tem acesso ao webinar
`closed_group`	ID do grupo fechado	O contato tem acesso ao grupo fechado

É possível indicar várias condições usando | — todas elas devem ser atendidas ao mesmo tempo (lógica AND). Por exemplo: {contact.has|offer:123|tag:VIP}

Exemplos de uso:

{contact.has\|offer:123}	verifica a presença de uma oferta com ID 123
{contact.has\|tag:VIP}	verifica a tag pelo nome
{contact.has\|tag:тест тег}	tag com espaço e cirílico
{contact.has\|offer:123\|tag:VIP}	ambas as condições ao mesmo tempo (AND)

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)