MS Office

Overview

The io.Connect Teams Adapter is designed as a set of configurable components (Service App, Platform App, and Web Service) that allow interop-enabled apps to react to events in Microsoft Teams, query information from the Microsoft Graph API, and initiate actions in Teams using the io.Connect APIs. It also enables you to add custom elements to the Teams UI that allow the user to invoke actions within the io.Connect framework (in both the desktop and web versions of the Teams client).

The Teams Adapter solves the various architectural challenges required to work with the Microsoft Graph API reliably and at scale, to integrate with io.Connect authorization, configuration, and lifecycle, and takes care of the work required to expose the various Teams operations and data sources as io.Connect primitives in the simplest and most flexible manner, enabling you to easily plug in your apps and achieve your desired workflows.

Features

The adapter provides two types of features:

The ability for interop-enabled apps to invoke actions in Teams and query data from Teams using the Microsoft Graph API. For more details, see the Supported Functionalities section.
The ability to react to events in Teams (e.g., new messages, reactions, and more) and to custom io.Connect actions invoked from the Teams UI by initiating configurable response behaviors. These response behaviors include both io.Connect operations (invoking Interop methods, raising Intents, updating Channels and shared contexts, showing notifications, starting apps, and more), as well as operations specific to Teams. For more details, see the Reacting to Events and Custom UI Actions sections.

Supported Functionalities

The following Teams functionalities are exposed as Interop methods and Intents registered by the Teams Adapter in the io.Connect framework:

opening a Teams chat or channel on the user machine, optionally focusing a specific message;
creating a new Teams chat using a given set of users;
sending a new message to a Teams chat or channel;
sending an interactive card to a Teams chat or channel;
calling a Teams chat group;
searching through Teams chats, channels, teams, messages, and users;

For more details on the utilizing the available Teams Adapter functionalities, see the Functionalities section. For a full reference of the default Teams Adapter functionalities that can be used as Interop methods and Intents, see the Default Implementations section.

Reacting to Events

The Service App component of the Teams Adapter can be configured to react to new messages and to reactions to existing messages in some or all of the user's Teams chats and channels. Messages can be filtered based on sender, content, conversation, and more. Message details can be extracted and passed as arguments to the configured actions.

Available operations that can be performed:

raising an Intent;
invoking an Interop method;
publishing to an io.Connect Interop stream;
creating an io.Connect notification;
updating an io.Connect Channel or shared context;
any of the functionalities listed in the Supported Functionalities section.

For more details on configuring the Service App component and its functionalities, see the Configuration > Service App and Functionalities > Service App Rules sections.

Custom UI Actions

The Platform App component of the Teams Adapter provides configurable custom elements that can appear in the UI of the Teams client. This enables users to invoke functionalities directly from the Teams UI.

The following default functionalities are available:

sending messages to the io.Connect framework;
recording conversations and sending them to the io.Connect framework;
sending conversation data to the io.Connect framework;

When the user performs any of these actions, the information is sent to the user's Teams Adapter instance via the Web Service component. Configured response behaviors can then be initiated similarly to the ones described in the Reacting to Events section. The relevant data can be used as an argument for the operation.

The available operations and their UI icons and text content are configurable. This enables you to customize the existing operations or add more UI actions with various configured response behaviors.