Tanto a automação de Envio de Email quanto de Webhook podem utilizar variáveis que correspondem aos dados relacionados ao gatilho utilizado.
Por exemplo, em uma automação que utiliza gatilhos de pagamento, como Pagamento Confirmado, é possível usar variáveis relacionados à compra e ao comprador(a), tando no conteúdo do email quanto no payload da requisição via webhook.
Neste artigo você encontra as variáveis dos gatilhos de Pagamento e Engajamento, caso esteja utilizando gatilhos de Recorrência, você deve acessar o artigo de variáveis de recorrência.
Como utilizar uma variável
No corpo do email, ou no body da requisição, basta utilizar a variável entre colchetes, como por exemplo:
{{buyer_email}}
No caso acima, a variável será substituída pelo email do comprador.
Veja a relação de variáveis que podem ser utilizadas:
Variáveis dos Gatilhos de Venda
São as variáveis disponíveis nos gatilhos relacionados à venda: Boleto Vencido, Pix Vencido, Cartão de Crédito Recusado, Assinatura cancelada pelo cliente, Assinatura cancelada pelo produtor, Pagamento Confirmado, Pagamento via Order Bump Confirmado, Boleto Gerado, Pix Criado, Estorno através da operadora (Chargeback), Estorno feito pelo Produtor.
{{buyer_email}} | Email do comprador |
{{buyer_name}} | Nome do comprador |
{{buyer_phone}} | Telefone do comprador |
{{buyer_phone_raw}} | Telefone do comprador (sem formatação) |
{{buyer_document_id}} | CPF do comprador |
{{buyer_document_type}} | Tipo de documento do comprador (sempre CPF) |
{{buyer_city}} | Endereço: Cidade do comprador |
{{buyer_complement}} | Endereço: Complemento |
{{buyer_district}} | Endereço: Bairro |
{{buyer_address_number}} | Endereço: Número |
{{buyer_state}} | Endereço: Estado |
{{buyer_address_street}} | Endereço: Rua |
{{buyer_zip_code}} | Endereço: CEP |
{{offer_price }} | O valor da oferta em centavos. Caso seja R$150,00, virá como 15000 |
{{offer_price | money}} | O valor da oferta em reais. Caso seja R$150,00, virá como R$ 150,00. |
{{ offer_price | divided_by: 100.00}} | O valor da oferta em reais sem R$. Caso seja R$ 150,00, virá 150.0 |
{{offer_discount_value}} | O valor do desconto aplicado na oferta (caso seja utilizado um cupom) |
{{offer_with_discount}} | O valor da oferta com o desconto aplicado (caso seja utilizado um cupom) |
{{offer_kind}} | O tipo da oferta - "common" (comum); "subscription" (assinatura) |
{{offer_title}} | O nome da oferta |
{{offer_id}} | ID da Oferta |
{{product_id}} | O ID do produto |
{{product_name}} | O nome do produto |
{{payment_id}} | O ID da transação |
{{payment_method}} | O método de pagamento - "credit_card" (cartão de crédito); "pix" (pix); "bank_slip" (boleto) |
{{payment_status}} | O status do pagamento - "paid" (pago); "refused" (recusado); "error" (erro); "refunded" (estornado); "chargeback" (chargeback); "overdue" (expirado) |
{{payment_date}} | A data de confirmação do pagamento |
{{created_at}} | A data de criação da transação |
{{payment_value}} | Valor pago pelo comprador em centavos. |
{{payment_value | divided_by: 100.00}} | Valor pago pelo comprador em reais. |
{{installments}} | Número de parcelas |
{{installments_fees}} | Valor da taxa de juros do parcelamento em centavos |
{{net_value_cents}} | Valor líquido da venda em centavos |
{{subscription_id}} |
ID da assinatura do comprador (apenas para pagamentos relativos à assinaturas) |
{{subscription_type}} |
Tipo de recorrência: recurrency (assinatura) / installment (parcelamento de boleto ou pix) / smart_installment (parcelamento inteligente) |
{{subscription_next_invoice_at}} |
Data da próxima fatura da recorrência |
{{subscription_expiration_at}} |
Data de encerramento da recorrência |
{{upsell}} |
Indica se a venda é um upsell (true/false). |
{{cart_src}} |
SRC |
{{utm_id}} |
UTM id |
{{utm_source}} |
UTM source |
{{utm_medium}} |
UTM medium |
{{utm_campaign}} |
UTM campaign |
{{utm_term}} |
UTM term |
{{utm_content}} |
UTM content |
Variáveis específicas dos gatilhos de venda
PIX
{{pix_expiration_at}} | Data de expiração do PIX |
{{pix_code}} | Código do PIX Copia e Cola |
{{pix_qr_code_url}} | URL com a imagem do QR Code |
Boleto
{{boleto_expiration_at}} | Data de vencimento do Boleto |
{{bank_slip_barcode}} | Código de barras do boleto |
{{bank_slip_file_url}} | URL do boleto |
Cartão de crédito recusado
{{credit_card_refused_message}} | Motivo da recusa do cartão de crédito |
Assinatura cancelada
{{subscription_canceled_by}} | Quem cancelou assinatura (produtor ou aluno) |
{{subscription_status}} | Status da assinatura - "paid" (paga); "overdue" (em atraso); "refused" (pagamento recusado); "canceled" (cancelada) |
{{subscription_available_until}} |
Data de término do ciclo atual da assinatura |
Você pode utilizar o JSON de exemplo abaixo, que contém todas as variáveis de pagamento existentes. Algumas delas terão valor nulo caso não tenham referência (ex.: código do PIX em um pagamento de cartão de crédito). Lembre-se que você pode editar livremente o JSON de acordo com sua necessidade.
{
"upsell": "{{upsell}}",
"cart_src": "{{cart_src}}",
"utm_id": "{{utm_id}}",
"utm_source": "{{utm_source}}",
"utm_medium": "{{utm_medium}}",
"utm_term": "{{utm_term}}",
"utm_content": "{{utm_content}}",
"utm_campaign": "{{utm_campaign}}",
"offer_id": "{{offer_id}}",
"pix_code": "{{pix_code}}",
"buyer_city": "{{buyer_city}}",
"buyer_name": "{{buyer_name}}",
"offer_kind": "{{offer_kind}}",
"payment_id": "{{payment_id}}",
"product_id": "{{product_id}}",
"buyer_email": "{{buyer_email}}",
"buyer_phone": "{{buyer_phone}}",
"buyer_state": "{{buyer_state}}",
"offer_price": "{{offer_price }}",
"offer_title": "{{offer_title}}",
"installments": "{{installments}}",
"payment_date": "{{payment_date}}",
"created_at": "{{created_at}}",
"product_name": "{{product_name}}",
"payment_value": "{{payment_value}}",
"buyer_district": "{{buyer_district}}",
"payment_method": "{{payment_method}}",
"payment_status": "{{payment_status}}",
"buyer_phone_raw": "{{buyer_phone_raw}}",
"net_value_cents": "{{net_value_cents}}",
"pix_qr_code_url": "{{pix_qr_code_url}}",
"subscription_id": "{{subscription_id}}",
"buyer_complement": "{{buyer_complement}}",
"bank_slip_barcode": "{{bank_slip_barcode}}",
"buyer_document_id": "{{buyer_document_id}}",
"installments_fees": "{{installments_fees}}",
"offer_price_money": "{{offer_price | money}}",
"pix_expiration_at": "{{pix_expiration_at}}",
"subscription_type": "{{subscription_type}}",
"bank_slip_file_url": "{{bank_slip_file_url}}",
"buyer_document_type": "{{buyer_document_type}}",
"offer_price_divided": "{{offer_price | divided_by: 100.00}}",
"offer_with_discount": "{{offer_with_discount}}",
"boleto_expiration_at": "{{boleto_expiration_at}}",
"buyer_address_number": "{{buyer_address_number}}",
"buyer_address_street": "{{buyer_address_street}}",
"buyer_zip_code": "{{buyer_zip_code}}",
"offer_discount_value": "{{offer_discount_value}}",
"payment_value_divided": "{{payment_value | divided_by: 100.00}}",
"subscription_expiration_at": "{{subscription_expiration_at}}",
"credit_card_refused_message": "{{credit_card_refused_message}}",
"offer_with_discount_divided": "{{offer_with_discount | divided_by: 100.00}}",
"subscription_next_invoice_at": "{{subscription_next_invoice_at}}",
"subscription_canceled_by": "{{subscription_canceled_by}}",
"subscription_status": "{{subscription_status}}",
"subscription_available_until": "{{subscription_available_until}}"
}
Variáveis dos Gatilhos de Engajamento
São as variáveis disponíveis nos gatilhos relacionados ao engajamento: Progresso em 25%, Progresso em 50%, Progresso em 75%, Progresso em 100%, Certificado emitido.
{{user.email}} | Email do aluno |
{{ user | fullname | remove_quotation_marks }} | Nome do aluno |
{{school.id}} | ID da Plataforma |
{{school.name}} | Nome da Plataforma |
{{school.url}} | URL da plataforma |
{{enrollment.id}} | ID da matrícula |
{{school_product.id}} | ID do produto |
{{ school_product.title | remove_quotation_marks }} |
Nome do produto |
{{ lead_phone }} |
Telefone do lead |
{{lead_name}} |
Nome do lead |
{{funnel_id}} |
ID do funil |
{{funnel_template_name}} |
Nome do template usado na captura do lead |
{{lead_email}} |
E-mail do lead |
{{lead_from_import}} |
Se o lead foi gerado por importação |
Variáveis específicas dos gatilhos de engajamento
Emissão de certificado
{{certificate.created_at}} | Data de emissão do certificado |
Variáveis especiais: now
Você pode usar uma variável especial em qualquer automação para registrar a data de envio do webhook.
{{ 'now' | date: '%Y-%m-%d %H:%M' }} |
Data de envio do webhook. Ex.: 2024-01-31 16:31 |