As variáveis de cliente (customer.*) são o conjunto que descreve quem é a pessoa — independente de pedido específico. São as informações de contato e identificação básicas.
Quando estão disponíveis
Praticamente em todo gatilho:
- Pedido pago, novo, atualizado, status alterado, avaliado
- Carrinho abandonado
- Novo lead
- Tag aplicada / removida
- Campanha
- Eventos de fluxo
Quase qualquer evento que dispara mensagem tem um cliente vinculado, então essas variáveis tendem a estar acessíveis.
Lista completa
| Caminho | Descrição | Exemplo |
|---|---|---|
customer.first_name |
Primeiro nome do cliente | João |
customer.last_name |
Sobrenome do cliente | Silva |
customer.full_name |
Nome completo | João Silva |
customer.email |
joao@exemplo.com |
|
customer.phone |
Telefone | 11999998888 |
Quando usar customer.* vs order.*
Em gatilhos de pedido, os mesmos dados aparecem nos dois conjuntos (customer.first_name e order.first_name, por exemplo). Tem diferença sutil:
order.*— dados como o cliente preencheu naquele pedido específico. É um snapshot do checkout.customer.*— dados do cadastro atual do cliente no Rishi.
Em quase todos os casos práticos, o resultado é igual. Use order.* em mensagens de pedido (mais consistente com o contexto), e customer.* em mensagens não relacionadas a pedido (lead, tag, campanha).
Exemplos práticos
Saudação de boas-vindas (lead novo)
Olá {{1}}, seja bem-vindo(a) à {{2}}!
Tô passando aqui pra te dar as boas-vindas. Quando precisar de algo, é só responder essa mensagem.
Mapeamento:
{{1}}→customer.first_name{{2}}(nome da loja) — texto fixo no template, não é variável dinâmica.
Aplicação de tag VIP
Parabéns, {{1}}! 🎉
Você foi adicionado(a) ao nosso programa VIP.
Em breve te mando os detalhes.
Mapeamento:
{{1}}→customer.first_name
Confirmação de cadastro com nome completo
Cadastro confirmado!
Seus dados: {{1}}
E-mail: {{2}}
Qualquer informação errada, é só responder por aqui.
Mapeamento:
{{1}}→customer.full_name{{2}}→customer.email
Considerações
Primeiro nome ou nome completo? Use first_name em saudações ("Olá Maria") — mais natural, mais íntimo. Use full_name em confirmações formais ("Cadastro de Maria Silva confirmado") — mais oficial. Sobrenome sozinho (last_name) raramente faz sentido em mensagem.
Cliente sem nome cadastrado — em gatilhos onde o cliente foi criado a partir de algo automático (ex: webhook que mandou só telefone), first_name pode vir vazio. Considere começar a mensagem com texto fixo ("Olá!") em vez de depender do nome.
Não envie e-mail/telefone como variável visível — customer.email e customer.phone são úteis em filtros internos ou em templates de confirmação cadastral. Em mensagens normais, não jogue o e-mail do cliente na mensagem dele — fica estranho. Ele já sabe o e-mail dele.
Em fluxos de recuperação de cliente inativo, dá pra usar customer.first_name pra personalizar sem ficar invasivo. "Maria, faz tempo que a gente não se vê por aqui" é melhor que "Cliente, faz tempo".
Próximos passos
- Pra dados específicos do pedido (valor, ID, rastreio), veja Variáveis de pedido.
- Pra cupom anexado ao gatilho, veja Variáveis de cupom.
- Pra ver quais conjuntos de variáveis cada gatilho expõe, Quais variáveis usar em cada tipo de gatilho.