# Stytch + Brew

Kích hoạt tự động hóa trong Brew từ các sự kiện trực tiếp về người dùng Stytch Consumer và thành viên B2B. Sự kiện tạo tổ chức không có người nhận; sự kiện Dashboard và SCIM không khởi chạy tự động hóa.

URL chính tắc: https://brew.new/vi/browse/integrations/stytch

- Chiều dữ liệu: Dữ liệu vào
- Kết nối: Webhook secret
- Trình kích hoạt sự kiện xác thực

## Tính năng đang hoạt động

- **Trình kích hoạt sự kiện**: Kích hoạt tự động hóa trong Brew từ các sự kiện trực tiếp về người dùng Stytch Consumer và thành viên B2B có người nhận xác định. Sự kiện tạo tổ chức, sự kiện Dashboard và sự kiện SCIM không khởi chạy tự động hóa.

## Biến sự kiện Stytch thành email hữu ích

Kết nối Stytch để bắt đầu gửi email chuẩn thương hiệu khi một người dùng Consumer đăng ký hoặc một thành viên gia nhập tổ chức B2B. Brew hỗ trợ 7 loại sự kiện Stytch thuộc hai sản phẩm Consumer và B2B.

Stytch vẫn chịu trách nhiệm về xác thực. Brew chỉ lắng nghe sự kiện, rồi tạo và gửi các email theo sau những sự kiện đó.


## Bạn có thể xây dựng gì

- Email chào mừng cho Consumer: sự kiện direct.user.create xảy ra khi một người dùng Stytch Consumer được tạo.
- Hướng dẫn thành viên mới cho tổ chức B2B: sự kiện direct.member.create xảy ra khi một thành viên gia nhập tổ chức và mang theo role.
- Thông báo thay đổi vai trò: sự kiện direct.member.update xảy ra khi hồ sơ thành viên thay đổi, chẳng hạn khi có vai trò hoặc tên mới.
- Thông báo khi rời đi: các sự kiện direct.user.delete và direct.member.delete xảy ra khi một người dùng hoặc thành viên bị xóa. Các sự kiện này chỉ được xử lý tiếp khi Brew đã ghi nhận người dùng hoặc thành viên đó với một email thật.
- Đồng bộ hồ sơ: sự kiện direct.user.update giúp liên hệ trong Brew luôn được cập nhật khi người dùng Consumer thay đổi.

## Chỉ sự kiện direct mới khởi chạy tự động hóa

Stytch gắn nhãn nguồn (source) cho từng sự kiện. Brew xử lý các sự kiện từ nguồn direct, tức là các sự kiện phát sinh từ lệnh gọi API và SDK của bạn. Sự kiện Dashboard và SCIM được ghi nhận là không được hỗ trợ và không bao giờ khởi chạy tự động hóa, nên thay đổi do người vận hành thực hiện trong Stytch Dashboard sẽ không gửi email cho khách hàng.

Sự kiện direct.organization.create không mang theo người nhận. Brew ghi nhận sự kiện này là chưa xác định được người nhận và không khởi chạy tự động hóa nào. Để gửi email cho một người, hãy dùng direct.member.create, sự kiện có mang theo địa chỉ của thành viên.

Sự kiện xóa chỉ mang theo ID. Brew tra cứu email đã ghi nhận trước đó cho người dùng hoặc thành viên này trên kết nối hiện tại. Nếu không có, sự kiện được ghi nhận là chưa xác định được người nhận.


## Thiết lập Stytch trong Brew

