Disparadores por eventos de autenticación
Conecta Clerk para activar emails fieles a tu marca cuando alguien se registra, se une a una organización, empieza una suscripción de Clerk Billing o se apunta a tu lista de espera. Clerk firma cada webhook y Brew convierte 13 tipos de evento en disparadores de automatizaciones.
Clerk sigue encargándose del inicio de sesión, las organizaciones y la facturación. Brew solo escucha los eventos: no puede modificar usuarios, crear organizaciones ni cobrar suscripciones.
El evento organization.created no incluye ninguna dirección de email. Brew busca el ID de usuario del creador entre las identidades que ya ha visto en eventos anteriores de Clerk de la conexión actual. Si encuentra un email real, el evento sigue adelante. Si no, Brew registra el evento con un destinatario no resuelto, no crea ningún contacto y no inicia ninguna automatización.
Suscribe también el endpoint a user.created para que Brew pueda conocer las direcciones de los creadores. Para un email que tiene que llegar siempre a una persona, usa organizationMembership.created, que incluye la dirección del miembro.
Brew admite 13 tipos de evento:
Cada evento verificado con una dirección de email real crea o actualiza un contacto de Brew, identificado por su email, tanto si alguna automatización usa el evento como si no. Cuando los datos están disponibles, Brew completa el nombre, el apellido y clerk_user_id.
El evento user.created también completa clerk_username, clerk_image_url, clerk_signed_up_at y clerk_last_sign_in_at. Los eventos de invitación y de pertenencia completan clerk_organization_id, clerk_org_role y clerk_org_role_name. Las invitaciones añaden clerk_org_invitation_status, y las pertenencias, clerk_organization_name y clerk_organization_slug.
Los eventos de facturación completan clerk_subscription_status y clerk_plan_name, y algunos añaden clerk_plan_slug, clerk_subscription_period_end o clerk_is_trialing. El evento paymentAttempt.created completa clerk_last_payment_attempt_status y clerk_last_payment_attempt_at, y waitlistEntry.created completa clerk_waitlist_status.
Usa el esquema de payload declarado del evento seleccionado para las etiquetas de combinación. Todos los eventos incluyen email, firstName, lastName y createdAt. Los demás campos, como planName, planAmount, roleName, organizationName y grandTotalFormatted, dependen del evento. Los campos planAmount y grandTotalAmount están en la unidad más pequeña de la moneda, así que, en USD, 2000 equivale a 20,00 dólares. Las marcas de tiempo se expresan en segundos Unix.
Los ID de los objetos de Clerk, como los de usuario, organización y suscripción, no son etiquetas de combinación. El ID de usuario se guarda en el contacto como clerk_user_id.
Una cuenta de Clerk no acredita el consentimiento para emails de marketing. Guarda el consentimiento en el momento del registro y compruébalo antes de hacer envíos promocionales.
No de forma fiable. Brew solo recibe paymentAttempt.created, no las actualizaciones posteriores del intento. Su campo status puede valer pending, paid o failed, pero un pago que falla después de crearse el intento llega a Brew como un evento no compatible. Para los pagos vencidos, usa subscriptionItem.pastDue. Para mostrar un total en el texto del email, grandTotalFormatted contiene un valor ya formateado, como $22.00.
Recibir un evento y enviar un email son pasos distintos. Confirma que haya una automatización coincidente activa; después, revisa sus filtros y su historial de ejecuciones, y comprueba que el destinatario pueda recibir el email y el estado del dominio de envío. Una entrega hecha con Send Example verifica el webhook, pero nunca inicia una automatización, y un evento organization.created sin un creador conocido se registra como no resuelto.
