# WorkOS + Brew

WorkOS kullanıcı, kimlik doğrulama, şifre sıfırlama, organizasyon, Directory Sync (SCIM), bağlantı ve davet olaylarıyla Brew otomasyonlarını tetikleyin.

Kanonik URL: https://brew.new/tr/browse/integrations/workos

- Yön: Gelen veri
- Bağlantı: Webhook gizli anahtarı
- Kurumsal kimlik doğrulama tetikleyicileri

## Kullanıma açık özellikler

- **Olay tetikleyicileri**: WorkOS kullanıcı, kimlik doğrulama, organizasyon, Directory Sync ve bağlantı olaylarıyla Brew otomasyonlarını tetikleyin.

## WorkOS olaylarını işe yarar e-postalara dönüştürün

Bir kullanıcı oluşturulduğunda, e-posta adresini doğruladığında, şifresini sıfırladığında, bir organizasyona katıldığında veya Directory Sync ile hesabı açıldığında markanıza uygun e-postalar göndermeye başlamak için WorkOS’u bağlayın. Brew, 18 WorkOS olay türünü otomasyon tetikleyicisine dönüştürür.

SSO, Directory Sync, giriş ve şifre sıfırlama WorkOS’un sorumluluğunda kalır. Brew yalnızca olayları dinler; bu olayların ardından gelen e-postaları oluşturur ve gönderir.


## Neler oluşturabilirsiniz

- Hoş geldin e-postaları: user.created olayı, bir WorkOS kullanıcısı oluşturulduğunda tetiklenir. authentication.email_verification_succeeded olayı ise kullanıcı e-posta adresini doğruladığında tetiklenir. İki ayrı hoş geldin e-postası gitmemesi için yalnızca birini tetikleyici olarak seçin.
- Şifre sıfırlama onayları: password_reset.succeeded olayı, bir sıfırlama tamamlandığında tetiklenir. Bu, authentication.* grubunun parçası değil, üst düzey bir WorkOS olayıdır.
- Giriş bildirimleri: authentication.magic_auth_succeeded olayı sihirli bağlantıyla giriş tamamlandığında, authentication.password_failed olayı ise şifreyle giriş başarısız olduğunda tetiklenir. İkisi de kullanıcıya gider ve hiçbiri IP adresini veya kullanıcı aracısını (user agent) birleştirme etiketi olarak sunmaz.
- Ekip üyeleri için onboarding: organization_membership.created ve invitation.accepted olaylarının ikisi de biri katıldığında tetiklenir ve role alanını taşır. İki ayrı hoş geldin e-postası gitmemesi için yalnızca birini tetikleyici olarak seçin.
- Rol değişikliği bildirimleri: organization_membership.updated olayı, bir üyelik değiştiğinde (ör. yeni bir rol) tetiklenir.
- Directory Sync ile senkronize edilen kullanıcılar: dsync.user.created, dsync.user.updated ve dsync.user.deleted olayları Brew kişilerini SCIM dizininizle uyumlu tutar.
- Ayrılış bildirimleri: user.deleted ve organization_membership.deleted olayları, bir kullanıcı silindiğinde veya bir organizasyondan ayrıldığında tetiklenir.

## Organizasyon ve bağlantı olayları e-posta tetiklemez

organization.created, organization.updated, organization.deleted ve connection.activated olayları alıcı taşımaz. Brew bunları Son olaylar bölümüne alıcısı belirlenemeyen olaylar olarak kaydeder ve otomasyon başlatmaz.

Yeni bir organizasyonla ilgili bir kişiye e-posta göndermek için organization_membership.created veya invitation.accepted gibi o kişinin adresini taşıyan bir olay kullanın.

E-posta adresi taşımayan üyelik, kimlik doğrulama ve dizin olayları, Brew mevcut bağlantıda aynı WorkOS kullanıcısı, üyeliği veya dizin kullanıcısı için daha önce gerçek bir e-posta adresi gördüyse yine de işlenebilir.


## WorkOS’u Brew içinde kurun

- Entegrasyonlar sayfasını açın, WorkOS’u seçin ve “Webhook URL’si oluştur” düğmesine tıklayın.
- WorkOS Dashboard’da Webhooks bölümünü açın, bir uç nokta oluşturun ve Brew URL’sini yapıştırın.
- Desteklenen 18 olaya abone olun: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated ve invitation.accepted. authentication.* seçeneğini işaretlemeyin; bu seçenek Brew tarafından desteklenmeyen kimlik doğrulama olaylarını da ekler.
- Uç noktanın imzalama anahtarını kopyalayın, Brew içine yapıştırın ve Bağla düğmesine tıklayın. Brew her teslimi WorkOS imza başlığıyla ve 180 saniyelik zaman damgası toleransıyla doğrular.
- WorkOS panelinde uç noktadan test amaçlı bir user.created olayı gönderin. Brew içindeki bağlantı “Test olayı bekleniyor” durumundan “Bağlı” durumuna geçer. Brew tanıdığı WorkOS örnek olaylarını atlar; ancak tanımadığı bir örneği gerçek bir olay gibi işleyebilir. Bu yüzden testi, o tetikleyiciyi kullanan bir otomasyonu yayımlamadan önce gönderin.
- Bağlantı kurulduğunda 18 olayın tamamı için tetikleyici oluşturulur. Olayları tek tek açıp kapatmaya yarayan bir ayar yoktur.
- Bir otomasyon oluşturun, WorkOS olayını seçin ve otomasyon henüz Taslak durumundayken bir test gönderin. Eşleşen bir olay geldiğinde yalnızca durumu Yayında olan otomasyonlar çalışır.

