Kết nối Clerk để bắt đầu gửi email chuẩn thương hiệu khi có người đăng ký, gia nhập một tổ chức, bắt đầu gói đăng ký Clerk Billing hoặc vào danh sách chờ của bạn. Clerk ký từng webhook, và Brew biến 13 loại sự kiện thành trình kích hoạt tự động hóa.
Clerk vẫn chịu trách nhiệm về đăng nhập, tổ chức và thanh toán. Brew chỉ lắng nghe sự kiện. Brew không thể thay đổi người dùng, tạo tổ chức hay thu phí gói đăng ký.
Sự kiện organization.created không mang theo địa chỉ email. Brew tra cứu ID người dùng của người tạo trong số các danh tính mà Brew đã ghi nhận ở những sự kiện Clerk trước đó trên kết nối hiện tại. Nếu tìm thấy email thật, sự kiện sẽ được xử lý tiếp. Nếu không, Brew ghi nhận sự kiện là chưa xác định được người nhận, không tạo liên hệ và không khởi chạy tự động hóa nào.
Hãy đăng ký nhận cả sự kiện user.created để Brew biết được địa chỉ của người tạo. Nếu email cần lần nào cũng đến được người nhận, hãy dùng organizationMembership.created, sự kiện có mang theo địa chỉ của thành viên.
Brew hỗ trợ 13 loại sự kiện sau:
Mỗi sự kiện đã xác minh có địa chỉ email thật đều tạo hoặc cập nhật một liên hệ trong Brew (khớp theo email), bất kể có tự động hóa nào dùng sự kiện đó hay không. Khi có dữ liệu, Brew điền tên, họ và clerk_user_id.
Sự kiện user.created còn điền thêm clerk_username, clerk_image_url, clerk_signed_up_at và clerk_last_sign_in_at. Sự kiện lời mời và thành viên điền clerk_organization_id, clerk_org_role và clerk_org_role_name. Sự kiện lời mời có thêm clerk_org_invitation_status, còn sự kiện thành viên có thêm clerk_organization_name và clerk_organization_slug.
Sự kiện thanh toán điền clerk_subscription_status và clerk_plan_name, một số sự kiện còn có thêm clerk_plan_slug, clerk_subscription_period_end hoặc clerk_is_trialing. Sự kiện paymentAttempt.created điền clerk_last_payment_attempt_status và clerk_last_payment_attempt_at. Sự kiện waitlistEntry.created điền clerk_waitlist_status.
Dùng lược đồ payload đã khai báo của sự kiện được chọn cho thẻ cá nhân hóa. Mọi sự kiện đều có email, firstName, lastName và createdAt. Các trường khác tùy theo sự kiện, chẳng hạn planName, planAmount, roleName, organizationName và grandTotalFormatted. Giá trị planAmount và grandTotalAmount được tính theo đơn vị tiền tệ nhỏ nhất, nên với USD, 2000 tương ứng với 20,00 US$. Dấu thời gian ở dạng Unix, tính bằng giây.
ID đối tượng của Clerk, như ID người dùng, tổ chức và gói đăng ký, không phải là thẻ cá nhân hóa. ID người dùng được lưu trên liên hệ dưới dạng clerk_user_id.
Tài khoản Clerk không đồng nghĩa với việc người dùng đã đồng ý nhận email tiếp thị. Hãy ghi nhận sự đồng ý khi người dùng đăng ký và kiểm tra trước khi gửi email quảng cáo.
Không phải lúc nào cũng được. Brew chỉ nhận sự kiện paymentAttempt.created, chứ không nhận các cập nhật sau đó của lần thử thanh toán này. Trường status có thể là pending, paid hoặc failed, nhưng nếu khoản thanh toán thất bại sau khi lần thử thanh toán đã được tạo, thông tin đó sẽ đến Brew dưới dạng một sự kiện không được hỗ trợ. Với các khoản thanh toán bị lỡ, hãy dùng subscriptionItem.pastDue. Nếu cần hiển thị tổng tiền trong nội dung email, grandTotalFormatted chứa giá trị đã được định dạng sẵn, chẳng hạn $22.00.
Nhận sự kiện và gửi email là hai bước riêng biệt. Hãy xác nhận có một tự động hóa khớp đang ở trạng thái Đang hoạt động, rồi kiểm tra bộ lọc và lịch sử thực thi của tự động hóa đó, điều kiện của người nhận và tên miền gửi. Lần gửi từ Send Example chỉ xác minh webhook chứ không bao giờ khởi chạy tự động hóa, và sự kiện organization.created không rõ người tạo sẽ được ghi nhận là chưa xác định được người nhận.
