MateFlow では、管理者がコミュニティをスタックの他の部分と接続する方法をいくつか用意しています。すべては 1 か所にまとまっています。Admin → 設定 → 連携 を開くと、連携（接続済みアプリ）、Webhook、API アクセス、ドキュメント、アクティビティ ログのタブがあります。シングルサインオンは Admin → 設定 → SSO で個別に設定します。
接続済みアプリ
「連携」タブには、数回のクリックで接続できるサードパーティ サービスが一覧表示されます。対応アプリには Zapier、Slack、Discord、Google Calendar、Mailchimp のほか、カスタム オプションがあります。接続 をクリックし、求められた認証情報を入力すると、接続は安全に保存されます。接続はいつでも同じカードから解除できます。
Webhook
Webhook は、コミュニティのイベントをあなたが管理する任意の URL に送信し、外部システムがリアルタイムで反応できるようにします。作成するには、Webhook タブに移動し、Webhook を追加 をクリックして、次の項目を設定します。
- 名前 と宛先 URL
- 購読する 1 つ以上の イベント
- 各リクエストが本当に MateFlow から送信されたものであることをエンドポイントで検証できるようにする 署名シークレット
- フックを削除せずに配信を一時停止するための 有効 トグル
MateFlow が発行するイベントは、メンバー、コンテンツ、支払いをカバーします。
| カテゴリ | イベント |
|---|---|
| メンバー | member.joined, member.role_changed, member.suspended, member.reinstated |
| コンテンツ | post.created, post.deleted, comment.created, comment.deleted |
| 支払い | payment.received, payment.failed, subscription.created, subscription.renewed, subscription.canceled, refund.issued |
テスト を使ってサンプル ペイロードを送信し、アクティビティ タブで配信ログ（ステータス、レスポンス コード、成功率）を確認して失敗をデバッグしましょう。Webhook はプランの機能であり、作成できる数はプランによって決まります。
API アクセス
API アクセス タブでは、https://api.mateflow.com の公開 API へのプログラムによるアクセス用に、権限を絞った API キーを生成できます。キーを作成する際は、名前を付け、権限（site.read、content.read、content.write、media.write など）を選択し、必要に応じて特定の IP アドレスに制限します。完全なキーは作成時に 一度だけ 表示されるため、すぐにコピーしてください。キーは同じ一覧からいつでも取り消せます。ドキュメント タブにはエンドポイントのリファレンスがあります。
シングルサインオン（SSO）
上位プランでは、メンバーに ID プロバイダー経由でのログインを必須にできます。MateFlow は SAML 2.0 と OIDC に対応しています。Admin → 設定 → SSO で IdP のメタデータを貼り付けまたは解析し、サービス プロバイダーの Entity ID と ACS URL を IdP にコピーして戻し、ログイン ポリシー（SSO とパスワード、SSO とすべての方法、または SSO のみ）を選択します。ジャストインタイム プロビジョニングは初回ログイン時にアカウントを作成し、許可ドメインはアクセス範囲を定め、リカバリー管理者はロックアウトを防ぎ、監査タブが SSO サインインを追跡します。全員に有効化する前に 接続をテスト を使用してください。
次のステップ
- 管理者が設定できる内容を 連携 で確認しましょう。
- API キーや管理者アクセスを発行する前に、メンバーのロールと権限 を確認しましょう。
- Webhook と SSO のプラン上限は 料金ページ で確認できます。