## Desteklenen WorkOS olayları

Brew şu 18 olay türünü destekler:

- 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

## Kişi senkronizasyonu ve kişiselleştirme

Gerçek bir e-posta adresi taşıyan her doğrulanmış olay, bir otomasyon o olayı kullansın ya da kullanmasın, e-posta adresine göre eşleştirilen bir Brew kişisi oluşturur veya mevcut kişiyi günceller. İlgili veriler varsa Brew ad, soyad, workos_user_id ve workos_email_verified alanlarını doldurur.

Kimlik doğrulama olayları workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at veya workos_last_magic_auth_at alanını doldurur. Üyelik ve davet olayları workos_organization_id ve workos_org_role alanlarını doldurur. Dizin olayları ise workos_directory_user_id ve workos_directory_id alanlarını doldurur.

user.deleted ve dsync.user.deleted olayları workos_account_status alanını deleted olarak, organization_membership.deleted olayı ise removed_from_org olarak ayarlar. Brew kişiyi silmez.

Birleştirme etiketleri için seçilen olayın tanımlanan payload şemasını kullanın. Her olayda email, firstName, lastName ve createdAt alanları (varsa) bulunur. Kullanıcı olayları bunlara emailVerified alanını, organizasyon olayları organizationName alanını, üyelik ve davet olayları ise role alanını ekler. createdAt, saniye cinsinden bir Unix zaman damgasıdır.

WorkOS nesne kimlikleri birleştirme etiketi olarak kullanılamaz; kimlik doğrulama olaylarındaki IP adresi ve kullanıcı aracısı (user agent) da kullanılamaz.

Directory Sync ile senkronize edilen çalışanlar genellikle pazarlama e-postalarına izin vermemiştir. Ayrıca izin vermedikleri sürece onları yalnızca hesapla ilgili ve işlemsel bildirimlerin alıcısı olarak değerlendirin.


## Bir olay görünüyor ama neden e-posta gönderilmiyor?

Bir olayın alınması ile e-posta gönderilmesi ayrı adımlardır. Eşleşen bir otomasyonun yayında olduğunu doğrulayın, ardından filtrelerini, çalıştırma geçmişini, alıcının uygunluğunu ve gönderim alan adını kontrol edin. Organizasyon ve bağlantı olayları hiçbir zaman otomasyon başlatmaz; tanınan bir WorkOS test örneği de test olayı olarak kaydedilir.


## Sınırlar ve sorun giderme

- Brew, WorkOS kullanıcılarını, organizasyonlarını, dizinlerini veya bağlantılarını oluşturamaz ya da değiştiremez.
- timestamp_invalid:out_of_tolerance içeren bir 401 hatası, teslimin zaman damgasının 180 saniyeden fazla saptığı anlamına gelir. Saat kaymasını kontrol edin, ardından teslimi WorkOS Dashboard’dan yeniden gönderin.
- Şifre sıfırlama otomasyonları hiç tetiklenmiyorsa uç noktanın password_reset.succeeded olayına abone olduğunu doğrulayın. WorkOS hiçbir zaman authentication.password_reset_succeeded diye bir olay göndermez.
- Tüm teslimler imza kontrolünden geçemiyorsa WorkOS’taki güncel uç nokta anahtarını kopyalayın ve yeniden bağlanın. Brew, anahtarın en az 16 karakter uzunluğunda olmasını ister.
- Her e-postanın izin durumunu ve amacını gözden geçirin. WorkOS kullanıcılarını senkronize etmek, tanıtım amaçlı gönderimler için izin vermez.

## Kaynaklar ve kurulum rehberleri

- [WorkOS kurulum rehberi](https://docs.brew.new/integrations/import/workos)
- [Otomasyon oluşturun](https://docs.brew.new/create-emails/build-an-automation)
- [Birleştirme etiketleri](https://docs.brew.new/create-emails/merge-tags)
- [Brew ile neler gönderebilirsiniz](https://docs.brew.new/get-started/what-you-can-send)
- [WorkOS olayları](https://workos.com/docs/events)

## İlgili sayfalar

- [Tüm entegrasyonlar](https://brew.new/tr/browse/integrations.md)
- [Kaydol](https://brew.new/tr/sign-up.md)
- Web sitesi: https://brew.new