Conecta Stripe a Brew, elige bien los eventos de facturación y comprueba el estado actual de la factura o la suscripción antes de los recordatorios posteriores.
Stripe emite eventos cuando cambian las suscripciones, las facturas y los pagos. Esos eventos pueden iniciar emails útiles, pero cada mensaje sigue necesitando un destinatario y un propósito definidos, y una regla para decidir si todavía es oportuno.
La integración de Brew con Stripe se encarga de la conexión OAuth y de configurar el webhook. Esta guía explica cómo diseñar el programa de emails que sale de ahí. Para los flujos que parten de eventos del producto en lugar de la facturación, consulta automatización de emails con IA.
| Objetivo | Evento candidato | Qué revisar antes de enviar |
|---|---|---|
| Dar la bienvenida a un suscriptor | customer.subscription.created |
Que no salga otra bienvenida desde el checkout |
| Avisar de que termina una prueba | customer.subscription.trial_will_end |
La fecha real de fin y si se va a hacer un cargo |
| Informar de un pago de factura fallido | invoice.payment_failed |
La factura actual, el enlace de facturación y los avisos que ya envía Stripe |
| Explicar un cambio de plan | customer.subscription.updated |
Qué campos cambiaron y si el cambio es relevante |
| Confirmar una cancelación | customer.subscription.deleted |
Cuándo termina el acceso y qué pidió el cliente |
| Explicar un reembolso | refund.created |
Los campos específicos del reembolso disponibles en el evento |
Usa la referencia de eventos de Stripe y el esquema del disparador de Brew que hayas seleccionado. Una actualización de la suscripción puede representar varios tipos de cambio; no envíes un email de cambio de plan por cada actualización sin comprobar sus datos.
Autoriza Stripe en la página Integraciones de Brew. Brew registra el webhook y aprovisiona los disparadores compatibles. No hay ningún interruptor para activar o desactivar eventos. Solo se ejecutan las automatizaciones activas vinculadas al evento.
Usa Sincronizar clientes de Stripe si necesitas importar contactos históricos. Importar un contacto de facturación no acredita el consentimiento para emails de marketing. El ajuste Sincronizar el nombre completo, que se configura por evento, controla las actualizaciones del nombre, no si se envían los emails.
Crea la primera automatización como borrador, revisa el email generado y haz pruebas con destinatarios controlados antes de publicarla. Sigue la guía de configuración de Stripe para los detalles de la conexión; Brew conecta cuentas reales de Stripe, y los eventos del modo de prueba no inician automatizaciones.
Un aviso inmediato del fallo puede partir de invoice.payment_failed. Explica qué ha pasado y enlaza a tu propia página de facturación. No prometas que Brew reintentará el cargo: de las operaciones de pago se encarga Stripe.
Para un recordatorio tres días después, haz que tu aplicación programe una comprobación del estado de la factura. Si la factura sigue sin pagarse y el cliente aún cumple los requisitos, lanza un evento de recordatorio de Brew aparte. Si el pago se ha recuperado, termina sin lanzarlo.
Tras un paso de Espera, los campos del evento siguen conteniendo el payload original. Una condición sobre contact.stripe_subscription_status lee el valor actual del campo en el contacto de Brew cuando se ejecuta ese nodo. No consulta Stripe ni demuestra que se haya pagado esta factura concreta. Un evento invoice.paid posterior no cancela automáticamente la ejecución anterior. Actualizar el método de pago tampoco demuestra que se haya pagado.
Prueba tres casos: un pago que se recupera antes de la comprobación del recordatorio, una factura que sigue sin pagarse y una tarea que se reintenta. Reutiliza la clave de idempotencia para el mismo evento lógico dentro de la ventana de reintentos documentada.
Brew puede sincronizar campos de facturación en los contactos, entre ellos el estado de la suscripción y el plan. Los payloads de los eventos y los campos de contacto son fuentes distintas. Lee el esquema del disparador antes de usar amount, currency, invoiceNumber, previousPlan, newPlan o failureMessage; no todos los eventos incluyen todos los campos.
Los ID de objetos de Stripe se omiten del payload de la automatización. No construyas la URL de un portal de clientes a partir de un ID de factura o de suscripción que supongas. Usa la página de facturación autenticada de tu aplicación o un enlace que proporciones expresamente en un evento personalizado. Sigue la guía de etiquetas de combinación.
Revisa la configuración de los emails a clientes de Stripe. Decide qué sistema envía los recibos, los avisos de pago fallido y los recordatorios. Activar una automatización de Brew no desactiva los emails de Stripe.
No incluyas contenido promocional en un aviso sobre la cuenta a menos que hayas revisado la finalidad del mensaje y los permisos. Los recordatorios de marketing requieren el consentimiento correspondiente y la gestión de las bajas.
Confirma que el evento aparece en Brew, que la automatización vinculada está activa y que su historial de ejecuciones muestra el destinatario y el resultado esperados. Después, revisa el email recibido y el enlace de facturación. Si llegó un evento pero no se envió ningún mensaje, revisa los filtros, las supresiones y si el dominio de envío está listo antes de dar por hecho que falló el webhook.
Empieza con un evento y un email probado. Añade los recordatorios posteriores solo cuando las pruebas de tu aplicación cubran las comprobaciones del estado actual y el comportamiento ante los reintentos.
