# Stytch + Brew

Stytch から直接届く Consumer のユーザーイベントと B2B のメンバーイベントで、Brew のオートメーションを起動できます。組織の作成イベントには受信者がいません。Dashboard とSCIMのイベントでは、オートメーションは開始されません。

正規URL：https://brew.new/ja/browse/integrations/stytch

- データの方向：データ取り込み
- 接続方式：Webhook シークレット
- 認証イベントのトリガー

## 提供中の機能

- **イベントトリガー**：Stytch から直接届く Consumer のユーザーイベントと B2B のメンバーイベントのうち、受信者がわかるもので Brew のオートメーションを起動します。組織の作成、Dashboard のイベント、SCIMのイベントでは、オートメーションは開始されません。

## Stytch のイベントを、役立つメールに

Stytch を接続すると、Consumer のユーザーの登録や、B2B の組織へのメンバーの参加をきっかけに、ブランドらしいメールを送れるようになります。Brew は、Consumer と B2B の両プロダクトにわたる7種類の Stytch イベントに対応しています。

認証は、引き続き Stytch が担当します。Brew が行うのは、イベントを受け取り、それに続くメールを作成して送信することだけです。


## 作れるもの

- Consumer 向けのウェルカムメール：direct.user.create は、Stytch の Consumer ユーザーが作成されたときに発火します。
- B2B のチームのオンボーディング：direct.member.create は、メンバーが組織に参加したときに発火し、role を含みます。
- 役割変更の通知：direct.member.update は、役割や名前の変更など、メンバーのレコードが変更されたときに発火します。
- オフボーディングの通知：direct.user.delete と direct.member.delete は、ユーザーやメンバーが削除されたときに発火します。これらのイベントが処理されるのは、そのユーザーやメンバーの実際のメールアドレスを Brew がすでに把握している場合だけです。
- プロフィールの同期：direct.user.update により、Consumer ユーザーが変更されたときに、Brew のコンタクトが最新の状態に保たれます。

## オートメーションを開始するのは、direct イベントだけ

Stytch は、各イベントにソースを示すラベルを付けています。Brew が処理するのは、自社のAPIやSDKの呼び出しから発生する、ソースが direct のイベントです。Dashboard とSCIMのイベントは未対応として記録され、オートメーションを開始しません。そのため、担当者が Stytch のダッシュボードで行った変更によって、顧客にメールが届くことはありません。

direct.organization.create には受信者が含まれません。Brew はこのイベントを受信者不明として記録し、オートメーションは開始しません。人にメールを送るには、メンバーのアドレスを含む direct.member.create を使ってください。

削除イベントに含まれるのはIDだけです。Brew は、現在の接続で以前に受け取った、そのユーザーやメンバーのメールアドレスを探します。見つからない場合、そのイベントは受信者不明として記録されます。


## Brew で Stytch をセットアップする

- 「連携サービス」を開いて Stytch を選び、「Webhook URL を生成」を選択します。
- Stytch のプロジェクトに合わせて、プロジェクトの種類を Consumer（B2C）か B2B から選びます。
- Stytch のダッシュボードで「Webhooks」を開き、Brew のURLでエンドポイントを追加します。
- Consumer プロジェクトでは、direct.user.create、direct.user.update、direct.user.delete を有効にします。B2B プロジェクトでは、direct.organization.create、direct.member.create、direct.member.update、direct.member.delete を有効にします。
- エンドポイントの署名シークレット（whsec_ で始まる値）を表示して Brew に貼り付け、「接続」を選択します。Brew は、Standard Webhooks（Svix）の仕様に沿って、すべての配信を検証します。
- Stytch でエンドポイントの「Testing」タブを開き、direct.user.create か direct.member.create を選んで「Send Example」を選択します。Brew のステータスが「テストイベント待ち」から「接続済み」に変わります。サンプルは Webhook の検証にだけ使われます。Brew がコンタクトを追加したり、オートメーションを開始したりすることはありません。
- 接続すると、7種類すべてのイベントのトリガーが作成されます。イベントごとに有効・無効を切り替えるスイッチはありません。
- オートメーションを作成して Stytch イベントを選択し、まだ下書きのうちにテストを送信します。一致するイベントが届いたときに実行されるのは、稼働中のオートメーションだけです。

## 対応している Stytch イベント

direct.user.create、direct.user.update、direct.user.delete は、Consumer プロジェクトから届きます。組織とメンバーのイベントは、B2B プロジェクトから届きます。

Brew は、次の7種類のイベントに対応しています：

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

## コンタクトの同期とパーソナライズ

実際のメールアドレスを含む検証済みのイベントを受け取ると、オートメーションで使われているかどうかにかかわらず、Brew はメールアドレスで照合してコンタクトを作成または更新します。データがある場合、Brew は姓名と stytch_project を設定します。

Consumer のイベントでは stytch_user_id が、メンバーのイベントでは stytch_member_id、stytch_organization_id、stytch_org_role が設定されます。削除イベントでは stytch_account_status が deleted に設定されますが、Brew がコンタクトを削除することはありません。

差し込みタグには、選択したイベントで宣言されているペイロードのスキーマを使います。すべてのイベントに、値があれば email、firstName、lastName、createdAt が含まれます。メンバーのイベントには role が、direct.organization.create には organizationName と organizationSlug が加わります。createdAt は秒単位の Unix タイムスタンプです。

Stytch のユーザー、メンバー、組織のIDは差し込みタグにはなりません。代わりに、stytch_* フィールドとしてコンタクトに保存されます。

Stytch のアカウントがあるだけでは、マーケティングメールの受信に同意したことにはなりません。登録時に同意を記録し、プロモーションメールを送る前に確認してください。


## Brew は Stytch の認証メッセージの代わりになりますか？

いいえ。Stytch 自体の認証メッセージはそのままです。Brew は、Stytch がユーザーやメンバーを作成、更新、削除したあとに、ここに挙げた Webhook イベントをもとにオートメーションを開始します。


## イベントが表示されているのに、メールが送信されないのはなぜですか？

イベントの受信とメールの送信は、別々のステップです。一致するオートメーションが稼働中であることを確認してから、そのフィルター、実行履歴、受信者が対象に含まれるかどうか、送信ドメインを確認してください。「Send Example」による配信、Dashboard とSCIMのイベント、受信者がわからないイベントでは、オートメーションは開始されません。


## 制限事項とトラブルシューティング

- Brew は、Stytch のユーザー、メンバー、組織の作成や変更はできません。
- Stytch 側ですべての配信が401エラーになる場合は、Brew の署名シークレットがエンドポイントのシークレットと一致していません。現在のシークレットを表示して、接続し直してください。Brew で使うシークレットは、whsec_ で始まり、24文字以上である必要があります。
- 各メールの同意状況と目的を確認してください。Stytch のユーザーを同期しても、プロモーションメールを送ってよいことにはなりません。

## 出典とセットアップガイド

- [Stytch セットアップガイド](https://docs.brew.new/integrations/import/stytch)
- [オートメーションを作成する](https://docs.brew.new/create-emails/build-an-automation)
- [差し込みタグ](https://docs.brew.new/create-emails/merge-tags)
- [Brew で送信できるメール](https://docs.brew.new/get-started/what-you-can-send)
- [Stytch の Webhook](https://stytch.com/docs/resources/workspace-management/webhooks)

## 関連リンク

- [すべての連携サービス](https://brew.new/ja/browse/integrations.md)
- [新規登録](https://brew.new/ja/sign-up.md)
- ウェブサイト：https://brew.new