Slack
Slack はチームコミュニケーションツールで、すべてのチームコミュニケーションを 1 か所にまとめ、どこからでもすぐに検索して利用できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Standard | 次を除くすべての Power Apps リージョン : - 21Vianet が運営する China Cloud |
| Power Automate（パワーオートメート） | Standard | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL | https://support.microsoft.com/contactus |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://slack.com/ |
| プライバシー ポリシー | https://slack.com/privacy-policy |
| カテゴリ | コラボレーション;通信 |
既知の問題と制限事項
Slack API のドキュメントに従って、コネクタで使用される一部の Slack API メソッドは 2021 年 2 月に機能しなくなります。また、2020 年 6 月 10 日以降、新しく作成されたアプリでは動作しません。 そのため、以下のアクションの最新バージョンを使用してください。
操作:
グループの作成 は非推奨です。最新バージョンの [Create a channel]\(チャネルの作成 \) を使用してプライベート チャネルを作成してください。
メッセージ内の最大文字数は 4,000 文字に制限されています。 詳細については、Slack の 公式ドキュメントを参照してください。
コネクタの詳細
コネクタの詳細については、 詳細なセクションを参照してください。
調整制限
| Name | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガーポーリングの頻度 | 1 | 120 秒 |
アクション
| グループの作成 [非推奨] |
余裕期間にグループを作成します。 |
| チャネルの一覧表示 [非推奨] |
このアクションは非推奨になりました。 代わりに 、パブリック チャネルの一覧表示 (改ページ位置のサポート) を使用してください。
|
| チャネルの作成 [非推奨] |
このアクションは非推奨になりました。 代わりに、 チャネルの作成を 使用してください。
|
| チャネルへの参加 [非推奨] |
このアクションは非推奨になりました。 代わりに [パブリック チャネルに参加する ]を使用してください。
|
| チャネルを作成する |
余裕期間でチャネルを作成します。 |
| パブリック チャネルに参加する |
余裕を持ってパブリック チャネルに参加します。 |
| パブリック チャネルの一覧表示 (改ページ調整のサポート) (プレビュー) |
余裕期間のパブリック チャネルを一覧表示します。 |
| パブリック チャネルを一覧表示する |
余裕期間のパブリック チャネルを一覧表示します。 |
| メッセージの投稿 (V2) |
この操作は、指定されたチャネルにメッセージを投稿するために使用されます。 |
| メッセージの投稿 [非推奨] |
このアクションは非推奨になりました。 代わりに Post メッセージ (V2) を使用してください。
|
| メッセージの返信を一覧表示する (プレビュー) |
親メッセージを含むメッセージ スレッド内の応答を一覧表示します。 |
| ユーザー プロファイルを取得する (プレビュー) |
Slack ユーザーのプロファイル情報を取得します。 メッセージ交換メッセージの一覧表示またはメッセージの返信の一覧表示によって返されるメッセージの作成者を解決するのに役立ちます。 |
| 会話メッセージを一覧表示する (プレビュー) |
会話に投稿されたメッセージ (パブリック チャネル、プライベート チャネル、ダイレクト メッセージ、またはグループ ダイレクト メッセージ) を一覧表示します。 |
| 応答しない設定 |
ユーザーの応答不可の状態を設定します。 |
グループの作成 [非推奨]
余裕期間にグループを作成します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | string |
グループの名前を指定します。 |
返品
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
ID (アイディー)
|
group.id | string |
グループの ID。 |
|
名前
|
group.name | string |
グループの名前を指定します。 |
チャネルの一覧表示 [非推奨]
チャネルの作成 [非推奨]
このアクションは非推奨になりました。 代わりに、 チャネルの作成を 使用してください。
余裕期間でチャネルを作成します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | string |
新しいチャネルの名前。 |
返品
チャネルへの参加 [非推奨]
このアクションは非推奨になりました。 代わりに [パブリック チャネルに参加する ]を使用してください。
余裕期間でチャネルに参加します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | string |
チャネルの名前。 |
返品
- Body
- JoinChannel_Response
チャネルを作成する
余裕期間でチャネルを作成します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | string |
新しいチャネルの名前。 |
|
|
プライベート チャネルですか?
|
is_private | boolean |
チャネルがプライベートかどうか |
返品
パブリック チャネルに参加する
余裕を持ってパブリック チャネルに参加します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チャネル名
|
channel | string |
チャネルの名前。 |
返品
パブリック チャネルの一覧表示 (改ページ調整のサポート) (プレビュー)
パブリック チャネルを一覧表示する
余裕期間のパブリック チャネルを一覧表示します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
会話の種類
|
types | string |
含めるコンマ区切りの会話の種類。 既定値は public_channel です。 private_channel、im、または mpim を明示的に含め、他の会話の種類を一覧表示します。 |
|
|
アーカイブを除外する
|
exclude_archived | boolean |
アーカイブされた会話を除外するには、true に設定します。 |
|
|
最大結果
|
limit | integer |
返される会話の最大数。 |
|
|
チーム ID
|
team_id | string |
エンコードされたチーム ID。組織全体のトークンにのみ必要です。 |
|
|
Cursor
|
cursor | string |
前の要求によって返された改ページ位置カーソル。 |
返品
メッセージの投稿 (V2)
この操作は、指定されたチャネルにメッセージを投稿するために使用されます。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チャネル名
|
channel | True | string |
メッセージを送信するチャネル、プライベート グループ、または IM チャネル。 name (例: #general) またはエンコードされた ID を指定できます。 |
|
メッセージ テキスト
|
text | True | string |
送信するメッセージの本文。 Slack API では、40,000 文字を超えるメッセージが切り捨てられます。 書式設定オプションについては、次を参照してください。 https://api.slack.com/docs/formatting |
|
親メッセージのタイムスタンプ
|
thread_ts | string |
スレッドに返信を投稿するときの親メッセージのタイムスタンプ。 |
|
|
チャネルにブロードキャストする
|
reply_broadcast | boolean |
チャネルにスレッド応答を送信する場合も true を渡します。 |
|
|
ボット名
|
username | string |
ボットの名前。 |
|
|
ユーザーとして投稿
|
as_user | boolean |
ボットとしてではなく、認証されたユーザーとしてメッセージを投稿するには true を渡します。 |
|
|
解析モード
|
parse | string |
メッセージの処理方法を変更します。 詳細については、以下を参照してください。 https://api.slack.com/docs/formatting |
|
|
Slack マークアップの解析
|
mrkdwn | boolean |
Slack マークアップ解析の設定。 既定で有効になっています。 |
|
|
リンク名
|
link_names | integer |
チャネル名とユーザー名を検索してリンクします。 |
|
|
リンクの削除
|
unfurl_links | boolean |
主にテキストベースのコンテンツの展開を有効にするには、true を渡します。 |
|
|
メディアの展開を解除する
|
unfurl_media | boolean |
メディア コンテンツの展開を無効にするには false を渡します。 |
|
|
アイコンの URL
|
icon_url | uri |
このメッセージのアイコンとして使用する画像の URL。 |
|
|
アイコン絵文字
|
icon_emoji | string |
このメッセージのアイコンとして使用する絵文字。 |
返品
Slack チャネルに投稿されたメッセージの詳細。
- Body
- PostMessageResponse
メッセージの投稿 [非推奨]
このアクションは非推奨になりました。 代わりに Post メッセージ (V2) を使用してください。
この操作は、指定されたチャネルにメッセージを投稿するために使用されます。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チャネル名
|
channel | True | string |
メッセージを送信するチャネル、プライベート グループ、または IM チャネル。 name (例: #general) またはエンコードされた ID を指定できます。 |
|
メッセージ テキスト
|
text | True | string |
送信するメッセージの本文 (4,000 文字未満)。 書式設定オプションについては、「 https://api.slack.com/docs/formatting」を参照してください。 |
|
ボット名
|
username | string |
ボットの名前。 |
|
|
ユーザーとして投稿
|
as_user | boolean |
ボットとしてではなく、認証されたユーザーとしてメッセージを投稿するには true を渡します。 |
|
|
解析モード
|
parse | string |
メッセージの処理方法を変更します。 詳細については、 https://api.slack.com/docs/formattingを参照してください。 |
|
|
リンク名
|
link_names | integer |
チャネル名とユーザー名を検索してリンクします。 |
|
|
リンクの削除
|
unfurl_links | boolean |
主にテキストベースのコンテンツの展開を有効にするには、true を渡します。 |
|
|
メディアの展開を解除する
|
unfurl_media | boolean |
メディア コンテンツの展開を無効にするには false を渡します。 |
|
|
アイコンの URL
|
icon_url | uri |
このメッセージのアイコンとして使用する画像の URL。 |
|
|
アイコン絵文字
|
icon_emoji | string |
このメッセージのアイコンとして使用する絵文字。 |
返品
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
成功の結果
|
ok | boolean |
操作が成功したかどうかを示します。 |
|
チャネル
|
channel | string |
メッセージが投稿されたチャネル。 |
|
作成された Date-Time
|
ts | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
メッセージ テキスト
|
message.text | string |
メッセージの本文。 |
|
メッセージ ID
|
message.id | string |
メッセージの一意識別子。 |
|
Creator Id
|
message.user | string |
メッセージを投稿したユーザーの一意識別子。 |
|
作成時刻
|
message.created | integer |
メッセージが作成されたときの Unix タイムスタンプ。 |
|
削除済み
|
message.is_user-deleted | boolean |
メッセージが削除されたかどうか。 |
|
エラー メッセージ
|
error | string |
エラー メッセージの詳細 (存在する場合)。 |
メッセージの返信を一覧表示する (プレビュー)
親メッセージを含むメッセージ スレッド内の応答を一覧表示します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
会話 ID
|
channel | True | string |
スレッドを含む会話。 |
|
親メッセージのタイムスタンプ
|
ts | True | string |
スレッドを開始する親メッセージのタイムスタンプ。 メッセージ交換メッセージの一覧表示によって返されるメッセージの |
|
最大結果
|
limit | integer |
1 ページあたりに返されるメッセージの最大数。 |
|
|
最も古いタイムスタンプ
|
oldest | string |
この Unix タイムスタンプの後のメッセージのみが結果に含まれます。 |
|
|
最新のタイムスタンプ
|
latest | string |
この Unix タイムスタンプより前のメッセージのみが結果に含まれます。 |
|
|
包括的
|
inclusive | boolean |
結果に最も古いタイムスタンプまたは最新のタイムスタンプを持つメッセージを含めます。 |
返品
ユーザー プロファイルを取得する (プレビュー)
Slack ユーザーのプロファイル情報を取得します。 メッセージ交換メッセージの一覧表示またはメッセージの返信の一覧表示によって返されるメッセージの作成者を解決するのに役立ちます。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ユーザー ID
|
user | True | string |
プロファイル情報を取得するユーザーの ID。 |
返品
会話メッセージを一覧表示する (プレビュー)
会話に投稿されたメッセージ (パブリック チャネル、プライベート チャネル、ダイレクト メッセージ、またはグループ ダイレクト メッセージ) を一覧表示します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
会話 ID
|
channel | True | string |
メッセージをフェッチするスレッド。 |
|
最大結果
|
limit | integer |
1 ページあたりに返されるメッセージの最大数。 |
|
|
最も古いタイムスタンプ
|
oldest | string |
この Unix タイムスタンプの後のメッセージのみが結果に含まれます。 |
|
|
最新のタイムスタンプ
|
latest | string |
この Unix タイムスタンプより前のメッセージのみが結果に含まれます。 |
|
|
包括的
|
inclusive | boolean |
結果に最も古いタイムスタンプまたは最新のタイムスタンプを持つメッセージを含めます。 |
|
|
すべてのメタデータを含める
|
include_all_metadata | boolean |
各メッセージに関連付けられているすべてのメタデータを返します。 |
返品
応答しない設定
ユーザーの応答不可の状態を設定します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
時間 (分)
|
num_minutes | string |
[応答しない] を設定する分数。 |
返品
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
再通知が有効
|
snooze_enabled | boolean |
再通知が有効かどうか。 |
トリガー
| ファイルの作成時 |
ファイルの作成時 |
ファイルの作成時
ファイルの作成時
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チャネル
|
channel | True | string |
チャネルの名前。 |
返品
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
ID (アイディー)
|
id | string |
ファイルの ID |
|
作成済み
|
created | integer |
ファイルが作成されたとき。 |
|
名前
|
name | string |
ファイルの名前。 |
|
Title
|
title | string |
ファイルのタイトル。 |
定義
チャネル
チャネル
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
ID (アイディー)
|
id | string |
チャネルの ID。 |
|
名前
|
name | string |
チャネルの名前。 |
|
パブリック チャネル
|
is_channel | boolean |
この会話がパブリック チャネルであるかどうか。 |
|
プライベート チャネル
|
is_group | boolean |
この会話がプライベート チャネルであるかどうか。 |
|
直接メッセージ
|
is_im | boolean |
この会話が 2 人のユーザー間の直接メッセージであるかどうか。 |
|
グループ ダイレクト メッセージ
|
is_mpim | boolean |
この会話がグループダイレクト メッセージかどうか。 |
|
プライベートである
|
is_private | boolean |
この会話がプライベートかどうか。 |
|
アーカイブ済みである
|
is_archived | boolean |
この会話がアーカイブされているかどうか。 |
|
メンバー
|
is_member | boolean |
認証されたユーザーがこの会話のメンバーであるかどうか。 |
|
ユーザー ID
|
user | string |
ダイレクト メッセージの場合、会話内の他のユーザーの ID。 |
|
メンバー数
|
num_members | integer |
この会話のメンバーの数。 |
ListChannels_Response
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
channels
|
channels | array of Channel | |
|
次のカーソル
|
response_metadata.next_cursor | string |
次の要求に渡すカーソル。 結果がそれ以上ない場合は空です。 |
ListChannels_ResponseV3
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of Channel |
SlackMessage
Slack の会話に投稿されたメッセージ。
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ ID
|
ts | string |
メッセージの一意のタイムスタンプ識別子。 |
|
作成者 ID
|
user | string |
メッセージを投稿したユーザーの ID。 ユーザー プロファイルの取得を使用して、ユーザーに対してこれを解決します。 |
|
メッセージ テキスト
|
text | string |
メッセージの本文。 |
|
メッセージの種類
|
type | string |
メッセージの種類。 |
|
スレッド ID
|
thread_ts | string |
このメッセージがスレッドの一部である場合は、親メッセージのタイムスタンプ。 |
|
応答数
|
reply_count | integer |
スレッドを開始した場合の、このメッセージへの応答の数。 |
ListMessages_Response
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of SlackMessage |
SlackUserProfile
Slack ユーザーの追加プロファイルの詳細。
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
表示される名前
|
display_name | string |
ユーザーがプロファイルに選択した表示名。 |
|
実名
|
real_name | string |
ユーザーの姓と名。 |
|
Email
|
string |
ユーザーの電子メール アドレス。 |
|
|
アバター URL
|
image_72 | string |
ユーザーのアバターの 72 x 72 ピクセル バージョンの URL。 |
SlackUser
Slack ユーザー。
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
ID (アイディー)
|
id | string |
ユーザーの ID。 |
|
ユーザー名
|
name | string |
ユーザーの Slack ユーザー名。 |
|
実名
|
real_name | string |
ユーザーの姓と名。 |
|
ボット
|
is_bot | boolean |
ユーザーがボットであるかどうか。 |
|
非アクティブ化されています
|
deleted | boolean |
ユーザーのアカウントが非アクティブ化されているかどうか。 |
|
タイム ゾーン
|
tz | string |
ユーザーの人間が判読できるタイム ゾーン。 |
|
Profile
|
profile | SlackUserProfile |
Slack ユーザーの追加プロファイルの詳細。 |
GetUserProfile_Response
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
成功の結果
|
ok | boolean |
操作が成功したかどうかを示します。 |
|
User
|
user | SlackUser |
Slack ユーザー。 |
|
エラー メッセージ
|
error | string |
エラー メッセージの詳細 (存在する場合)。 |
CreateChannel_Response
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
チャネル
|
channel | Channel |
チャネル |
JoinChannel_Response
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
チャネルに既に存在する
|
already_in_channel | boolean |
ユーザーが既にチャネルに参加しているかどうか。 |
|
チャネル
|
channel | Channel |
チャネル |
JoinChannel_ResponseV2
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
チャネル
|
channel | Channel |
チャネル |
|
Warnung
|
warning | string |
ユーザーが既にチャネルに参加しているかどうか。 |
PostMessageResponse
Slack チャネルに投稿されたメッセージの詳細。
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
成功の結果
|
ok | boolean |
操作が成功したかどうかを示します。 |
|
チャネル
|
channel | string |
メッセージが投稿されたチャネル。 |
|
作成時刻
|
ts | string |
メッセージが作成されたときの Unix タイムスタンプ。 |
|
メッセージの種類
|
message.type | string |
メッセージの種類。 |
|
メッセージ テキスト
|
message.text | string |
メッセージの本文。 |
|
作成時刻
|
message.ts | string |
メッセージが作成されたときの Unix タイムスタンプ。 |
|
エラー メッセージ
|
error | string |
エラー メッセージの詳細 (存在する場合)。 |