# Clerk + Brew

Brew otomasyonlarını Clerk webhook olaylarıyla tetikleyin: kullanıcı kayıtları, organizasyon değişiklikleri, ücretli abonelikler ve bekleme listesi kayıtları.

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

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

## Kullanıma açık özellikler

- **Olay tetikleyicileri**: Kullanıcı, organizasyon, faturalandırma ve bekleme listesi kategorilerindeki 13 Clerk webhook olayıyla Brew otomasyonlarını tetikleyin.

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

Biri kaydolduğunda, bir organizasyona katıldığında, bir Clerk Billing aboneliği başlattığında veya bekleme listenize katıldığında markanıza uygun e-postalar göndermeye başlamak için Clerk’ü bağlayın. Clerk her webhooku imzalar; Brew de 13 olay türünü otomasyon tetikleyicisine dönüştürür.

Giriş, organizasyonlar ve faturalandırma Clerk’ün sorumluluğunda kalır. Brew yalnızca olayları dinler. Kullanıcıları değiştiremez, organizasyon oluşturamaz veya aboneliklerden ücret tahsil edemez.


## Neler oluşturabilirsiniz

- Hoş geldin e-postaları: user.created olayı, yeni bir kullanıcı kaydolduğunda tetiklenir. Adın yanı sıra username, imageUrl ve lastSignInAt alanları da kullanılabilir.
- Ekip üyeleri için onboarding: organizationMembership.created olayı, yeni üye ister bir daveti kabul etmiş ister doğrudan eklenmiş olsun, bu üyeye ait organizationName, organizationSlug ve roleName alanlarını taşır. Kabul edilen bir davette organizationInvitation.accepted olayı da tetiklenir; bu yüzden iki ayrı hoş geldin e-postası gitmemesi için yalnızca birini tetikleyici olarak seçin.
- Davet takip e-postaları: organizationInvitation.created, organizationInvitation.accepted ve organizationInvitation.revoked olayları davet edilen adrese gider ve roleName, status ile expiresAt alanlarını taşır. Organizasyon adını, daveti göndereni veya bir kabul bağlantısını taşımazlar.
- Abonelere hoş geldin e-postaları: subscription.created olayı planName, planSlug, planAmount, currency, periodStart ve periodEnd alanlarını taşır.
- Deneme süresi hatırlatmaları: subscriptionItem.freeTrialEnding olayı, bir Clerk Billing ücretsiz deneme süresi ücretli aboneliğe dönüşmeden kısa süre önce tetiklenir ve planName, planAmount, currency ile periodEnd alanlarını taşır.
- Gecikmiş ödeme bildirimleri: subscriptionItem.pastDue olayı, bir abonelik kaleminin ödemesi yapılamadığında tetiklenir. Kendi faturalandırma sayfanıza bağlantı verin.
- İptal ve terk edilmiş deneme süresi sonrası takip e-postaları: subscriptionItem.canceled olayı, bir kalem iptal edildiğinde tetiklenir. subscriptionItem.abandoned ise genellikle kayıtlı bir ödeme yöntemi olmadan sona eren bir deneme süresi anlamına gelir.
- Bekleme listesi onayları: waitlistEntry.created olayı, bir e-posta adresi Clerk bekleme listenize katıldığında tetiklenir.

## Organizasyon olayları için oluşturanın bilinmesi gerekir

organization.created olayı e-posta adresi taşımaz. Brew, oluşturan kişinin kullanıcı kimliğini, mevcut bağlantıda daha önce gelen Clerk olaylarında gördüğü kimlikler arasında arar. Gerçek bir e-posta adresi bulursa olay işlenmeye devam eder. Bulamazsa Brew olayı alıcısı belirlenemeyen bir olay olarak kaydeder, kişi oluşturmaz ve otomasyon başlatmaz.

Oluşturan kişilerin adreslerinin Brew tarafından öğrenilebilmesi için user.created olayına da abone olun. Her seferinde bir kişiye ulaşması gereken bir e-posta için üyenin adresini taşıyan organizationMembership.created olayını kullanın.


## Clerk’ü Brew içinde kurun

- Entegrasyonlar sayfasını açın, Clerk’ü seçin ve “Webhook URL’si oluştur” düğmesine tıklayın.
- Clerk Dashboard’da Webhooks bölümünü açın ve Brew URL’siyle bir uç nokta ekleyin.
- Uç noktayı user, organization, organizationInvitation, organizationMembership, paymentAttempt, subscription, subscriptionItem ve waitlistEntry gruplarındaki desteklenen 13 olaya abone edin, ardından uç noktayı oluşturun.
- Uç noktanın whsec_ ile başlayan imzalama anahtarını görüntüleyin, Brew içine yapıştırın ve Bağla düğmesine tıklayın. Brew her teslimi Standard Webhooks (Svix) spesifikasyonuna göre doğrular.
- Clerk panelinde uç noktanın Testing sekmesini açın, user.created olayını seçin ve Send Example düğmesine tıklayın. Brew içindeki bağlantı “Test olayı bekleniyor” durumundan “Bağlı” durumuna geçer. Örnek olay yalnızca webhooku doğrular. Brew kişi eklemez ve otomasyon başlatmaz.
- Bağlantı kurulduğunda 13 olayın tamamı için tetikleyici oluşturulur. Olayları tek tek açıp kapatmaya yarayan bir ayar yoktur.
- Bir otomasyon oluşturun, Clerk 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 Clerk olayları

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

