# WorkOS + Brew

Activa automatizaciones de Brew con eventos de WorkOS de usuario, autenticación, restablecimiento de contraseña, organización, sincronización de directorios (SCIM), conexión e invitación.

URL canónica: https://brew.new/es/browse/integrations/workos

- Dirección: Entrada de datos
- Conexión: Secreto del webhook
- Disparadores de autenticación empresarial

## Funciones disponibles

- **Disparadores por eventos**: Activa automatizaciones de Brew con eventos de WorkOS de usuario, autenticación, organización, sincronización de directorios y conexión.

## Convierte los eventos de WorkOS en emails útiles

Conecta WorkOS para activar emails fieles a tu marca cuando se crea un usuario o cuando un usuario verifica su email, restablece su contraseña, se une a una organización o se aprovisiona mediante la sincronización de directorios. Brew convierte 18 tipos de evento de WorkOS en disparadores de automatizaciones.

WorkOS sigue encargándose del SSO, la sincronización de directorios, el inicio de sesión y los restablecimientos de contraseña. Brew solo escucha los eventos, y crea y envía los emails que vienen después.


## Qué puedes crear

- Emails de bienvenida: el evento user.created se emite cuando se aprovisiona un usuario de WorkOS, y authentication.email_verification_succeeded, cuando el usuario verifica su email. Elige un solo disparador para no enviar dos bienvenidas.
- Confirmaciones de restablecimiento de contraseña: el evento password_reset.succeeded se emite cuando se completa un restablecimiento. Es un evento de primer nivel de WorkOS, no forma parte de authentication.*.
- Avisos de inicio de sesión: el evento authentication.magic_auth_succeeded se emite cuando se completa un inicio de sesión con magic link, y authentication.password_failed, cuando falla un inicio de sesión con contraseña. Los dos van dirigidos al usuario, y ninguno expone la dirección IP ni el user agent como etiqueta de combinación.
- Onboarding de equipos: los eventos organization_membership.created e invitation.accepted se emiten los dos cuando alguien se une, e incluyen role. Elige un solo disparador para no enviar dos bienvenidas.
- Avisos de cambio de rol: el evento organization_membership.updated se emite cuando cambia una pertenencia, por ejemplo, por un nuevo rol.
- Usuarios sincronizados desde el directorio: los eventos dsync.user.created, dsync.user.updated y dsync.user.deleted mantienen los contactos de Brew sincronizados con tu directorio SCIM.
- Avisos de salida: los eventos user.deleted y organization_membership.deleted se emiten cuando se elimina un usuario o este deja una organización.

## Los eventos de organización y de conexión no generan emails

Los eventos organization.created, organization.updated, organization.deleted y connection.activated no incluyen ningún destinatario. Brew los registra en Eventos recientes como no resueltos y no inicia ninguna automatización.

Para enviar un email a una persona sobre una organización nueva, usa un evento que incluya su dirección, como organization_membership.created o invitation.accepted.

Los eventos de pertenencia, autenticación y directorio sin dirección de email pueden seguir adelante si Brew ya ha visto un email real para el mismo usuario, pertenencia o usuario de directorio de WorkOS en la conexión actual.


## Configura WorkOS en Brew

- Abre Integraciones, elige WorkOS y selecciona Generar URL del webhook.
- En el panel de WorkOS, abre Webhooks, crea un endpoint y pega la URL de Brew.
- Suscribe el endpoint a los 18 eventos compatibles: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated e invitation.accepted. No selecciones authentication.*, que añade eventos de autenticación que Brew no admite.
- Copia el secreto de firma del endpoint, pégalo en Brew y selecciona Conectar. Brew verifica cada entrega con el encabezado de firma de WorkOS y una tolerancia de 180 segundos en la marca de tiempo.
- En WorkOS, envía un evento user.created de prueba desde el endpoint. En Brew, el estado pasa de “Esperando un evento de prueba” a “Conectado”. Brew omite los ejemplos de WorkOS que reconoce, pero puede procesar un ejemplo que no reconozca como si fuera un evento real, así que envía la prueba antes de publicar una automatización con ese disparador.
- Al conectar, Brew crea disparadores para los 18 eventos. No hay ningún interruptor para activar o desactivar eventos.
- Crea una automatización, selecciona su evento de WorkOS y envía una prueba mientras siga siendo un borrador. Cuando llega un evento que coincide, solo se ejecutan las automatizaciones activas.

