Sincronização de clientes + gatilhos de evento
Conecte o Stripe via OAuth para disparar e-mails com a cara da sua marca quando uma assinatura começa, um período de teste está perto do fim ou o pagamento de uma fatura falha. O Brew registra o webhook e disponibiliza os eventos compatíveis como gatilhos de automação.
O Stripe continua responsável por pagamentos, novas tentativas de cobrança, reembolsos e mudanças de assinatura. O Brew cria e envia os e-mails.
Comece com um e-mail disparado pelo evento invoice.payment_failed. Para um lembrete posterior, faça a sua aplicação agendar uma nova verificação do status da fatura no Stripe. Dispare um evento personalizado separado no Brew só se a fatura continuar em aberto e o cliente ainda for elegível.
Depois de uma etapa Aguardar, os campos do evento ainda contêm o payload original do evento. Uma condição no campo contact.stripe_subscription_status lê o valor atual desse campo no contato do Brew quando aquele nó é executado. Ela não consulta o Stripe nem comprova que uma fatura específica foi paga. Atualizações do contato e novos eventos de pagamento não cancelam automaticamente uma execução anterior. Atualizar o cartão também não é prova de pagamento.
Teste os dois caminhos: um cliente com a fatura ainda em aberto, e que continua elegível, recebe o lembrete; um cliente que paga antes da verificação agendada não recebe. Teste as novas tentativas com o contrato de idempotência documentado.
O Brew é compatível com estes 22 tipos de evento:
Eventos de clientes e de assinaturas podem atualizar os contatos do Brew com o contexto de cobrança. Os campos de contato disponíveis incluem stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end e stripe_delinquent. A disponibilidade depende do evento do Stripe e dos dados recebidos.
Use o esquema de payload declarado do evento selecionado para as tags de mesclagem. Dependendo do evento, os campos incluem firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan e failureMessage. Os valores monetários ficam em centavos quando o esquema indica centavos.
Os identificadores de objetos do Stripe são removidos dos payloads das automações. Não presuma que IDs de faturas ou de assinaturas podem ser usados como tags de mesclagem. O Brew também não guarda o ID de cliente do Stripe no contato.
A opção Sincronizar nome completo, definida em cada evento, controla se o Stripe pode atualizar o nome do contato. Ela não ativa nem desativa um gatilho.
Um evento de pagamento posterior não cancela automaticamente uma execução iniciada por uma falha anterior. Agende uma verificação do lado da aplicação antes do lembrete e dispare um novo evento só enquanto a fatura continuar em aberto.
Receber um evento e enviar um e-mail são etapas separadas. Confirme que uma automação correspondente está ativa, examine os filtros e o histórico de execuções dela e verifique a elegibilidade do destinatário e o domínio de envio. A opção Sincronizar nome completo só controla as atualizações de nome.