Skip to main content

​
Overview

Microsoft Teams tools let you list teams and channels, send messages to channels, and create channels through Microsoft Graph.

​
Key Features

  • TEAMS_LIST_TEAMS
    • Get a list of teams the user has joined.
  • TEAMS_LIST_CHANNELS
    • Get a list of channels in a team.
  • TEAMS_SEND_MESSAGE
    • Send messages to Teams channels (plain text or HTML format).
  • TEAMS_CREATE_CHANNEL
    • Create new channels within a team (public or private).

​
Authentication

These tools require a Microsoft Graph OAuth token. Go to the Jinba secrets dashboard and connect a Microsoft account for Teams. Use the generated token in the tool config.

​
Example: List Teams, List Channels, Create Channel, and Send Message

- 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: 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 for FY2025"
    - name: is_private
      value: false

- id: send_message
  name: send_message
  tool: TEAMS_SEND_MESSAGE
  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: message
      value: "📊 Daily Report: Completed 15 tasks, 8 in progress"
    - name: message_type
      value: "text"