Microsoft Teams

Microsoft Graph で Microsoft Teams を操作

​

概要

Microsoft Teams ツールでは、チーム・チャネル・チャット・チャネルメッセージ・チャットメッセージの取得、メッセージの横断検索、オンライン会議の取得、チーム・プライベート/共有チャネル・グループチャットへのメンバー追加、チャネルまたはチャット (DM) へのメッセージ送信、スレッド返信、チャネルの作成、1 対 1 またはグループチャットの作成を Microsoft Graph 経由で行えます。

​

主な機能

• TEAMS_LIST_TEAMS
  • ユーザーが参加している Teams の一覧を取得。
• TEAMS_LIST_CHANNELS
  • チーム内のチャネル一覧を取得。
• TEAMS_LIST_CHANNEL_MESSAGES
  • チャネルに投稿されたメッセージを取得。スレッド返信も含めて取得できます。
• TEAMS_LIST_CHATS
  • サインイン中のユーザーが参加しているチャット一覧を取得。
• TEAMS_LIST_CHAT_MESSAGES
  • 1 対 1 またはグループチャットに投稿されたメッセージを取得。
• TEAMS_SEARCH_MESSAGES
  • Microsoft Graph Search を使って Teams メッセージを横断検索。日時範囲の指定やページネーションにも対応。
• TEAMS_LIST_ONLINE_MEETINGS
  • join URL / video teleconference ID で Teams オンライン会議を取得、またはカレンダー期間から Teams 会議を抽出。
• TEAMS_GET_ONLINE_MEETING
  • Graph meeting ID、join URL、video teleconference ID から Teams オンライン会議を取得。
• TEAMS_ADD_CHANNEL_MEMBER
  • プライベートまたは共有チャネルにユーザーをメンバーまたは所有者として追加。
• TEAMS_ADD_TEAM_MEMBER
  • チームにユーザーをメンバーまたは所有者として追加。標準（公開）チャネルはチームメンバーシップを継承するため、こちらを使用します。
• TEAMS_ADD_CHAT_MEMBER
  • 既存のグループチャットにユーザーを追加。過去履歴の共有可否も指定できます。
• TEAMS_SEND_MESSAGE
  • Teams チャネルにメッセージを送信（プレーンテキスト/HTML 形式）。
• TEAMS_REPLY_TO_MESSAGE
  • Teams チャネルメッセージのスレッドに返信。
• TEAMS_CREATE_CHANNEL
  • チーム内に新しいチャネルを作成（公開/非公開）。
• TEAMS_CREATE_CHAT
  • 1 対 1 またはグループチャットを新規作成。サインイン中のユーザーは自動的に追加されます。
• TEAMS_SEND_CHAT_MESSAGE
  • Teams チャット (DM) にメッセージを送信。プレーンテキストと HTML に対応。

​

認証

Microsoft Graph OAuth トークンが必要です。

Jinba のシークレット設定 で Microsoft アカウント（Teams）を連携し、発行されたトークンをツールの config に指定してください。

Teams OAuth 接続では、チャネルメッセージ、チャットメッセージ、チャネル、チャネルメンバー、チームメンバー、チャットメンバー、チーム、メッセージ送信、トークン更新に必要な Microsoft Graph scope を要求します。これらの scope 追加前に作成済みの Teams シークレットは、再連携が必要です。チームメンバー追加（TeamMember.ReadWrite.All）やチャットメンバー追加（ChatMember.ReadWrite）は、テナントによっては管理者同意が必要です。

​

例：Teams 一覧取得、プライベートチャネル作成、メンバー追加、メッセージ送信

- id: list_teams
  name: list_teams
  tool: TEAMS_LIST_TEAMS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input: []

- id: list_channels
  name: list_channels
  tool: TEAMS_LIST_CHANNELS
  needs: ["list_teams"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"

- id: list_channel_messages
  name: list_channel_messages
  tool: TEAMS_LIST_CHANNEL_MESSAGES
  needs: ["list_teams", "list_channels"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"
    - name: channel_id
      value: "{{steps.list_channels.result.channels[0].id}}"
    - name: include_replies
      value: true

- id: list_chats
  name: list_chats
  tool: TEAMS_LIST_CHATS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input: []

- id: list_chat_messages
  name: list_chat_messages
  tool: TEAMS_LIST_CHAT_MESSAGES
  needs: ["list_chats"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: chat_id
      value: "{{steps.list_chats.result.chats[0].id}}"

- id: create_channel
  name: create_channel
  tool: TEAMS_CREATE_CHANNEL
  needs: ["list_teams"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"
    - name: channel_name
      value: "project-alpha-2025"
    - name: description
      value: "Project Alpha 2025年度のチャネル"
    - name: is_private
      value: true

- id: add_channel_member
  name: add_channel_member
  tool: TEAMS_ADD_CHANNEL_MEMBER
  needs: ["create_channel"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"
    - name: channel_id
      value: "{{steps.create_channel.result.channel_id}}"
    - name: user_id
      value: "[e-mail]"
    - name: role
      value: "member"

- id: send_message
  name: send_message
  tool: TEAMS_SEND_MESSAGE
  needs: ["add_channel_member"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"
    - name: channel_id
      value: "{{steps.create_channel.result.channel_id}}"
    - name: message
      value: "Daily Report: Completed 15 tasks, 8 in progress"
    - name: message_type
      value: "text"

​

例：1 対 1 チャット作成と DM 送信

- id: create_chat
  name: create_chat
  tool: TEAMS_CREATE_CHAT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: chat_type
      value: "oneOnOne"
    - name: member_ids
      value: "[e-mail]"

- id: send_chat_message
  name: send_chat_message
  tool: TEAMS_SEND_CHAT_MESSAGE
  needs: ["create_chat"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: chat_id
      value: "{{steps.create_chat.result.chat_id}}"
    - name: message
      value: "こんにちは！直接ご連絡させていただきます。"
    - name: message_type
      value: "text"

​

例：メッセージ検索とオンライン会議の取得

- id: search_messages
  name: search_messages
  tool: TEAMS_SEARCH_MESSAGES
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: query
      value: "project alpha status"
    - name: from
      value: "2026-07-01T00:00:00+09:00"
    - name: to
      value: "2026-07-14T00:00:00+09:00"
    - name: size
      value: 25

- id: list_online_meetings
  name: list_online_meetings
  tool: TEAMS_LIST_ONLINE_MEETINGS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    # start_datetime / end_datetime を指定すると、カレンダー期間から Teams 会議を抽出します
    - name: start_datetime
      value: "2026-07-14T00:00:00+09:00"
    - name: end_datetime
      value: "2026-07-21T00:00:00+09:00"
    - name: top
      value: 25

- id: get_online_meeting
  name: get_online_meeting
  tool: TEAMS_GET_ONLINE_MEETING
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    # meeting_id、join_web_url、video_teleconference_id のいずれかを指定します
    - name: join_web_url
      value: "https://teams.microsoft.com/l/meetup-join/..."