# Como automatizar e-mails de ciclo de vida com eventos do Stripe

URL canônica: https://brew.new/pt-br/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events
Por Philip Sørensen
Publicado em 2026-09-18
Atualizado em 2026-09-29

O Stripe emite eventos quando assinaturas, faturas e pagamentos mudam. Esses eventos podem iniciar e-mails úteis, mas cada mensagem ainda precisa de um destinatário definido, de um objetivo e de uma regra para decidir se ela ainda chega na hora certa.

A [integração do Brew com o Stripe](/pt-br/browse/integrations/stripe) cuida da conexão OAuth e da configuração do webhook. Este guia mostra como desenhar o programa de e-mails que nasce daí. Para fluxos que começam em eventos do produto, e não na cobrança, veja [Automação de e-mail com IA](/pt-br/blog/ai-email-automation).

## Associe cada evento a uma única mensagem

| Objetivo | Evento candidato | Revise antes de enviar |
| --- | --- | --- |
| Dar boas-vindas a um assinante | `customer.subscription.created` | Evite boas-vindas duplicadas vindas do checkout |
| Explicar o fim de um período de teste | `customer.subscription.trial_will_end` | O prazo real e se haverá cobrança |
| Avisar sobre o pagamento de uma fatura com falha | `invoice.payment_failed` | A fatura atual, o link de cobrança, os avisos que o Stripe já envia |
| Explicar uma mudança de plano | `customer.subscription.updated` | Quais campos mudaram e se a mudança importa |
| Confirmar um cancelamento | `customer.subscription.deleted` | Quando o acesso termina e o que o cliente pediu |
| Explicar um reembolso | `refund.created` | Os campos específicos de reembolso disponíveis no evento |

Use a [referência de eventos do Stripe](https://docs.stripe.com/api/events/types) e o esquema do gatilho selecionado no Brew. Uma atualização de assinatura pode representar vários tipos de mudança; não envie um e-mail de mudança de plano a cada atualização sem verificar os dados dela.

## Conecte e publique com critério

Autorize o Stripe na página Integrações do Brew. O Brew registra o webhook e provisiona os gatilhos compatíveis. Não existe um botão para ativar ou desativar eventos: só as automações ativas vinculadas ao evento são executadas.

Use o botão Sincronizar clientes do Stripe se você precisar importar contatos antigos. Importar um contato de cobrança não estabelece consentimento para marketing. A opção Sincronizar nome completo, definida em cada evento, controla as atualizações de nome, não se os e-mails são disparados.

Monte a primeira automação como rascunho, examine o e-mail gerado e teste com destinatários controlados antes de publicar. Siga o [guia de configuração do Stripe](https://docs.brew.new/integrations/import/stripe) para os detalhes da conexão; o Brew conecta contas do Stripe no modo de produção, e os eventos do modo de teste não iniciam automações.

## Trate um pagamento com falha sem enviar lembretes desatualizados

Um aviso imediato da falha pode partir de `invoice.payment_failed`. Explique o que aconteceu e inclua um link para a sua própria página de cobrança. Não prometa que o Brew vai tentar a cobrança de novo; as operações de pagamento são responsabilidade do Stripe.

Para um lembrete três dias depois, faça a sua aplicação agendar uma verificação do status da fatura. Se a fatura continuar em aberto e o cliente continuar elegível, dispare um evento de lembrete separado no Brew. Se o pagamento tiver sido recuperado, encerre sem dispará-lo.

Depois de uma etapa Aguardar, os campos do evento ainda contêm o payload original. Uma condição em `contact.stripe_subscription_status` lê o valor atual do campo do contato no Brew quando esse nó é executado. Ela não consulta o Stripe nem prova que essa fatura específica foi paga. Um evento `invoice.paid` posterior não cancela automaticamente a execução anterior. E atualizar a forma de pagamento também não prova que o pagamento foi feito.

Teste a recuperação antes da verificação do lembrete, uma fatura que continua em aberto e uma nova tentativa da tarefa. Reutilize a mesma chave de idempotência para o mesmo evento lógico dentro da [janela de novas tentativas documentada](https://docs.brew.new/api-reference/api/idempotency).

## Personalize com campos declarados

O Brew pode sincronizar campos de cobrança nos contatos, inclusive o status da assinatura e o plano. Os payloads de eventos e os campos de contato são fontes diferentes. Leia o esquema do gatilho antes de usar `amount`, `currency`, `invoiceNumber`, `previousPlan`, `newPlan` ou `failureMessage`; nem todo evento traz todos esses campos.

Os IDs de objetos do Stripe ficam de fora do payload da automação. Não monte uma URL do portal do cliente a partir de um ID de fatura ou de assinatura presumido. Use a página de cobrança autenticada da sua aplicação ou um link enviado de propósito em um evento personalizado. Siga o [guia de tags de mesclagem](https://docs.brew.new/create-emails/merge-tags).

## Dê a cada sistema uma responsabilidade

Revise as [configurações de e-mails para clientes do Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails). Decida qual sistema envia recibos, avisos de falha no pagamento e lembretes. Ativar uma automação no Brew não desativa os e-mails do Stripe.

Deixe conteúdo promocional fora dos avisos de conta, a menos que você tenha revisado a finalidade e as permissões da mensagem. Lembretes de marketing exigem o consentimento correspondente e o tratamento dos descadastros.

## Confira o caminho inteiro

Confirme que o evento aparece no Brew, que a automação vinculada está ativa e que o histórico de execuções dela mostra o destinatário e o resultado esperados. Depois, examine o e-mail recebido e o link de cobrança. Se um evento chegou, mas nenhuma mensagem foi enviada, confira os filtros, as supressões e se o domínio de envio está pronto para enviar antes de concluir que o webhook falhou.

Comece com um evento e um e-mail testado. Só acrescente lembretes posteriores quando as verificações do estado atual e o comportamento das novas tentativas estiverem cobertos pelos testes da sua aplicação.