- Mở mục Tích hợp, chọn Stytch rồi chọn Tạo URL webhook.
- Chọn loại dự án khớp với dự án Stytch của bạn: Consumer (B2C) hoặc B2B.
- Trong Stytch Dashboard, mở Webhooks và thêm một endpoint dùng URL Brew.
- Với dự án Consumer, bật direct.user.create, direct.user.update và direct.user.delete. Với dự án B2B, bật direct.organization.create, direct.member.create, direct.member.update và direct.member.delete.
- Hiện signing secret của endpoint (bắt đầu bằng whsec_), dán vào Brew rồi chọn Kết nối. Brew xác minh mọi lần gửi theo đặc tả Standard Webhooks (Svix).
- Trong Stytch, mở thẻ Testing của endpoint, chọn direct.user.create hoặc direct.member.create rồi chọn Send Example. Trạng thái trong Brew chuyển từ “Đang chờ sự kiện thử nghiệm” sang “Đã kết nối”. Sự kiện mẫu chỉ dùng để xác minh webhook. Brew không thêm liên hệ và không khởi chạy tự động hóa nào.
- Khi bạn chọn Kết nối, Brew tạo trình kích hoạt cho cả 7 sự kiện. Không có công tắc bật/tắt cho từng sự kiện.
- Tạo một tự động hóa, chọn sự kiện Stytch cho tự động hóa đó rồi gửi thử khi tự động hóa vẫn ở trạng thái Bản nháp. Chỉ những tự động hóa ở trạng thái Đang hoạt động mới chạy khi có sự kiện khớp được gửi đến.

## Các sự kiện Stytch được hỗ trợ

Các sự kiện direct.user.create, direct.user.update và direct.user.delete đến từ dự án Consumer. Các sự kiện về tổ chức và thành viên đến từ dự án B2B.

Brew hỗ trợ 7 loại sự kiện sau:

- direct.user.create
- direct.user.update
- direct.user.delete
- direct.organization.create
- direct.member.create
- direct.member.update
- direct.member.delete

## Đồng bộ liên hệ và cá nhân hóa

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à stytch_project.

Sự kiện Consumer điền stytch_user_id. Sự kiện thành viên điền stytch_member_id, stytch_organization_id và stytch_org_role. Sự kiện xóa đặt stytch_account_status thành deleted. Brew không xóa liên hệ.

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 khi có dữ liệu. Sự kiện thành viên có thêm role, còn direct.organization.create có thêm organizationName và organizationSlug. Trường createdAt là dấu thời gian Unix tính bằng giây.

ID người dùng, thành viên và tổ chức của Stytch không phải là thẻ cá nhân hóa. Thay vào đó, các ID này được lưu trên liên hệ dưới dạng các trường stytch_*.

Tài khoản Stytch 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.


## Brew có thay thế tin nhắn xác thực của Stytch không?

Không. Tin nhắn xác thực của chính Stytch vẫn giữ nguyên. Brew khởi chạy tự động hóa từ các sự kiện webhook được liệt kê ở đây, sau khi Stytch đã tạo, cập nhật hoặc xóa người dùng hay thành viên.


## Vì sao sự kiện đã xuất hiện nhưng không có email nào được gửi?

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, sự kiện từ Dashboard và SCIM, cũng như sự kiện không có người nhận xác định đều không bao giờ khởi chạy tự động hóa.


## Giới hạn và khắc phục sự cố

- Brew không thể tạo hay thay đổi người dùng, thành viên hoặc tổ chức trên Stytch.
- Nếu Stytch báo lỗi 401 ở mọi lần gửi, signing secret trong Brew không khớp với secret của endpoint. Hãy hiện secret đang dùng và kết nối lại. Brew yêu cầu secret này phải bắt đầu bằng whsec_ và dài ít nhất 24 ký tự.
- Xem lại sự đồng ý và mục đích của từng email. Việc đồng bộ người dùng Stytch không có nghĩa là bạn được phép gửi email quảng cáo.

## Nguồn và hướng dẫn thiết lập

- [Hướng dẫn thiết lập Stytch](https://docs.brew.new/integrations/import/stytch)
- [Tạo một tự động hóa](https://docs.brew.new/create-emails/build-an-automation)
- [Thẻ cá nhân hóa](https://docs.brew.new/create-emails/merge-tags)
- [Những gì bạn có thể gửi bằng Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Webhook của Stytch](https://stytch.com/docs/resources/workspace-management/webhooks)

## Liên quan

- [Tất cả tích hợp](https://brew.new/vi/browse/integrations.md)
- [Đăng ký](https://brew.new/vi/sign-up.md)
- Website: https://brew.new