## Eventos de WorkOS compatibles

Brew admite 18 tipos de evento:

- user.created
- user.updated
- user.deleted
- authentication.email_verification_succeeded
- authentication.password_failed
- password_reset.succeeded
- authentication.magic_auth_succeeded
- organization.created
- organization.updated
- organization.deleted
- organization_membership.created
- organization_membership.updated
- organization_membership.deleted
- dsync.user.created
- dsync.user.updated
- dsync.user.deleted
- connection.activated
- invitation.accepted

## Sincronización de contactos y personalización

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, workos_user_id y workos_email_verified.

Los eventos de autenticación completan workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at o workos_last_magic_auth_at. Los eventos de pertenencia y de invitación completan workos_organization_id y workos_org_role. Los eventos de directorio completan workos_directory_user_id y workos_directory_id.

Los eventos user.deleted y dsync.user.deleted establecen workos_account_status en deleted, y organization_membership.deleted lo establece en removed_from_org. Brew no elimina el contacto.

Usa el esquema de payload declarado del evento seleccionado para las etiquetas de combinación. Todos los eventos incluyen email, firstName, lastName y createdAt cuando están disponibles. Los eventos de usuario añaden emailVerified; los de organización, organizationName; y los de pertenencia y de invitación, role. El campo createdAt es una marca de tiempo Unix en segundos.

Los ID de los objetos de WorkOS no son etiquetas de combinación, y tampoco lo son la dirección IP ni el user agent de los eventos de autenticación.

Los empleados sincronizados desde un directorio normalmente no han dado su consentimiento para recibir marketing. Trátalos como destinatarios de avisos de cuenta y transaccionales, salvo que hayan dado su consentimiento por separado.


## ¿Por qué aparece un evento sin que se envíe ningún email?

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. Los eventos de organización y de conexión nunca inician automatizaciones, y un ejemplo de prueba de WorkOS que Brew reconoce se registra como evento de prueba.


## Límites y solución de problemas

- Brew no puede crear ni modificar usuarios, organizaciones, directorios ni conexiones de WorkOS.
- Un error 401 con timestamp_invalid:out_of_tolerance significa que la marca de tiempo de la entrega tenía un desfase de más de 180 segundos. Revisa el desfase del reloj y reenvía el evento desde el panel de WorkOS.
- Si las automatizaciones de restablecimiento de contraseña nunca se activan, comprueba que el endpoint esté suscrito a password_reset.succeeded. WorkOS nunca envía authentication.password_reset_succeeded.
- Si todas las entregas fallan en la comprobación de la firma, copia desde WorkOS el secreto actual del endpoint y vuelve a conectar. Brew exige que el secreto tenga al menos 16 caracteres.
- Revisa el consentimiento y la finalidad de cada email. Sincronizar los usuarios de WorkOS no autoriza a hacer envíos promocionales.

## Fuentes y guías de configuración

- [Guía de configuración de WorkOS](https://docs.brew.new/integrations/import/workos)
- [Crea una automatización](https://docs.brew.new/create-emails/build-an-automation)
- [Etiquetas de combinación](https://docs.brew.new/create-emails/merge-tags)
- [Qué puedes enviar con Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Eventos de WorkOS](https://workos.com/docs/events)

## Relacionado

- [Todas las integraciones](https://brew.new/es/browse/integrations.md)
- [Crear cuenta](https://brew.new/es/sign-up.md)
- Sitio web: https://brew.new