Hubungkan WorkOS untuk memulai email bermerek saat pengguna dibuat, memverifikasi emailnya, mereset kata sandi, bergabung dengan organisasi, atau ditambahkan lewat sinkronisasi direktori. Brew mengubah 18 jenis peristiwa WorkOS menjadi pemicu otomatisasi.
WorkOS tetap bertanggung jawab atas SSO, sinkronisasi direktori, proses masuk, dan reset kata sandi. Brew hanya menerima peristiwa, serta membuat dan mengirim email yang menindaklanjutinya.
organization.created, organization.updated, organization.deleted, dan connection.activated tidak membawa penerima. Brew mencatatnya di Peristiwa terbaru sebagai peristiwa tanpa penerima dan tidak memulai otomatisasi.
Untuk mengirim email kepada seseorang tentang organisasi baru, gunakan peristiwa yang membawa alamat email orang tersebut, seperti organization_membership.created atau invitation.accepted.
Peristiwa keanggotaan, autentikasi, dan direktori tanpa alamat email tetap dapat diproses jika Brew sudah pernah melihat email sungguhan untuk pengguna, keanggotaan, atau pengguna direktori WorkOS yang sama pada koneksi saat ini.
Brew mendukung 18 jenis peristiwa berikut:
Setiap peristiwa terverifikasi yang memiliki alamat email sungguhan akan membuat atau memperbarui kontak Brew, yang dicocokkan berdasarkan email, baik peristiwa itu dipakai otomatisasi maupun tidak. Jika datanya tersedia, Brew mengisi nama depan, nama belakang, workos_user_id, dan workos_email_verified.
Peristiwa autentikasi mengisi workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at, atau workos_last_magic_auth_at. Peristiwa keanggotaan dan undangan mengisi workos_organization_id dan workos_org_role. Peristiwa direktori mengisi workos_directory_user_id dan workos_directory_id.
user.deleted dan dsync.user.deleted mengisi workos_account_status dengan deleted, sedangkan organization_membership.deleted mengisinya dengan removed_from_org. Brew tidak menghapus kontak tersebut.
Gunakan skema payload yang dideklarasikan untuk peristiwa terpilih sebagai acuan merge tag. Setiap peristiwa menyertakan email, firstName, lastName, dan createdAt jika tersedia. Peristiwa pengguna menambahkan emailVerified, peristiwa organisasi menambahkan organizationName, serta peristiwa keanggotaan dan undangan menambahkan role. Field createdAt berisi stempel waktu Unix dalam detik.
ID objek WorkOS tidak tersedia sebagai merge tag, begitu pula alamat IP dan user agent pada peristiwa autentikasi.
Karyawan hasil sinkronisasi direktori biasanya belum memberikan persetujuan (opt-in) untuk email pemasaran. Perlakukan mereka sebagai penerima pemberitahuan akun dan transaksional, kecuali mereka memberikan persetujuan secara terpisah.
Menerima peristiwa dan mengirim email adalah dua langkah terpisah. Pastikan otomatisasi yang cocok berstatus Aktif, lalu periksa filter dan riwayat eksekusinya, kelayakan penerima, serta domain pengirim. Peristiwa organisasi dan koneksi tidak pernah memulai otomatisasi, dan contoh peristiwa uji WorkOS yang dikenali dicatat sebagai peristiwa uji.