連携の概要

外部システムとサービスをオペレーターが使用できるツールとして接続する

Supervity において、連携はオペレーターがアクションを実行するために使用を許可されたツール です。

オペレーターは以下が可能になります。

外部システムからデータを読み取る
レコードを書き込みまたは更新する
ツール横断でアクションをトリガーする
プラットフォーム横断で作業を連携する

連携はスクリプトや静的コネクタではありません。
プラットフォームによって実施される 統制された機能 です。

連携ガイド

特定の連携のステップバイステップ設定・利用ドキュメント：

連携	ガイド
Zoom	Zoom 連携ガイド

連携のプラットフォーム上での位置づけ

text

オペレーターがいつツールが必要かを決定する
ワークフローが どのように 実行するかを定義する
プラットフォームが セキュリティ、権限、監査可能性 を実施する

連携の種類

組み込み連携

組み込み連携は Supervity が保守・サポートします。

特性：

事前設定済み
デフォルトで安全
継続的に更新
オペレーター実行に最適化

例：

コミュニケーション・メッセージングツール
ファイルストレージ・ドキュメントシステム
crm・ビジネスアプリケーション
生産性ツール
開発・運用プラットフォーム

カスタム連携（外部ツールと API）

標準で利用できないシステム向けに、以下で Supervity を拡張できます。

rest api をツールとして登録
内部サービスを接続
レガシーシステムをラップ
カスタムビジネスアクションを公開

登録後、これらのツールは組み込み連携と同様に動作します。

→ 詳細：ツールと外部 API

一般的な連携カテゴリ

コミュニケーション・メッセージング

gmail、outlook
slack、microsoft teams
sms・通知サービス

典型的なアクション

メッセージ送信
受信コミュニケーションの読み取り
関係者への通知

ファイルストレージ・ドキュメント

google drive
onedrive
dropbox
エンタープライズファイルシステム

典型的なアクション

ファイルのアップロード・ダウンロード
フォルダ整理
ドキュメント処理

CRM・営業システム

salesforce
hubspot

典型的なアクション

リードの作成・更新
連絡先の同期
商談のルーティング

生産性・データ

google sheets
airtable
excel 互換サービス

典型的なアクション

行の読み書き
レポート生成
データセットの維持

プロジェクト・開発ツール

jira
asana
github
gitlab

典型的なアクション

タスクまたはイシューの作成
進捗追跡
イベントからのワークフロートリガー

連携の設定

ステップ 1：連携を接続する

settings → integrations に移動する
サービスを選択する
認証する（oauth、api key、または service account）
必要な権限を付与する

連携はワークスペースにスコープされ、中央で統制されます。

ステップ 2：オペレーターとワークフローで連携を使用する

接続後、連携は以下で利用可能になります。

オペレーター計画時
ワークフローステップとして
トリガーまたはアクションとして
条件ロジック内

オペレーターは実行計画時に利用可能な連携を自動的に考慮します。

認証とセキュリティ

サポートされる認証方法：

oauth 2.0（推奨）
api keys
service accounts
custom headers（高度）

セキュリティ保証：

保存時の認証情報暗号化
最小権限スコープ
トークンローテーションサポート
即時アクセス取り消し

→ 詳細：セキュリティとプライバシー

連携の管理

接続済み連携の表示

各連携について以下を検査できます。

接続ステータス
付与された権限
最終使用タイムスタンプ
関連ワークフローとオペレーター

再接続または認証情報のローテーション

認証情報の有効期限切れの場合：

通知を受け取る
settings で再接続する
ワークフローまたはオペレーターの変更は不要

連携の切断

連携を切断すると：

アクセスが即座に取り消される
今後の実行が防止される
ワークフローまたはオペレーターは削除されない

影響を受ける実行は明確なエラーで安全に失敗します。

連携ガバナンス

連携はプラットフォームレベルの制御を尊重します。

ロールベースアクセス
ワークスペース権限
機密アクションの承認ゲート
完全な実行ログ

管理者はオペレーターが使用できる連携を制限できます。

可観測性と監査

すべての連携呼び出しがログ記録されます。

どのオペレーターが要求したか
どのワークフローステップが実行したか
入力と出力（機密の場合はマスク）
成功または失敗
タイムスタンプ

デバッグ、コンプライアンス、コスト追跡をサポートします。

ベストプラクティス

安全な設計

必要最小限の権限を付与する
テストと本番の連携を分離する
破壊的アクションには人間の承認を要求する

信頼性のある設計

レート制限を明示的に処理する
可能な限りリクエストをバッチ化する
早期に失敗を監視する

スケールを意識した設計

利用可能な場合は組み込み連携を優先する
ワークフロー横断でツールを再利用する
使用パターンを経時的に監視する

対象者

ビジネスユーザー

日常ツールを接続する
コードを書かずに作業を自動化する

運用・IT チーム

アクセスを統制する
連携を標準化する

開発者

api で supervity を拡張する
オペレーター機能をシステムに組み込む

次のステップ

実行における連携 → ワークフローの解説
意思決定の理解 → オペレーターの理解
カスタムツールの登録 → ツールと外部 API
プログラムからトリガー → API リファレンス

連携により、Supervity はオペレーター駆動作業のための 接続された実行層 となります。