# Slack 向け Stripe Workflows

Stripe Workflows から Slack チャネルに自動通知を送信できます。

Slack 向け Stripe Workflows アプリを使用すると、Stripe でイベントが発生したときに Slack チャネルに自動通知を送信できます。[Stripe Workflows](https://docs.stripe.com/workflows.md) と組み合わせることで、決済、サブスクリプション、不審請求の申し立て、その他の Stripe イベントについてチームにリアルタイムで通知できます。

このアプリは以下に対応しています。

- **カスタムメッセージテンプレート**: Stripe イベントの動的データを含め、Slack のテキストスタイルを使ってメッセージの書式を設定します。
- **ダッシュボードのディープリンク**: 必要に応じて、各通知に関連する Stripe ダッシュボードページへのリンクを含めます。
- **複数のチャネル**: ワークフローのロジックに基づいて、通知ごとに異なる Slack チャネルにルーティングします。

## アプリをインストール

1. [Stripe App Marketplace](https://marketplace.stripe.com/) で **Slack** アプリを見つけます。
1. アカウントドロップダウンから、アプリをインストールするアカウントを選択します。
1. **インストール**をクリックします。

インストール後、アプリはインストール先のアカウントのどのページでも、右側のサイドバーにアイコンとして表示されます。画面の右上隅にある**アプリ**ボタンの横のアイコンを確認します。

## Slack に接続する

アプリをインストールしたら、Slack ワークスペースに接続します。

1. 右側のサイドバーからアプリを開きます。アプリの設定ページにアクセスするように求められます。
1. アプリ内の**設定に移動**リンクをクリックするか、右上隅にあるオーバーフローメニュー (⋯) を右クリックして、**アプリの設定を表示**を選択します。
1. 設定ページで、**Slack に追加**リンクをクリックします。
1. 接続するワークスペースをドロップダウンから選択します。このページには、アプリが要求する権限が表示されます。これらの権限により、アプリは基本的なチャネル情報を読み取り、メッセージを送信できます。
1. **許可**をクリックして接続を完了します。

接続に成功すると、設定ページに「<workspace>に接続済み」と表示されます。接続状況がすぐに反映されない場合は、ページを更新してください。

接続先のワークスペースを変更するには、設定ページで**接続を削除**をクリックし、別のワークスペースを選択する手順を繰り返します。

## チャネルの設定

### チャネルを追加

Slack 内からチャネルを追加する:

1. 有効にするチャンネルを開きます。
1. チャンネルで「/invite @Stripe」と入力します。
1. Stripe がチャンネルに参加すると、アプリの**チャンネル**リストに表示されます。すぐに表示されない場合は、**更新**をクリックしてリストを更新してください。

### チャンネルを削除

Slack 内からチャンネルを削除する:

1. 削除するチャンネルを開きます。
1. チャンネルで「/remove @Stripe」と入力します。
1. 確認を求められたら、削除を確定します。Stripe アプリで**更新**をクリックして、リストを更新します。

### テスト通知を送信する

Stripe のアプリ設定ページで、チャンネルが接続されていることを確認できます:

1. チャンネル名の横にある**テスト**をクリックします。
1. ボタンには一時的に「送信中…」と表示され、その後、テストが送信されたことを示す表示に変わります。
1. Slack でチャンネルを確認します。アプリからのテストメッセージにより、チャンネルが接続され、通知を受信できる状態であることが確認できます。

## Slack 通知を含むワークフローを作成する

**ワークフロー**は、Stripe の左側のメニューバーの**ショートカット**セクション、または**製品** > **その他** にあります。

ワークフローに Slack 通知を追加するには、次の手順を実行します。

1. **ワークフローを作成**をクリックします。
1. トリガーと、必要なデータを提供する先行ステップを追加します。
1. **ステップを追加**をクリックし、**アクションを追加**を選択します。
1. 「Slack」を検索するか、**アプリ**タグを選択し、**Slack 通知を送信**を選択します。

### アクションの設定

**アクションを編集**パネルには、3 つの必須フィールドがあります。

| フィールド                | 説明                                                                                                                                                                                         |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Slack チャンネル**      | ドロップダウンから通知のチャンネルを選択します。このリストには、アプリによるメッセージ送信を承認したすべてのチャンネルが含まれます。                                                                                                                         |
| **メッセージテンプレート**      | 通知テキストを入力します。入力欄の右下隅にある **+** ボタンをクリックして、トリガーまたは前のステップの変数を挿入します。[メッセージの書式設定](https://docs.stripe.com/use-stripe-apps/stripe-workflows-slack.md#format-messages)を使用してテキストのスタイルを設定することもできます。 |
| **ダッシュボードへのリンクを含める** | Stripe ダッシュボードの関連ページへのディープリンクを含めるには、**true** を選択します。**true** に設定すると、追加の**イベントオブジェクト ID** フィールドが表示されます。そのフィールドには、トリガーまたは前のステップの変数を使用して、リンク先にするオブジェクトの ID を設定します。                            |

> このアクションを設定する前に、トリガーまたはデータステップを追加します。変数を挿入するためのプラス記号 (+) は、前のステップで選択可能なデータが提供された場合にのみ表示されます。

ワークフローをテストするには、**公開**をクリックします。サンドボックス環境でトリガーアクションを実行し、Slack チャンネルに通知が表示されることを確認します。その後、必要に応じてワークフローを編集し、再公開できます。

### メッセージテンプレートの書式設定

メッセージテンプレートは、Slack のほとんどのテキスト書式に対応しています。

| 構文             | 結果          |
| -------------- | ----------- |
| `_テキスト_`       | *斜体テキスト*    |
| `*テキスト*`       | **太字のテキスト** |
| `~テキスト~`       | 取り消し線付きテキスト |
| `> テキスト`       | ブロック引用      |
| `コード`          | インラインコード    |
| `コード`          | コードブロック     |
| `:emoji-name:` | 名前付き絵文字     |

テキスト入力内の改行は、Slack に送信しても保持されます。記号の後にスペースを続けてリストを作成します:

```text
* Item 1
* Item 2
```

番号付きリストの場合:

```text
1. Item 1
2. Item 2
```

#### URL ハイパーリンクを追加

カスタムテキストで URL を表示するには、山括弧とパイプ区切りを使用します:

```text
<http://example.com|Display text>
```

#### ユーザー、チャンネル、グループをメンションする

メッセージテンプレート内でユーザー、チャンネル、グループをメンションするには、Slack ID (表示名ではなく) を使用します:

| タイプ  | 構文                                   | ID の確認方法                                                              |
| ---- | ------------------------------------ | --------------------------------------------------------------------- |
| ユーザー | `<@U012AB3CD>`                       | Slack でユーザーのプロフィールを開き、オーバーフローメニュー (⋯) をクリックして、**メンバー ID をコピー**を選択します。 |
| チャネル | `<#C123ABC456>`                      | チャネルのオーバーフローメニュー (⋯) をクリックし、**チャネルの詳細を開く**を選択して、下部にあるチャネル ID をコピーします。 |
| グループ | `<!subteam^SAZ94GDB8>`               | 管理者権限が必要です。ユーザーグループのプロフィールを表示しているときに、URL からグループ ID を確認します。            |
| 特殊   | `<!everyone>`,`<!here>`,`<!channel>` | これらを使用して、全員、アクティブなメンバー、またはチャネルのすべてのメンバーにメンションできます。                    |

## ワークフローの例

### 高額な決済の通知を送信する

1,000 USD を超える決済が発生したときにチャネルに通知するワークフローを作成します:

1. **トリガーを追加**をクリックし、**決済インテントが成功しました**を選択します。
1. **トリガー条件**で、**条件を追加**をクリックします。条件を、**受領金額**が 1,000.00 USD 以上になるように設定します。
1. **ステップを追加**をクリックし、**アクションを追加**を選択します。**顧客を取得**を検索し、プラス記号 (+) を使用してトリガーから**顧客 ID** を選択し、**顧客 ID** を設定します。
1. **ステップを追加**をクリックし、**アクションを追加**を選択します。**Slack 通知を送信**を検索し、次のように設定します。
   - **Slack チャネル**: チャネルを選択します (例: `#wins`)。
   - **メッセージテンプレート**: 変数を使用してメッセージを作成します。以下に例を示します。
     ```text
     *Big win!* :tada:
     We just closed a large deal!
     {Payment intent | Amount received} from {Customer | Name}
     {Payment intent | Description}
     Payment processed on {Payment intent | Created}
     ```
   - **ダッシュボードリンクを含める**: **true** に設定します。
   - **イベントオブジェクト ID**: トリガーから**決済インテント ID** を選択します。
1. **公開**をクリックしてテスト決済を送信し、ワークフローの動作を確認します。

この例では、トリガー条件、関連オブジェクトからのデータ取得、変数を使用したメッセージの作成、ダッシュボードのディープリンクの追加について説明します。

### サブスクリプションタイプ別の通知の振り分け

顧客が登録したサブスクリプションプランに基づいて、別々のチャネルに通知を送信するワークフローを作成します。

1. **ワークフローを作成**をクリックし、トリガーを**顧客のサブスクリプションが作成された**に設定します。
1. **Slack 通知を送信**アクションを追加して、すべての新規サブスクリプションについて一般チャネルに通知します。
   - **Slack チャネル**: 一般サブスクリプション用のチャネルを選択します。
   - **メッセージテンプレート**: たとえば、「新しいサブスクリプションの通知です！ {Subscription | Description}」のように入力します。
   - **ダッシュボードリンクを含める**: **true** に設定し、**イベントオブジェクト ID** には**サブスクリプション ID** を指定します。
1. **顧客を取得**アクションを追加し、プラス記号 (+) を使用して**顧客 ID** を設定します。
1. **条件**ステップを追加して、ワークフローを分割します:
   - トリガーの**項目 (コレクション)** に、**価格** > **商品 ID** が Enterprise プランと等しい項目が 1 つ以上含まれているかどうかを確認する条件を設定します。
1. **true** 分岐に、**Slack 通知を送信**アクションを追加します:
   - **Slack チャネル**: `#enterprise` チャネルを選択します。
   - **メッセージテンプレート**: たとえば、「新しいエンタープライズクライアントです！ {Customer | Name} さん、私たちのグループへようこそ！」などです。
   - **ダッシュボードへのリンクを含める**: **true** に設定し、**イベントオブジェクト ID** を**顧客 ID** に設定します。
1. **false** 分岐に、**Slack 通知を送信**アクションを追加します:
   - **Slack チャネル**: `#hobby` チャネルを選択します。
   - **メッセージテンプレート**: たとえば、「新しいホビーユーザーがやって来ました！{Customer | Name} さん、クルーへようこそ！」などです。
   - **ダッシュボードへのリンクを含める**: **true** に設定し、**イベントオブジェクト ID** を**顧客 ID** に設定します。

この例では、異なるチャネルへの複数の Slack 通知、条件付きワークフローロジック、複数のステップのデータを使ってコンテキストを追加するメッセージについて説明しています。