Quais variáveis usar em cada tipo de gatilho

Cada tipo de gatilho expõe um conjunto específico de variáveis. Esse artigo é a referência cruzada: você vê o gatilho que vai usar e descobre quais grupos de variáveis estão disponíveis ali.

Pra detalhes de cada grupo (lista completa, exemplos, considerações), o artigo correspondente está linkado em cada seção.

Tabela rápida

Gatilhos de pedido

Cobertos: Pedido pago, Pedido novo, Status do pedido alterado, Pedido atualizado, Pedido avaliado.

Em todos esses, você tem acesso a:

• Variáveis de pedido (order.*) — ID, valor, status, dados do comprador, endereço, rastreio, forma de pagamento, cupom usado.
• Variáveis de cliente (customer.*) — nome, e-mail, telefone do cliente.
• Variáveis de cupom (coupon.*) — quando o gatilho gera ou anexa um cupom.

Use principalmente order.* em mensagens de pedido — é o snapshot consistente daquela compra. customer.* complementa quando precisar de dados que só vivem no cliente. coupon.* raramente em utilidade (mensagens de pedido caem em utilidade); mais comum em cupons gerados em fluxos posteriores ao pedido.

Exemplos de uso:

• Pagamento aprovado → order.first_name, order.external_id, order.total.
• Postado com rastreio → order.external_id, order.tracking_code.
• Pix gerado → order.first_name, order.external_id, order.total.

Carrinho abandonado

Único gatilho que expõe o conjunto cart_*.

Disponível:

• Variáveis de carrinho abandonado (cart_*) — ID, total, link de retomada, token.
• Variáveis de cliente (customer.*) — pra personalizar com nome.
• Variáveis de cupom (coupon.*) — quando o fluxo gera cupom de incentivo.

Use sempre cart_url — sem o link, a recuperação não converte. Combine com customer.first_name no início e, em mensagens posteriores do fluxo, agregue coupon.* pra dar incentivo.

Exemplos de uso:

• Lembrete simples → customer.first_name, cart_total_formatted, cart_url.
• Recuperação com cupom → adicione coupon.code, coupon.amount, coupon.expires_in_days.

Novo lead

Disparado quando entra um lead novo (cadastro, opt-in, importação).

Disponível:

• Variáveis de cliente (customer.*) — nome, e-mail, telefone.
• Variáveis de cupom (coupon.*) — se o fluxo dá cupom de boas-vindas.

Não há variáveis de pedido porque o lead ainda não comprou. Não tente acessar order.id aqui — vem vazio.

Exemplos de uso:

• Boas-vindas → customer.first_name.
• Boas-vindas com cupom → adicione coupon.code, coupon.amount.

Tag aplicada / Tag removida

Disparados quando uma tag é adicionada ou removida do cliente. Bom pra fluxos de fidelização (VIP, inativo, top spender, etc).

Disponível:

• Variáveis de cliente (customer.*).
• Variáveis de cupom (coupon.*) — em fluxos de fidelização que dão benefício na entrada.

A tag em si não vira variável diretamente — o que importa pro template é quem virou alvo dela.

Exemplos de uso:

• Entrou no programa VIP → customer.first_name.
• Cliente reativado → customer.first_name, coupon.code, coupon.amount.

Campanha

Disparado por uma campanha agendada (ex: dispara pra um segmento específico em data X).

Disponível:

• Variáveis de cliente (customer.*).
• campaign.name — nome da campanha que disparou. Útil pra incluir contexto no template ("Você é VIP do programa Aniversário do Cliente").
• Variáveis de cupom (coupon.*) — quase sempre presente em campanhas.

Exemplos de uso:

• Campanha de aniversário → customer.first_name, coupon.code, coupon.expires_in_days.

Evento de fluxo

Eventos genéricos disparados dentro de fluxos (passos intermediários, conclusões de jornada).

Disponível:

• Variáveis de cliente (customer.*).
• Variáveis de cupom (coupon.*).

Cobre o caso quando você precisa mandar mensagem em um ponto específico de um fluxo customizado — sem dados de pedido nem carrinho.

Webhooks externos

Mensagens criadas via webhook genérico não usam esse schema fixo. Os nomes das variáveis são os que você define ao criar a mensagem, e os valores vêm direto do JSON que seu sistema envia.

Detalhes em Variáveis dinâmicas em mensagens via webhook.

Erro comum: variável de gatilho errado

Se você acessa order.total num gatilho de Tag aplicada, vem vazio — porque tag não tem pedido vinculado. O Rishi não vai te alertar antes do envio (a mensagem sai com a variável em branco), então a única forma de descobrir é em teste ou em log de produção.