Emails transacionais
A iugu permite personalizar totalmente os emails enviados a seus clientes, bem como desligar aqueles que você não se interessa em enviar. Utilizamos a linguagem Liquid para a customização dos emails. Dessa forma, o usuário pode criar loops, aplicar filtros em texto etc.
Disponibilizamos variáveis que podem ser utilizadas dentro dos emails através do Liquid (veja abaixo). Para informações sobre como utilizar Liquid, recomendamos acessar a wiki do projeto.
Emails disponíveis
- Lembrete de fatura: enviado para o cliente quando a fatura está perto de vencer.
- Fatura vencida: enviado para o cliente quando a fatura chega em sua data de vencimento.
- Recibo de fatura: enviado para o cliente quando a fatura é paga com sucesso.
- Fatura cancelada: enviado para o cliente quando uma fatura é cancelada.
- Estorno de fatura: email de reembolso de fatura.
- Recorrência/Assinatura: falha na cobrança: enviado quando há uma falha na cobrança automática de uma assinatura.
- Recorrência/Assinatura: nova conta: enviado quando a assinatura é criada.
- Recorrência/Assinatura: alterada: enviado quando alguma informação da assinatura mudou.
- Recorrência/Assinatura: suspensa: enviado quando a assinatura é suspensa.
- Assinatura: Últimos dias de período de testes: enviado para informar o tempo restante no período de teste da assinatura.
- Assinatura: Fim do período de testes: enviado ao fim do período de teste de uma assinatura.
Tipos de objetos
Fatura
Disponível para todos os emails transacionais que lidem com uma fatura ou cobrança.
Variável | Descrição |
---|---|
invoice.email | E-mail do cliente |
invoice.customer_ref | Nome do cliente |
invoice.created_at | Data de criação da fatura |
invoice.total | Valor total da fatura (Ex.: R$ 100,00) |
invoice.discount | Valor de desconto na fatura (Ex.: R$ 5,00) |
invoice.tax | Valor de imposto na fatura (Ex.: R$ 1,20) |
invoice.id | ID da fatura |
invoice.to_secure_id | ID seguro da fatura |
invoice.to_secure_url | URL segura para a fatura na web |
invoice.items | Array de itens da fatura, com os seguintes campos:item.price : Preço unitário do item. item.quantity : Quantidade do item.item.description : Descrição do item.item.total : Valor total (price x quantity) |
invoice.account_name | Nome da sua conta iugu |
invoice.updated_at | Data da última atualização da fatura |
invoice.due_date | Data de vencimento da fatura |
invoice.subscription | Assinatura que gerou essa fatura, se existir. |
invoice.bank_slip | Dados do boleto bancário com os seguintes campos:bank_slip.barcode_data_url : Código de barras em formato HTML.bank_slip.digitable_line : Linha digitável.bank_slip.bank_slip_url : URL da imagem do Boleto.bank_slip.bank_slip_pdf_url : PDF do Boleto |
invoice.pix | pix.qr_code_url : URL do QR Codepix.qr_code_text : Pix Copia e Cola |
Assinatura
Disponível para todos os emails transacionais que lidem com uma assinatura.
Variável | Descrição |
---|---|
subscription.price | Preço da assinatura (Ex.: R$ 15,00). |
subscription.customer_email | Email do cliente. |
subscription.customer_name | Nome do cliente. |
subscription.plan_name | Nome do plano da assinatura. |
subscription.features | Funcionalidades da assinatura em formato JSON. Ex.:json { :feature: { :name=>'Feature', :value=>0 } } |
subscription.account_name | Nome da sua conta iugu |
subscription.customer_ref | Nome, se existir, ou email do cliente. |
subscription.days_left | Número de dias restantes para o fim do ciclo atual da assinatura. |
subscription.trial_days_left | Número de dias restantes para o fim do período de teste da assinatura. |
Variáveis personalizadas
Você também pode adicionar variáveis personalizadas a uma fatura, numa assinatura ou num cadastro de cliente, durante a criação ou alteração dos mesmos, via painel de controle ou API.
Para exibir o valor dessas variáveis nos emails enviados, use o filtro custom_variable
entre as tags {{ }}
, por exemplo:
{{ invoice | custom_variable: 'nome_da_variavel’ }}
{{ subscription | custom_variable: 'nome_da_variavel’ }}
Essas variáveis podem ser utilizadas também na lógica do seu email.
Suponha que você tenha, para cada cliente, uma variável modelo
que identifica se ele é um varejo
(e-commerce tradicional) ou um marketplace
. Usando uma simples condicional, você pode alterar o conteúdo do email de nova conta para assinatura, por exemplo:
{% assign model = subscription.customer | custom_variable: 'modelo' %}
{% if model == 'varejo' %}
<p> ... </p>
{% elsif model == 'marketplace' %}
<p> ... </p>
{% endif %}
Updated 3 months ago