Kurumsal kimlik doğrulama tetikleyicileri
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.
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.
Brew şu 18 olay türünü destekler:
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ı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.