# WorkOS + Brew

Picu otomatisasi Brew dari peristiwa WorkOS untuk pengguna, autentikasi, reset kata sandi, organisasi, sinkronisasi direktori (SCIM), koneksi, dan undangan.

URL kanonis: https://brew.new/id/browse/integrations/workos

- Arah: Data masuk
- Koneksi: Kunci rahasia webhook
- Pemicu autentikasi enterprise

## Kemampuan yang aktif

- **Pemicu peristiwa**: Picu otomatisasi Brew dari peristiwa WorkOS untuk pengguna, autentikasi, organisasi, sinkronisasi direktori, dan koneksi.

## Ubah peristiwa WorkOS menjadi email yang bermanfaat

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.


## Yang bisa Anda buat

- Email sambutan: user.created dipicu saat pengguna WorkOS dibuat. authentication.email_verification_succeeded dipicu saat pengguna memverifikasi emailnya. Pilih salah satu pemicu agar email sambutan tidak terkirim dua kali.
- Konfirmasi reset kata sandi: password_reset.succeeded dipicu saat reset selesai. Ini adalah peristiwa WorkOS tingkat atas, bukan bagian dari authentication.*.
- Pemberitahuan masuk akun: authentication.magic_auth_succeeded dipicu saat proses masuk lewat magic link berhasil, dan authentication.password_failed dipicu saat proses masuk dengan kata sandi gagal. Keduanya dikirim ke pengguna, dan keduanya tidak menyediakan alamat IP atau user agent sebagai merge tag.
- Onboarding tim: organization_membership.created dan invitation.accepted sama-sama dipicu saat seseorang bergabung, dan keduanya membawa role. Pilih salah satu pemicu agar email sambutan tidak terkirim dua kali.
- Pemberitahuan perubahan peran: organization_membership.updated dipicu saat keanggotaan berubah, misalnya karena peran baru.
- Pengguna hasil sinkronisasi direktori: dsync.user.created, dsync.user.updated, dan dsync.user.deleted menjaga kontak Brew tetap selaras dengan direktori SCIM Anda.
- Pemberitahuan offboarding: user.deleted dan organization_membership.deleted dipicu saat pengguna dihapus atau keluar dari organisasi.

## Peristiwa organisasi dan koneksi tidak memulai email

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.


## Siapkan WorkOS di Brew

- Buka Integrasi, pilih WorkOS, lalu pilih Buat URL webhook.
- Di WorkOS Dashboard, buka Webhooks, buat endpoint, lalu tempelkan URL Brew.
- Atur endpoint agar berlangganan 18 peristiwa yang didukung: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated, dan invitation.accepted. Jangan pilih authentication.*, karena opsi itu menambahkan peristiwa autentikasi yang tidak didukung Brew.
- Salin kunci rahasia endpoint, tempelkan ke Brew, lalu pilih Hubungkan. Brew memverifikasi setiap pengiriman webhook dengan header tanda tangan WorkOS dan toleransi stempel waktu 180 detik.
- Di WorkOS, kirim peristiwa uji user.created dari endpoint tersebut. Status di Brew berubah dari “Menunggu peristiwa uji” menjadi “Terhubung”. Brew melewati contoh peristiwa WorkOS yang dikenalinya, tetapi bisa memproses contoh yang tidak dikenali seperti peristiwa sungguhan, jadi kirim peristiwa uji itu sebelum Anda memublikasikan otomatisasi pada pemicu tersebut.
- Saat Anda memilih Hubungkan, Brew membuat 18 pemicu, satu untuk setiap peristiwa. Tidak ada tombol untuk mengaktifkan atau menonaktifkan peristiwa.
- Buat otomatisasi, pilih peristiwa WorkOS yang memicunya, lalu jalankan uji selagi otomatisasi masih berstatus Draf. Hanya otomatisasi berstatus Aktif yang dijalankan saat peristiwa yang cocok masuk.

## Peristiwa WorkOS yang didukung

Brew mendukung 18 jenis peristiwa berikut:

- 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

## Sinkronisasi kontak dan personalisasi

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.


## Mengapa peristiwa muncul tetapi email tidak terkirim?

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.


## Batasan dan pemecahan masalah

- Brew tidak dapat membuat atau mengubah pengguna, organisasi, direktori, atau koneksi WorkOS.
- Respons 401 dengan timestamp_invalid:out_of_tolerance berarti stempel waktu pengiriman meleset lebih dari 180 detik. Periksa selisih waktu jam server (clock skew), lalu kirim ulang dari WorkOS Dashboard.
- Jika otomatisasi reset kata sandi tidak pernah terpicu, pastikan endpoint berlangganan password_reset.succeeded. WorkOS tidak pernah mengirim authentication.password_reset_succeeded.
- Jika setiap pengiriman webhook gagal dalam pemeriksaan tanda tangan, salin kunci rahasia endpoint terbaru dari WorkOS, lalu hubungkan ulang. Brew mensyaratkan kunci rahasia minimal 16 karakter.
- Tinjau persetujuan dan tujuan setiap email. Menyinkronkan pengguna WorkOS tidak memberi izin untuk pengiriman promosi.

## Sumber dan panduan penyiapan

- [Panduan penyiapan WorkOS](https://docs.brew.new/integrations/import/workos)
- [Membuat otomatisasi](https://docs.brew.new/create-emails/build-an-automation)
- [Merge tag](https://docs.brew.new/create-emails/merge-tags)
- [Yang bisa Anda kirim dengan Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Peristiwa WorkOS](https://workos.com/docs/events)

## Terkait

- [Semua integrasi](https://brew.new/id/browse/integrations.md)
- [Daftar](https://brew.new/id/sign-up.md)
- Situs web: https://brew.new