Kết nối WorkOS để bắt đầu gửi email chuẩn thương hiệu khi một người dùng được tạo, xác minh email, đặt lại mật khẩu, gia nhập tổ chức hoặc được cấp tài khoản qua đồng bộ thư mục. Brew biến 18 loại sự kiện WorkOS thành trình kích hoạt tự động hóa.
WorkOS vẫn chịu trách nhiệm về SSO, đồng bộ thư mục, đăng nhập và đặt lại mật khẩu. Brew chỉ lắng nghe sự kiện, rồi tạo và gửi các email theo sau những sự kiện đó.
Các sự kiện organization.created, organization.updated, organization.deleted và connection.activated không mang theo người nhận. Brew ghi các sự kiện này vào mục Sự kiện gần đây với trạng thái chưa xác định được người nhận và không khởi chạy tự động hóa nào.
Để gửi email cho một người về tổ chức mới, hãy dùng một sự kiện có mang theo địa chỉ của họ, chẳng hạn organization_membership.created hoặc invitation.accepted.
Sự kiện về thành viên, xác thực và thư mục không có địa chỉ email vẫn có thể được xử lý tiếp nếu Brew đã ghi nhận email thật cho cùng người dùng WorkOS, cùng bản ghi thành viên hoặc cùng người dùng thư mục trên kết nối hiện tại.
Brew hỗ trợ 18 loại sự kiện sau:
Mỗi sự kiện đã xác minh có địa chỉ email thật đều tạo hoặc cập nhật một liên hệ trong Brew (khớp theo email), bất kể có tự động hóa nào dùng sự kiện đó hay không. Khi có dữ liệu, Brew điền tên, họ, workos_user_id và workos_email_verified.
Sự kiện xác thực điền workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at hoặc workos_last_magic_auth_at. Sự kiện thành viên và lời mời điền workos_organization_id và workos_org_role. Sự kiện thư mục điền workos_directory_user_id và workos_directory_id.
Các sự kiện user.deleted và dsync.user.deleted đặt workos_account_status thành deleted, còn organization_membership.deleted đặt trường này thành removed_from_org. Brew không xóa liên hệ.
Dùng lược đồ payload đã khai báo của sự kiện được chọn cho thẻ cá nhân hóa. Mọi sự kiện đều có email, firstName, lastName và createdAt khi có dữ liệu. Sự kiện người dùng có thêm emailVerified, sự kiện tổ chức có thêm organizationName, còn sự kiện thành viên và lời mời có thêm role. Trường createdAt là dấu thời gian Unix tính bằng giây.
ID đối tượng của WorkOS không phải là thẻ cá nhân hóa, và địa chỉ IP cùng user agent trong sự kiện xác thực cũng vậy.
Nhân viên được đồng bộ từ thư mục thường chưa đồng ý nhận email tiếp thị. Hãy xem họ là người nhận thông báo tài khoản và thông báo giao dịch, trừ khi họ đã đồng ý riêng.
Nhận sự kiện và gửi email là hai bước riêng biệt. Hãy xác nhận có một tự động hóa khớp đang ở trạng thái Đang hoạt động, rồi kiểm tra bộ lọc và lịch sử thực thi của tự động hóa đó, điều kiện của người nhận và tên miền gửi. Sự kiện tổ chức và kết nối không bao giờ khởi chạy tự động hóa, và sự kiện mẫu của WorkOS mà Brew nhận ra sẽ được ghi nhận là sự kiện thử nghiệm.
