goteams

A quick utility for common administrative functions in MS teams.

Note: This utility depends on github.com/yaegashi/msgraph.go for connecting to the MS graph API

Introduction

To start using the module, create a new teams client

import "github.com/micaiahwallace/goteams"

const (
  tenantId = "XXXX"
  clientId = "XXXX"
  clientSecret = "XXXX"
)

func main() {

  // Create new client
  client := goteams.New(tenantID, clientID, clientSecret)
}

then you can use any of the commands currently added.

Available Commands

// Install an app on a team
func (client *TeamsClient) InstallTeamsApp(teamId, appId string) error

// Install an app on a team if it doesn't exist
func (client *TeamsClient) InstallNewTeamsApp(teamId, appId string) error

// Install app on list of teams (teams must be an msgraph.Team struct with an ID set)
// any installation errors will be sent through the returned error chan
func (client *TeamsClient) InstallNewAppOnTeams(teams []msgraph.Team, appId string) chan error

// Check if an app is installed on a team
func (client *TeamsClient) IsAppInstalled(teamId, appId string) (bool, error)

// Get a list of installed apps for a team
func (client *TeamsClient) GetTeamsApps(teamId string) ([]msgraph.TeamsAppInstallation, error)

// Get a list of all team enabled groups
func (client *TeamsClient) GetTeams() ([]msgraph.Group, error)

Examples

The examples live in the cmd directory and can be installed by name via go get github.com/micaiahwallace/goteams/cmd/cli-name. For these examples to connect to you Microsoft tenant, you must first register a new application in the Microsoft Azure portal with this link. Once the app registration is created, you can then continue to add the desired permissions from the "API permissions" menu and create your client secret in the "Certificates & secrets" menu.

Install teams app on all teams (cmd/install-app-on-teams)

This example installs a given app by ID to every team in an organization that doesn't have it already installed.

$ install-app-on-teams -tenant $tenantId -client $clientId -secret $clientSecret -app $appId

Command usage:

usage: install-app-on-teams
  -app string
        Teams app ID
  -client string
        MS app client ID
  -secret string
        MS app client secret
  -tenant string
        MS tenant ID