Rishidocs
Perguntar à IA

Variáveis do gatilho Carrinho abandonado (CartFlows)

4 min de leituraAtualizado há 9 horas

O gatilho Carrinho abandonado (CartFlows) dispara quando o plugin CartFlows — Cart Abandonment Recovery identifica que um cliente preencheu telefone no checkout e saiu sem concluir. Ele tem um conjunto próprio de variáveis — diferente do gatilho nativo de carrinho abandonado do Rishi. Esse aqui é específico do CartFlows e só aparece quando o CartFlows está ativo na loja.

Quando esse gatilho dispara

Só dispara quando o CartFlows — Cart Abandonment Recovery está instalado e o cliente:

  1. Preencheu o telefone no checkout do CartFlows.
  2. Não concluiu o pedido dentro do tempo configurado no próprio CartFlows.
  3. Tem um template de e-mail de recuperação ativo no CartFlows — é esse template que aciona o gatilho.

Em Configurações da mensagem → Gatilho, você vai ver uma entrada pra cada template de recuperação cadastrado no CartFlows (algo como Carrinho abandonado: Primeiro contato, Carrinho abandonado: Lembrete final, etc.). Cada template dispara seu próprio gatilho — você escolhe qual.

Os gatilhos só aparecem na lista se você já tiver pelo menos um template de e-mail cadastrado no CartFlows. Crie os templates no CartFlows primeiro, depois volte aqui pra configurar as mensagens.

Variáveis disponíveis

Variável Descrição Exemplo
{{first_name}} Primeiro nome preenchido no checkout Maria
{{last_name}} Sobrenome Silva
{{email}} E-mail informado maria@exemplo.com
{{phone_number}} Telefone informado (já tratado pelo CartFlows) 5511999998888
{{order_status}} Status do carrinho no CartFlows abandoned
{{checkout_url}} URL completa pra retomar o checkout, já com token https://loja.com/checkout/?wcf_ac_token=...
{{coupon_code}} Código do cupom anexado ao template (se houver) VOLTA10
{{product_names}} Lista de produtos do carrinho, separada por vírgula Camiseta Preta, Caneca Branca
{{cart_total}} Total do carrinho R$ 199,90

Não confunda com as variáveis cart_* do gatilho nativo de carrinho abandonado do Rishi. São conjuntos diferentes pra produtos diferentes — o gatilho (CartFlows) usa first_name, checkout_url, etc. (sem prefixo). O gatilho nativo do Rishi usa cart_id, cart_url, etc. Eles não se misturam.

Exemplo de mensagem

Template configurado no Rishi:

Oi {{1}}! Vi que você esqueceu uns produtinhos no carrinho 🛒

{{2}}
Total: {{3}}

Volta lá pra finalizar:

Mapeamento das variáveis:

  • {{1}} → {{first_name}}
  • {{2}} → {{product_names}}
  • {{3}} → {{cart_total}}

E aí entra o botão de retomar o checkout — leia a próxima seção, é o ponto mais sensível.

Dica: o jeito mais fácil de configurar o botão pro checkout

Templates da Meta não aceitam URLs inteiras como variável em botões. Você precisa de uma URL com prefixo fixo + parte variável. Existem duas estratégias que funcionam:

Estratégia recomendada — domínio fixo + path variável.

  1. No template (no painel do Rishi ou direto na Meta), configure o botão de URL como:

    https://home-url.com/{{1}}

    O domínio aí é só placeholder pra você visualizar — substitua pelo domínio real da loja (https://sualoja.com.br/{{1}}).

  2. Na configuração da mensagem do gatilho, mapeie o {{1}} desse botão pra:

    {{checkout_url|relative_url}}

O modificador |relative_url é processado pelo Rishi quando recebe o webhook: ele pega a checkout_url (que vem completa, tipo https://sualoja.com.br/checkout/?wcf_ac_token=...) e devolve só o caminho relativo (/checkout/?wcf_ac_token=...), que encaixa direitinho depois do domínio do template.

Resultado final pro cliente: ele clica no botão e cai no checkout dele, com o token correto, na URL certa. A Meta aprova porque o domínio é fixo.

Esse padrão (https://seudominio.com/{{1}} + {{variavel|relative_url}}) funciona pra qualquer variável que devolva URL — não só checkout_url. Vale lembrar quando for criar botões em outros gatilhos.

Considerações

cart_total já vem formatado — o CartFlows envia o total com R$ e separadores corretos. Você não precisa formatar de novo no template.

coupon_code pode vir vazio — depende do template do CartFlows ter cupom configurado. Se você quer mensagens com e sem cupom, crie duas mensagens separadas vinculadas a templates do CartFlows diferentes (um com cupom, outro sem), em vez de tentar condicionar no template da Meta.

product_names é uma string única — não é uma lista estruturada. Vem tipo Camiseta Preta, Caneca Branca (vírgula + espaço, com & no último item se forem 2+). Cole direto no template, sem tentar processar.

Categorização do template Meta — recuperação de carrinho é classificada como marketing pela Meta. Você vai pagar como marketing — é o esperado. Em quase todo cenário, o retorno da recuperação compensa muito o custo.

Próximos passos

Foi útil?