Teams

Teams enables the communications via Teams Chat, plus Presence management

These are the scopes needed to work with the Teams classes.

Raw Scope	Included in Scope Helper	Description
Channel.ReadBasic.All	—	To read basic channel information
ChannelMessage.Read.All	—	To read channel messages
ChannelMessage.Send	—	To send messages to a channel
Chat.Read	—	To read users chat
Chat.ReadWrite	—	To read users chat and send chat messages
Presence.Read	presence	To read users presence status
Presence.Read.All	—	To read any users presence status
Presence.ReadWrite	—	To update users presence status
Team.ReadBasic.All	—	To read only the basic properties for all my teams
User.ReadBasic.All	users	To only read basic properties from users of my organization (User.Read.All requires administrator consent)

Presence

Assuming an authenticated account.

# Retrieve logged-in user's presence
from O365 import Account
account = Account(('app_id', 'app_pw'))
teams = account.teams()
presence = teams.get_my_presence()

# Retrieve another user's presence
user = account.directory().get_user("john@doe.com")
presence2 = teams.get_user_presence(user.object_id)

To set a users status or preferred status:

# Set user's presence
from O365.teams import Activity, Availability, PreferredActivity, PreferredAvailability

status = teams.set_my_presence(CLIENT_ID, Availability.BUSY, Activity.INACALL, "1H")

# or set User's preferred presence (which is more likely the one you want)

status = teams.set_my_user_preferred_presence(PreferredAvailability.OFFLINE, PreferredActivity.OFFWORK, "1H")

Chat

Assuming an authenticated account.

# Retrieve logged-in user's chats
from O365 import Account
account = Account(('app_id', 'app_pw'))
teams = account.teams()
chats = teams.get_my_chats()

# Then to retrieve chat messages and chat members
for chat in chats:
    if chat.chat_type != "unknownFutureValue":
        message = chat.get_messages(limit=10)
        memberlist = chat.get_members()


# And to send a chat message

chat.send_message(content="Hello team!", content_type="text")

Common commands for Chat include .get_member() and .get_message()

Team

Assuming an authenticated account.

# Retrieve logged-in user's teams
from O365 import Account
account = Account(('app_id', 'app_pw'))
teams = account.teams()
my_teams = teams.get_my_teams()

# Then to retrieve team channels and messages
for team in my_teams:
    channels = team.get_channels()
    for channel in channels:
        messages = channel.get_messages(limit=10)
        for channelmessage in messages:
            print(channelmessage)


# To send a message to a team channel
channel.send_message("Hello team")

# To send a reply to a message
channelmessage.send_message("Hello team leader")

Common commands for Teams include .create_channel(), .get_apps_in_channel() and .get_channel()

Common commands for Team include .get_channel()

Common commands for Channel include .get_message()

Common commands for ChannelMessage include .get_replies() and .get_reply()