データパイプラインソースとしてのSlackの設定 ​

Slackをデータパイプラインソースとして設定し、チャンネル、メッセージ、スレッド、リアクション、ファイル、ユーザーなどのワークスペースデータを送信先に抽出します。

このガイドを使用して、機能と前提条件の確認、データパイプラインソースとしてのSlackの接続、パイプラインの設定、サポートされるオブジェクト、同期モード、スキーマ処理、制限について理解します。

サポートされている機能 ​

Slackをパイプラインソースとして使用する場合、次の機能がサポートされます。

• クラウド接続：https://slack.com/apiを介してHTTPS経由でSlackに接続します。オンプレミスエージェントは不要です。
• OAuth 2.0認証：Slackワークフローコネクターと同じOAuth 2.0コネクションタイプを使用して接続します。詳細については、サポートされているコネクションタイプを参照してください。
• オブジェクトレベルの選択：同期するSlackオブジェクトを送信先の個別のテーブルとして選択します。完全なリストについては、サポートされているオブジェクトを参照してください。
• 完全同期と増分同期: 完全同期モードと増分同期モードをサポートします。増分同期では、チャンネルごとのカーソルと設定可能なルックバックウィンドウを使用して、最近の編集を検出します。詳細については、同期モードを参照してください。
• ダイレクトメッセージとアーカイブ済みチャンネルの包含：必要に応じて、通常のチャンネルに加えて、ダイレクトメッセージ、グループダイレクトメッセージ、アーカイブ済みチャンネルを含めます。
• チャンネルフィルタリング：必要に応じて、ワークスペース全体ではなく、特定のチャンネルリストにパイプラインを制限します。
• 削除追跡：ネイティブの論理削除フラグ、または連続する完全同期の比較によって、サポートされるオブジェクトの削除を検出します。オブジェクトのリストについては、削除追跡を参照してください。
• スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
• フィールドレベルのデータ保護：データがデスティネーションに到達する前に、機密フィールドをハッシュ化するか、そのままレプリケートします。
• 構成可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。サポートされる最小間隔は15分です。

前提条件 ​

Slackをデータパイプラインソースとして接続するには、次が必要です。

• Slackワークスペース、および同期するすべてのチャンネルにすでにメンバーとして参加している、またはそれらのチャンネルに参加または招待されることが可能なSlackユーザーアカウント。詳細については、制限事項を参照してください。
• SlackのOAuthフローを通じてサードパーティアプリケーションを認可する権限。

推奨権限 ​

Workatoがチャンネルベースのオブジェクトを同期するには、2種類のスコープが必要です。検出スコープにより、Workatoは存在するチャンネルを検出できます。コンテンツスコープにより、Workatoはすでに検出したチャンネル内の内容を読み取れます。 channels、channel_members、messages、threads、reactions、message_attachments、message_files、pins、およびbookmarksはチャンネルリストで使用され、同期するチャンネルタイプの検出スコープが必要です。同期する各チャンネルタイプに対して、次の検出スコープを選択します。

同期するオブジェクトに対して、次の追加スコープを選択します。

channelsとchannel_membersに必要なのは、上記の検出スコープのみです。アプリがパブリックチャンネルに自動的に参加できるSlackのchannels:joinスコープは、このコネクションでは使用できません。詳細については、制限事項を参照してください。

サポートされるコネクションタイプ ​

Slackデータパイプラインは、1つの認証方法をサポートします。

• OAuth 2.0：Slackワークフローコネクターと同じコネクションタイプを使用して、WorkatoがSlackワークスペースにアクセスすることを認可します。設定手順については、Slackへの接続を参照してください。

Slackへの接続 ​

Slackをデータパイプラインソースとして接続するには、次の手順を実行します。

パイプラインの設定 ​

Slackをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

Slackデータパイプラインは、Slack Web APIからデータを同期します。次の表は、サポートされているオブジェクトをカテゴリ別に示しています。各オブジェクトは、宛先内の個別のテーブルとして同期されます。 team、user_groups、files、pins、およびbookmarksにはCustom OAuth profileが必要です。詳細については、推奨権限を参照してください。

チャンネルとメンバーシップ ​

メッセージとメッセージコンテンツ ​

ファイル、ピン、ブックマーク ​

ワークスペースとユーザー ​

同期モード ​

Slackデータパイプラインは、完全同期と増分同期をサポートします。各オブジェクトは、Slackがそのオブジェクト用の増分カーソルを公開しているかどうかに応じて、いずれか一方または両方のモードをサポートします。

フル同期 ​

完全同期では、選択したオブジェクトについてSlackから使用可能なすべてのレコードを読み取り、実行ごとに送信先テーブルを上書きします。次のオブジェクトはデフォルトで完全同期されます。

• channels
• channel_members
• files
• pins
• bookmarks
• ユーザー
• team
• user_groups

増分同期 ​

増分同期では、メッセージタイムスタンプ（ts）をカーソルとして使用し、前回の実行以降の新しいレコードのみを読み取ります。 Slackは変更以降フィルターを公開していないため、各実行では、最近の編集を検出するために、設定されたルックバックウィンドウ内のメッセージも再確認します。このウィンドウの設定についてはパイプラインの設定を、その範囲外になる内容については制限を参照してください。次のオブジェクトはデフォルトで増分同期されます。

• messages
• threads
• reactions
• message_attachments
• message_files

削除追跡 ​

削除追跡はオブジェクトごとに行われ、同期モードに従います。完全同期オブジェクトは、Workatoが各実行を前回の実行と比較するため、削除を反映します。増分オブジェクトは、比較対象となる2つ目の完全スナップショットがないため、削除を反映しません。

