カスタムAPI呼び出し
このピースでできることMicrosoft 365 Copilot の接続方法ステップ 1：workrun のリダイレクト URL を確認するステップ 2：Azure で OAuth クライアントを作成するステップ 3：workrun に接続を追加するピースの設定項目1. 方法（必須）2. URL（必須）3. ヘッダー（任意）4. クエリパラメータ（任意）5. ボディタイプ（任意）6. 本文（任意）7. 応答はバイナリですか?（任意）8. 失敗時にエラーはありません（任意）9. タイムアウト（秒）（任意）10. リダイレクトをフォローする（任意）
このピースでできること
- Microsoft 365 Copilot の Microsoft Graph API に対して、任意のエンドポイントへカスタム HTTP リクエストを送信します。
- GET・POST・PATCH・PUT・DELETE などのメソッドを使って、標準アクションにない操作を柔軟に実行できます。
Microsoft 365 Copilot の接続方法
workrun と Microsoft 365 Copilot を接続するには、Microsoft Azure で作成した OAuth クライアント（クライアントID・クライアントシークレット） が必要です。
なお、このピースを利用するには Microsoft 365 Copilot ライセンス が必要です。
ステップ 1：workrun のリダイレクト URL を確認する
- workrun で Microsoft 365 Copilot のアクションをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。
ステップ 2：Azure で OAuth クライアントを作成する
- Azure ポータル にサインインします。
- 「Azure Active Directory」（Microsoft Entra ID）→ 「アプリの登録」 → 「新規登録」 をクリックします。
- アプリ名を入力し、「リダイレクト URI」 にステップ 1 でコピーした URL を貼り付けます。
- 「登録」 をクリックし、表示される 「アプリケーション（クライアント）ID」 をコピーします。
- 「証明書とシークレット」 → 「新しいクライアント シークレット」 をクリックし、シークレットを作成して 値 をコピーします。
- 「API のアクセス許可」 → 「アクセス許可の追加」 → 「Microsoft Graph」 → 「委任されたアクセス許可」 から以下のスコープを追加し、「管理者の同意を与える」 をクリックします。
- Sites.Read.All
- Mail.Read
- Files.ReadWrite.All
- People.Read.All
- OnlineMeetingTranscript.Read.All
- Chat.Read
- ChannelMessage.Read.All
- ExternalItem.Read.All
- AiEnterpriseInteraction.Read
- Files.Read.All
ステップ 3：workrun に接続を追加する
- ステップ 1 の接続画面に戻り、クライアントID と クライアントシークレット をそれぞれ貼り付けます。
- 「クラウド環境」 で使用する Microsoft クラウド環境を選択します（通常は「Commercial (Global)」を選択してください）。
- 「接続」 をクリックすると、Microsoft の認証画面が開きます。
- Microsoft アカウントにサインインし、workrun に対するアクセスを 「許可」 します。
- 画面が自動で閉じ、接続が完了します。
ピースの設定項目
1. 方法（必須）
- HTTPメソッドをドロップダウンから選択します。データを取得する場合は 、作成・送信する場合は を選びます。
2. URL（必須）
- ベースURL（）の後に続くAPIパスを入力します。例えば自分のプロフィール情報を取得する場合は と入力します。
3. ヘッダー（任意）
- 追加のHTTPヘッダーをJSON形式で入力します。認証ヘッダーは接続情報から自動的に付与されるため、入力不要です。
4. クエリパラメータ（任意）
- URLに付加するクエリパラメータをJSON形式で入力します。件数を絞り込む場合などに使用します。
5. ボディタイプ（任意）
- リクエストボディの形式を選択します。JSONデータを送信する場合は を選択します。データを送信しない場合は を選択します。
6. 本文（任意）
- リクエストボディの内容をJSON形式で入力します。POSTやPATCHリクエスト時に送信するデータを指定します。
7. 応答はバイナリですか?（任意）
- PDFや画像などのバイナリファイルをダウンロードする場合は に設定します。通常のJSONレスポンスの場合は のままにします。
8. 失敗時にエラーはありません（任意）
- にすると、APIがエラーを返してもフローが停止せず続行します。エラーを無視して処理を続けたい場合に使用します。
9. タイムアウト（秒）（任意）
- リクエストのタイムアウト時間を秒単位で入力します。応答が遅いAPIを使用する場合に延ばしてください。
10. リダイレクトをフォローする（任意）
- にすると、HTTPリダイレクト（301・302など）を自動的に追跡します。通常はそのままにしてください。