WorkOS를 연결하면 사용자가 생성되거나, 이메일을 인증하거나, 비밀번호를 재설정하거나, 조직에 참여하거나, 디렉터리 동기화로 프로비저닝될 때 브랜드에 맞는 이메일을 보낼 수 있어요. Brew는 WorkOS 이벤트 유형 18개를 자동화 트리거로 바꿔요.
SSO, 디렉터리 동기화, 로그인, 비밀번호 재설정은 계속 WorkOS가 담당해요. Brew는 이벤트를 수신하고, 그 뒤에 이어지는 이메일을 만들어 보내기만 해요.
organization.created, organization.updated, organization.deleted, connection.activated 이벤트에는 수신자가 없어요. Brew는 이 이벤트들을 ‘최근 이벤트’에 수신자를 찾지 못한 것으로 기록하고 자동화를 시작하지 않아요.
새 조직에 관해 사람에게 이메일을 보내려면 organization_membership.created나 invitation.accepted처럼 그 사람의 주소가 담긴 이벤트를 사용하세요.
이메일 주소가 없는 멤버십, 인증, 디렉터리 이벤트라도, Brew가 현재 연결에서 같은 WorkOS 사용자, 멤버십, 디렉터리 사용자의 실제 이메일을 이미 확인했다면 처리될 수 있어요.
Brew는 다음 이벤트 유형 18개를 지원해요:
실제 이메일 주소가 담긴 검증된 이벤트는 자동화에서 쓰이는지와 관계없이, 이메일 주소를 기준으로 Brew 연락처를 만들거나 업데이트해요. 데이터가 있으면 Brew가 이름과 성, workos_user_id, workos_email_verified를 설정해요.
인증 이벤트는 종류에 따라 workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at, workos_last_magic_auth_at 중 하나를 설정해요. 멤버십 이벤트와 초대 이벤트는 workos_organization_id와 workos_org_role을 설정해요. 디렉터리 이벤트는 workos_directory_user_id와 workos_directory_id를 설정해요.
user.deleted와 dsync.user.deleted 이벤트는 workos_account_status를 deleted로, organization_membership.deleted 이벤트는 removed_from_org로 설정해요. Brew는 연락처를 삭제하지 않아요.
개인화 태그에는 선택한 이벤트에 선언된 페이로드 스키마를 사용하세요. 모든 이벤트에는 값이 있는 경우 email, firstName, lastName, createdAt이 포함돼요. 사용자 이벤트에는 emailVerified가, 조직 이벤트에는 organizationName이, 멤버십 이벤트와 초대 이벤트에는 role이 추가돼요. createdAt은 초 단위 Unix 타임스탬프예요.
WorkOS 객체 ID는 개인화 태그로 쓸 수 없고, 인증 이벤트에 담긴 IP 주소와 사용자 에이전트도 마찬가지예요.
디렉터리 동기화로 들어온 직원은 대개 마케팅 수신에 동의하지 않은 상태예요. 따로 동의하지 않았다면 계정 안내와 트랜잭션 안내만 받는 수신자로 다루세요.
이벤트 수신과 이메일 발송은 별개의 단계예요. 일치하는 자동화가 활성 상태인지 확인한 다음, 필터와 실행 기록, 수신자가 발송 대상인지, 발신 도메인을 확인하세요. 조직 이벤트와 연결 이벤트는 자동화를 시작하지 않으며, Brew가 알아본 WorkOS 테스트 샘플은 테스트 이벤트로 기록돼요.
