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.
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.
Brew şu 13 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 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.
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ı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.
