Conecte o Stripe ao Brew, escolha os eventos de cobrança certos e verifique o status atual da fatura ou da assinatura antes de enviar lembretes posteriores.
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 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.
| 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 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.
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 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.
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.
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.
Revise as configurações de e-mails para clientes do Stripe. 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.
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.
