Slack - トリガー

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

要件

Slackレシピの構築を開始する前に、Slackアプリを作成し、Workatoワークスペース内にインストールする必要があります。

Slackアプリを作成するには、次の手順を完了します。

1

Slack API > Your Appsに移動し、Create New Appを選択します。

2

Slackアプリの名前を選択し、ワークスペースを選択してアプリを作成します。

Slackアプリの作成Slackアプリの作成

ワークスペースにアプリをインストールする前に、少なくとも1つの権限スコープを定義する必要があります。 イベントをサブスクライブすると、Slackは必要な権限スコープを自動的に追加します。 イベントサブスクリプションの詳細については、次のセクションを参照してください。

イベントサブスクリプションの有効化

トリガーがイベントを取得するには、Slackアプリでこれらのイベントの送信先を把握しておく必要があります。 そのため、新規イベントトリガーには、イベント名を入力した後に生成されるターゲットURLが付属しています。 アプリがレシピのターゲットURLにイベントを送信すると、レシピが処理を引き継ぎ、レシピのアクションを実行できます。

ターゲットURLアプリがイベントを送信するターゲットURL

イベント名は、Workatoワークスペース内で一意である必要はありません。 複数のSlackレシピで同じイベント名を使用できます。 これにより、単一のイベントを使用して、同じイベント名を持つ複数のレシピをトリガーできます。

イベントサブスクリプションを有効にするには、次の手順を完了します。

1

Slackアプリページに移動し、機能セクションを見つけて、イベントサブスクリプションをクリックします。

SLACK APP ID

Slackアプリページは次のようになります。

html
https://api.slack.com/apps/{your_app_id}
2

イベントサブスクリプションに移動し、イベントを有効化トグルをクリックします。

3

Workatoワークスペースに移動し、Slackの新規イベントトリガーからターゲットURLをコピーします。

4

Slackアプリページに移動し、ターゲットURLをリクエストURLフィールドに貼り付けます。

5

保存をクリックします。

イベントサブスクリプションイベントサブスクリプションの有効化

ボットイベントのサブスクライブ

Slackには、サブスクライブしてレシピのトリガーに使用できるボットイベントの一覧が用意されています。

この例では、特定のチャンネルやダイレクトメッセージ(DM)に'resolve'という単語を含むメッセージが投稿されたときに、カスタマーサクセスユーザーが自分と顧客の間にプライベートチャンネルを作成できるオプションが提供されます。 この例では、次のイベントをトリガーとして使用します。

  • message.channels
  • message.groups
  • message.im

イベントサブスクリプションの例チャンネル、プライベートチャンネル、またはDMにメッセージが投稿されると、イベントがレシピに送信されます

Event subscriptionsを使用するには、Slackアプリに権限スコープが必要です。 イベントをサブスクライブすると、Slackは必要な権限スコープを自動的に追加します。

アプリのインストール

少なくとも1つのボットイベントをサブスクライブすると、Slackは権限スコープをアプリに自動的に追加します。 これで、ワークスペースにアプリをインストールできます。

新規イベントトリガー(リアルタイム)

新規イベントトリガーは、接続済みのSlackインスタンス内のすべてのボットイベントを検出します。 各新規イベントトリガーには、イベント名を入力した後に生成されるターゲットURLが付属しています。 このターゲットURLは、イベントサブスクリプションを有効にするために使用されます。

入力

イベント名

イベント名を入力して、ボットイベントをサブスクライブするための一意のターゲットURLを生成します。 イベント名には、サブスクライブするイベントを説明する名前を指定します。

イベント名ボットイベントをサブスクライブするために使用されるターゲットURLは、イベント名を入力すると生成されます

出力

入力項目説明
チームIDSlackワークスペースのID。
APIアプリIDボットイベントにサブスクライブしているSlackアプリのID。
イベントIDイベントのID。
イベント時刻イベントのタイムスタンプ。
イベントタイプイベントのタイプ。
ユーザーイベントをトリガーしたユーザーのユーザーID。
テキストテキストのメッセージコンテンツ。
Tsイベントのタイムスタンプ。
チャネルイベントが発生したチャンネルID。
イベントtsイベントのタイムスタンプ。

ボタンクリック(リアルタイム)

ボタンクリックトリガーは、ボタンクリックを処理します。 これらのボタンクリックは、ボタン付きメッセージをユーザーに投稿する別のレシピから送信されます。 ボタンの使用方法の詳細については、Slackメッセージボタンの使用ドキュメントを参照してください。

入力

入力フィールドはありません。

出力

出力フィールド説明
アクション名ボタンを操作するSlackユーザーに表示されるボタンラベル。
アクションID ボタンの内部値。
チャネルIDボタンがクリックされたチャンネルのID。
名前 チャンネル名。
ユーザーID ボタンをクリックしたユーザーのユーザーID。
名前 ボタンをクリックしたユーザーの名前。
チームIDSlackワークスペースのID。
ドメインSlackワークスペースのドメイン。
アクションタイムスタンプボタンがクリックされたときのタイムスタンプ。
メッセージIDクリックされたボタンを含んでいたメッセージのID。
添付ファイルIDクリックされたボタンのID。 Slackのコンテキストでは、ボタンはメッセージ添付ファイルの一種です。
レスポンスURLボタンクリックへの応答に使用するURLで、ボタンクリックに応答アクションで使用されます。

Last updated: