SlackPost - Slackにメッセージを送信
SlackのWeb APIを使用してSlackにメッセージを送信します。
ユーザまたはボットが参加している会話（チャンネル、ダイレクトメッセージなど）へメッセージを送信できます。
ボットトークンにchat:write及びchat:write.publicスコープを設定した場合、ボットが参加していないパブリックチャンネルにメッセージを送信できます。
スレッドタイムスタンプにメッセージのタイムスタンプを指定するとリプライとしてメッセージを送信できます。
■ストリーム情報
| 入力 | フォーマット | すべて |
|---|---|---|
| 接続数 | 1 | |
| 説明 | 入力ストリームは使用せず、すべて無視します。 | |
| 出力 | フォーマット | Text,MIME |
| 説明 | Slack APIのレスポンスが出力されます。 |
出力ストリーム変数
| 名前 | データ型 | 説明 |
|---|---|---|
| StatusCode | int | HTTPレスポンスのステータスコード |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| コネクションを使用 | boolean | - |
接続先に以下のコネクション を使用するかどうか選択します。
|
||||||
| コネクション | connection | - | コネクションを使用 が「はい」の場合に、Slackアプリケーションへの接続用コネクションを指定します。
コネクションペインまたは管理コンソールにて作成した接続名を選択します。 各コネクションの詳細については、「はじめに」-「詳細なトピック」-「フローの構成要素」-「コネクションプロパティ」を参照してください。 |
||||||
| コネクション情報 | group | - | コネクションを使用 プロパティが「いいえ」の場合に使用されるプロパティ群です。 | ||||||
| Slack APIのトークン | string | 入力＆出力 |
Slack Web APIのトークンを指定します。トークンは「Your Apps＞Add features and functionality＞Permissions＞OAuth&Permissions」画面から取得したOAuth Access Tokenを使用します。
トークンのタイプによって次のスコープの設定が必要になります。
|
||||||
| チャンネル | string | 入力＆出力 |
メッセージを送信するチャンネルを指定します。
パブリックチャンネル、プライベートチャンネルを指定する場合は、チャンネル名（例 #general）もしくはチャンネルID（例 C024BE91L）を指定します。 ダイレクトメッセージ、グループダイレクトメッセージを送信する場合は、ID (例 D023BB3L2)を指定します。 ※IDはSlackのWeb画面で対象のチャンネルやユーザーを選択するとURLの最後のパスとして表示されています。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。 |
||||||
| タイムアウト（秒） | int | 入力＆出力 |
リクエスト時およびコネクション接続時のタイムアウトまでの時間を秒単位で指定します。
コネクションを使用 が「いいえ」の場合にこの設定が参照されます。 |
||||||
| リトライ回数 | int | 入力＆出力 |
リクエスト時にHTTPサーバーに接続できなかったときに自動的にリトライするカウントを指定します。リトライしない場合は0を指定します。
コネクションを使用 が「いいえ」の場合にこの設定が参照されます。 |
||||||
| リトライ間隔（秒） | int | 入力＆出力 |
上記リトライ時に再度接続リクエストを送るまでの間隔を秒単位で指定します。
コネクションを使用 が「いいえ」の場合にこの設定が参照されます。 |
||||||
| プロキシ設定を使用 | boolean | - |
管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。
コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
|
||||||
| メッセージ | string | 入力＆出力 |
送信するテキストを指定します。
ブロックと同時に使用した場合、通知時のメッセージとして使用されます。 テキストのフォーマットについてはhttps://api.slack.com/docs/message-formattingを参照してください。 |
||||||
| ブロック | string | 入力＆出力 |
Block Kit layout blocksを表すJSON配列の文字列を指定します。
Block Kit layout blocksについてはReference: Layout blocksを参照してください。 JSON配列の文字列の例:
|
||||||
| アタッチメント | string | 入力＆出力 |
Attachmentsを表すJSON配列の文字列を指定します。
AttachmentsについてはReference: Secondary message attachmentsを参照してください。 JSON配列の文字列の例:
|
||||||
| ユーザー名 | string | 入力＆出力 |
メッセージを送信するユーザー名を指定します。指定しない場合はSlack Web APIのアプリ名が使用されます。
このプロパティを利用するためには次のスコープの設定が必要になります。
|
||||||
| リンク自動変換 | boolean | 入力＆出力 | メッセージとアタッチメントに指定した文字列を解析して、URLやメンションとして認識される文字列をURLやメンションのリンクに自動変換するかどうかを設定します。
URLや文字列として認識される文字列の詳細はAutomatic parsingを参照してください。 リンクまたはメンションに変換される文字列の例:
|
||||||
| スレッドタイムスタンプ | string | 入力＆出力 |
リプライを送信したいメッセージのタイムスタンプを指定します。
スレッドにメッセージに送信したい場合、スレッドの親メッセージのタイムスタンプを指定します。 メッセージのタイムスタンプはSlackGetコンポーネントで取得できます。 |
■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
| タイプ | パラメーター | エラー処理フロー
へのストリーム | エラー
コード | 説明 |
|---|---|---|---|---|
| SlackApiException | 「SlackApiExceptionのパラメーター
」
を参照してください。 | サーバーから返されたHTTPレスポンスのMIME | 1 | Slack APIがエラーを返した場合 |
| HTTPException | なし | コンポーネントの入力ストリーム | 2 | Slackとの通信中にエラーが発生した場合 |
| 3 | Slackとの通信中、もしくは通信前処理でエラーが発生した場合 | |||
| 汎用 | なし | コンポーネントの入力ストリーム | 4 | 「メッセージ」「ブロック」「アタッチメント」のうち一つも値が設定されていない場合 |
| 5 | コネクション に指定したコネクションが見つからない場合 | |||
| 9 | その他のエラーが発生した場合 |
■「SlackApiException」のパラメーター
| No. | 名前 | 説明 |
|---|---|---|
| 1 | HTTPStatusLine | サーバーから返されたHTTPステータスラインが返されます。 |
| 2 | HTTPBody | サーバーから返されたHTTPレスポンスのボティが返されます。 |
■フローの強制終了
フローを強制終了すると、通常は実行中のコンポーネントの処理が終了してから次のコンポーネントに制御が遷移する時点でフローがアボートしますが、本コンポーネントでは実行中の処理を強制的に終了してフローがアボートします。