• channels：アーカイブ済みチャンネルを含めるを有効にすると、ネイティブのis_archivedフィールドを使用します。それ以外の場合、アーカイブ済みチャンネルは送信先から除外されます（送信先推定）。
• users：ネイティブのdeletedフィールドを使用して、ユーザーを削除するのではなく、そのフィールドがtrueに設定された非アクティブ化ユーザーを保持します。
• user_groups：Slackのdate_deleteフィールドから派生した_workato_is_deleted列を使用します。
• channel_members、files、pins、bookmarks：Slackからのネイティブシグナルはありません。 Slackに表示されなくなったレコードは、これらのオブジェクトが毎回完全同期されるため、次回の同期時に送信先から除外されます（送信先推定）。
• messages、threads、reactions、message_attachments、message_files：なし。これらは増分同期され、Slackは削除シグナルを提供しません。削除されたメッセージは、影響を受けるオブジェクトの完全同期を実行するまで、送信先に残ります。

スキーマとデータ型の処理 ​

Slackからデータを同期する場合、スキーマとデータ型には次の考慮事項が適用されます。

メッセージタイムスタンプ ​

Slackメッセージタイムスタンプ（ts）はマイクロ秒精度を持ち、チャンネル内の各メッセージの一意の識別子としても機能します。例：1512085950.000216。 Workatoは、この精度を保持するために、tsを数値ではなく文字列として保存します。

メッセージメタデータとブロック ​

messagesとthreadsには、メッセージに添付されたアプリ定義の構造化データ用に、metadata.event_type列とmetadata.event_payload列が含まれます。 Workatoは、metadata.event_payloadの形状が添付元のアプリによって定義されるため、JSON文字列として保存します。

messagesとthreadsには、SlackのBlock Kitレイアウトデータ用のblocks列も含まれます。 Workatoは、Slackがブロックコンテンツの固定スキーマにコミットしていないため、blocksを固定された列セットではなくJSON文字列として保存します。

カスタムプロファイルフィールド ​

ワークスペース管理者は、部署、従業員ID、マネージャーなど、usersオブジェクトにカスタムプロファイルフィールドを設定できます。ワークスペースに、コネクションがアクセスできるカスタムプロファイルフィールドが少なくとも1つある場合、Workatoはusersにcustom_profile_fields列を追加します。この列には、Slackの内部フィールドIDをキーとして、Slackのフィールド値がJSON文字列として含まれます。

この列にデータを入力するには、ユーザーごとに追加のSlack APIリクエストが1件必要になり、特にユーザー数の多いワークスペースではusersの同期時間が大幅に増加する可能性があります。 usersの同期に予想よりも時間がかかっている場合は、オブジェクトのフィールド選択でcustom_profile_fieldsの選択を解除します。同じ理由で、不要な他の非主キーフィールドも選択解除できます。

フィールドの選択を解除

機密データの処理 ​

Slackオブジェクトには重要なPIIが含まれる可能性があります。次のオブジェクトには、一般的に機密フィールドが含まれます:

パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

Slackをデータパイプラインソースとして使用する場合、次の制限が適用されます。

自動参加は利用不可 ​

アプリがパブリックチャンネルに自動的に参加できるSlackのchannels:joinスコープには、ボットトークンが必要です。このコネクションタイプはボットトークンをサポートしていないため、このスコープは使用できません。設定前または設定中に、パブリックチャンネルに参加するか、接続されたSlackユーザーを誰かに招待してもらいます。

同期対象は接続ユーザーがアクセスできるチャンネルのみ ​

Slackは、メッセージ、ピン、ブックマークなどのコンテンツを、接続ユーザーがすでにメンバーであるチャンネルについてのみ返します。プライベートチャンネルに回避策はありません。 Slackの管理者APIは、チャンネルメタデータのみを公開し、コンテンツは公開しません。完全なカバレッジが提供されるのは、接続ユーザーがすでにメンバーであるチャンネル、メンバーとして参加したチャンネル、または個別に参加招待されたチャンネルのみです。

削除されたメッセージは検出されません ​

Slackは削除されたメッセージを返さず、メッセージが削除されたときのシグナルも提供しません。詳細については、削除追跡を参照してください。

ルックバックウィンドウ外の編集は取得されません ​

各増分実行では、設定されたルックバックウィンドウ内に作成されたメッセージのみを再確認します（デフォルトは3日、0から30まで設定可能）。このウィンドウより古いメッセージに対する編集は、影響を受けるオブジェクトの完全同期を実行するまで取得されません。

バイナリファイルコンテンツは同期されません ​

filesとmessage_filesは、名前、タイプ、サイズ、URLなどのファイルメタデータを同期しますが、ファイルのバイナリコンテンツは同期しません。

データリテンション設定により履歴の利用可能性が制限されます ​

ワークスペースの保持ポリシーに基づいてSlackがすでに削除したメッセージは、ルックバックウィンドウまたは初回開始時に、このパイプラインでレコードの取得を開始する日付の設定に関係なく、永続的に利用できず、同期できません。

各コネクションは単一のワークスペースを対象とします ​

Slackコネクションは、Custom OAuth profileの有無にかかわらず、単一のSlackワークスペースにスコープ設定されます。複数のワークスペースでSlack Enterprise Gridを使用する場合は、同期するワークスペースごとに個別のコネクション、個別のCustom OAuth profile、Slackアプリを作成します。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。