- user.created
- organization.created
- organizationInvitation.created
- organizationInvitation.accepted
- organizationInvitation.revoked
- organizationMembership.created
- paymentAttempt.created
- subscription.created
- subscriptionItem.freeTrialEnding
- subscriptionItem.pastDue
- subscriptionItem.canceled
- subscriptionItem.abandoned
- waitlistEntry.created

## 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 ve clerk_user_id alanlarını doldurur.

user.created olayı ayrıca clerk_username, clerk_image_url, clerk_signed_up_at ve clerk_last_sign_in_at alanlarını doldurur. Davet ve üyelik olayları clerk_organization_id, clerk_org_role ve clerk_org_role_name alanlarını doldurur. Davetler bunlara clerk_org_invitation_status alanını, üyelikler ise clerk_organization_name ve clerk_organization_slug alanlarını ekler.

Faturalandırma olayları clerk_subscription_status ve clerk_plan_name alanlarını doldurur; bazıları clerk_plan_slug, clerk_subscription_period_end veya clerk_is_trialing alanını da ekler. paymentAttempt.created olayı clerk_last_payment_attempt_status ve clerk_last_payment_attempt_at alanlarını, waitlistEntry.created olayı ise clerk_waitlist_status alanını doldurur.

Birleştirme etiketleri için seçilen olayın tanımlanan payload şemasını kullanın. Her olay email, firstName, lastName ve createdAt alanlarını içerir. planName, planAmount, roleName, organizationName ve grandTotalFormatted gibi diğer alanlar olaya göre değişir. planAmount ve grandTotalAmount değerleri para biriminin en küçük birimi cinsindendir; yani USD için 2000, $20,00 demektir. Zaman damgaları Unix saniyesi cinsindendir.

Kullanıcı, organizasyon ve abonelik kimlikleri gibi Clerk nesne kimlikleri birleştirme etiketi olarak kullanılamaz. Kullanıcı kimliği, kişi kaydına clerk_user_id olarak yazılır.

Bir Clerk hesabı, pazarlama e-postası için izin anlamına gelmez. İzni kaydolma sırasında kayıt altına alın ve tanıtım amaçlı gönderimlerden önce kontrol edin.


## paymentAttempt.created ile başarısız ödeme e-postası gönderilebilir mi?

Güvenilir biçimde değil. Brew yalnızca paymentAttempt.created olayını alır; ödeme denemesine ait sonraki güncellemeleri almaz. Bu olayın status alanı pending, paid veya failed olabilir; ancak deneme oluşturulduktan sonra başarısız olan bir ödemeyi Brew desteklenmeyen bir olay olarak alır. Yapılmayan ödemeler için subscriptionItem.pastDue olayını kullanın. E-posta metninde toplam tutarı göstermek isterseniz grandTotalFormatted alanı, $22.00 gibi önceden biçimlendirilmiş bir değer taşır.


## 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. Send Example ile yapılan bir teslim webhooku doğrular ama hiçbir zaman otomasyon başlatmaz; oluşturanı bilinmeyen bir organization.created olayı da alıcısı belirlenemeyen olay olarak kaydedilir.


## Sınırlar ve sorun giderme

- Brew, Clerk kullanıcılarını, organizasyonlarını veya aboneliklerini oluşturamaz ya da değiştiremez.
- Yalnızca listelenen 13 olay otomasyon başlatır. Kullanıcı güncellemeleri ve silmeleri gibi diğer Clerk olayları desteklenmeyen olay olarak kaydedilir.
- Clerk her teslimde 401 bildiriyorsa Brew içindeki imzalama anahtarı, Clerk’teki uç nokta anahtarıyla eşleşmiyordur. Clerk’te güncel anahtarı görüntüleyin ve bu anahtarla yeniden bağlanın.
- Brew, imzalama anahtarının whsec_ ile başlamasını ve en az 24 karakter uzunluğunda olmasını ister.
- Her e-postanın izin durumunu ve amacını gözden geçirin. Clerk kullanıcılarını senkronize etmek, tanıtım amaçlı gönderimler için izin vermez.

## Kaynaklar ve kurulum rehberleri

- [Clerk kurulum rehberi](https://docs.brew.new/integrations/import/clerk)
- [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)
- [Clerk webhooklarına genel bakış](https://clerk.com/docs/guides/development/webhooks/overview)

## İ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