Skip to content

Commit

Permalink
Merge branch 'public' into patch-1
Browse files Browse the repository at this point in the history
  • Loading branch information
MicrosoftHeidi authored Jan 7, 2025
2 parents ddc56f8 + e41416c commit 75f4ed7
Show file tree
Hide file tree
Showing 17 changed files with 247 additions and 91 deletions.
89 changes: 45 additions & 44 deletions Teams/collaboration-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,111 +21,112 @@ description: Learn about how to integrate custom collaboration applications with

# Integrate custom collaboration applications with Microsoft 365

This article provides an overview of collaboration-related integrations in Microsoft 365 services. This may be of interest to independent software developers (ISVs) developing applications that integrate with Microsoft 365. Resources to learn how to create these types of integrations in any application are included in the following sections. APIs are also available to export data from Teams for use in such custom applications.
This article provides an overview of collaboration-related integrations in Microsoft 365 services. This topic may be of interest to independent software developers (ISVs) developing applications that integrate with Microsoft 365. Resources to learn how to create these types of integrations in any application are included in the following sections. APIs are also available to export data from Teams for use in such custom applications.

## Collaboration services in Microsoft 365

Microsoft 365 provides standard application programming interfaces (APIs) to all developers to enable integrations, including the functionality relied upon by Microsoft product and services for such integrations. Developers can use these APIs to create many similar experiences in their own applications.

#### User account management
### User account management

Microsoft 365 uses Microsoft Entra ID for authentication and authorization of users, including people outside your organization (B2B guests), and for maintaining user profile information.

Microsoft Entra authentication is used by Microsoft 365 web applications such as SharePoint and OneDrive, and by client applications such as Outlook and Teams. User profile information is viewable by users in a variety of places in Microsoft 365 and its associated applications.
Microsoft Entra authentication is used by Microsoft 365 web applications such as SharePoint and OneDrive, and by client applications such as Outlook and Teams. User profile information is viewable by users in various places in Microsoft 365 and its associated applications.

Microsoft documents and makes available the APIs necessary to create these experiences in your custom applications:

- [person resource type](/graph/api/resources/person)
- [List directReports](/graph/api/user-list-directreports)
- [List manager](/graph/api/user-list-manager)
- [Person resource type](/graph/api/resources/person).
- [List directReports](/graph/api/user-list-directreports).
- [List manager](/graph/api/user-list-manager).

Microsoft 365 groups are used to give groups of users access to a set of related applications, including SharePoint, Planner, and Teams. Microsoft documents and makes available the APIs necessary to create these experiences in your custom applications:

- [group resource type](/graph/api/resources/group)
- [group resource type](/graph/api/resources/group).

#### Calendar management

Microsoft 365 uses Exchange Online to manage users’ mailboxes and calendars. Mail and calendar information is made available to users in applications such as Outlook and Teams. Microsoft documents and makes available the APIs necessary to create these experiences in your custom applications:

- [calendar resource type](/graph/api/resources/calendar)
- [calendar resource type](/graph/api/resources/calendar).

#### File management

Microsoft 365 uses SharePoint and OneDrive for all file storage and sharing. The files APIs allow any application to access and modify files.

Microsoft 365 uses insights to provide lists of documents that are trending, or that a user has viewed, modified, or shared. For example, OneDrive provides this information to users. These insights are available to any application via the Office Graph Insights API.
Microsoft 365 uses insights to provide lists of documents that are trending, or that a user viewed, modified, or shared. For example, OneDrive provides this information to users. These insights are available to any application via the Office Graph Insights API.

Microsoft documents and makes available the APIs necessary to create these experiences in custom applications:

- [Working with files in Microsoft Graph](/graph/api/resources/onedrive)
- [Permission resource type](/graph/api/resources/permission)
- [officeGraphInsights resource type](/graph/api/resources/officegraphinsights)
- [Working with files in Microsoft Graph](/graph/api/resources/onedrive).
- [Permission resource type](/graph/api/resources/permission).
- [officeGraphInsights resource type](/graph/api/resources/officegraphinsights).

#### Search

Microsoft 365 uses a unified search engine to cover many different experiences from a single interface. This can be extended to other applications by using the Microsoft Search API. Microsoft documents and makes available the APIs necessary to create these experiences in your custom applications:
Microsoft 365 uses a unified search engine to cover many different experiences from a single interface. This search can be extended to other applications by using the Microsoft Search API. Microsoft documents and makes available the APIs necessary to create these experiences in your custom applications:

- [Overview of the Microsoft Search API in Microsoft Graph](/graph/search-concept-overview)
- [Overview of the Microsoft Search API in Microsoft Graph](/graph/search-concept-overview).

## Exporting Messages and other Media from Microsoft Teams

Once you’ve integrated your custom application with Microsoft 365, you can export direct messages, group messages, channel posts (including their replies), call and meeting transcripts and recordings from Teams by using published APIs.
Once you integrated your custom application with Microsoft 365, you can export direct messages, group messages, channel posts (including their replies), call and meeting transcripts and recordings from Teams by using published APIs.

> [!NOTE]
> Some of the APIs listed below are metered and have costs associated with their use.
> Some of the following APIs are metered and have costs associated with their use.
#### Direct messages, group messages, and meeting messages
### Direct messages, group messages, and meeting messages

Teams includes direct messages (1-on-1 chats), group chats, and chats associated with meetings. Messages in Teams may contain pain text, rich HTML, images, links, etc. Microsoft documents and makes available the APIs necessary to export this data out of Microsoft Teams:
Teams includes direct messages (one-to-one chats), group chats, and chats associated with meetings. Messages in Teams may contain plain text, rich HTML, images, links, etc. Microsoft documents and makes available the APIs necessary to export this data out of Microsoft Teams:

- [List Chats](/graph/api/chat-list)
- [Get Chat](/graph/api/chat-get)
- [List members of a Chat](/graph/api/chat-list-members)
- [Get chatMessage in a channel or chat](/graph/api/chatmessage-get)
- [chats: getAllMessages](/graph/api/chats-getallmessages)
- [List Chats](/graph/api/chat-list).
- [Get Chat](/graph/api/chat-get).
- [List members of a Chat](/graph/api/chat-list-members).
- [Get chatMessage in a channel or chat](/graph/api/chatmessage-get).
- [chats: getAllMessages](/graph/api/chats-getallmessages).

#### Channel posts

Channel posts, also known as threaded conversations, are conversations that occur in a Teams channel. Microsoft documents and makes available the APIs necessary to export this data out of Teams:

- [List joinedTeams](/graph/api/user-list-joinedteams)
- [List teams](/graph/api/teams-list)
- [List Channels](/graph/api/channel-list)
- [List allChannels](/graph/api/team-list-allchannels)
- [Get Channel](/graph/api/channel-get)
- [List members of a channel](/graph/api/channel-list-members)
- [Get chatMessage in a channel or chat](/graph/api/chatmessage-get)
- [channel: getAllMessages](/graph/api/channel-getallmessages)
- [List joinedTeams](/graph/api/user-list-joinedteams).
- [List teams](/graph/api/teams-list).
- [List Channels](/graph/api/channel-list).
- [List allChannels](/graph/api/team-list-allchannels).
- [Get Channel](/graph/api/channel-get).
- [List members of a channel](/graph/api/channel-list-members).
- [Get chatMessage in a channel or chat](/graph/api/chatmessage-get).
- [channel: getAllMessages](/graph/api/channel-getallmessages).

#### Meeting recordings and transcripts

Recordings of Teams meetings and calls are stored in OneDrive or SharePoint. Microsoft documents and makes available the APIs necessary to export this data out of Teams:

- [List recordings](/graph/api/onlinemeeting-list-recordings)
- [Get callRecording](/graph/api/callrecording-get)
- [onlineMeeting: getAllRecordings](/graph/api/onlinemeeting-getallrecordings)
- [List recordings](/graph/api/onlinemeeting-list-recordings).
- [Get callRecording](/graph/api/callrecording-get).
- [onlineMeeting: getAllRecordings](/graph/api/onlinemeeting-getallrecordings).

> [!NOTE]
> The APIs to list and download call/meeting recordings are currently in beta.
Transcripts of Teams meetings and calls are stored in OneDrive and SharePoint. Microsoft documents and makes available the APIs necessary to export this data out of Teams:

- [List callTranscripts](/microsoftteams/platform/graph-api/meeting-transcripts/api-transcripts#list-calltranscripts)
- [Get callTranscript](/microsoftteams/platform/graph-api/meeting-transcripts/api-transcripts#get-calltranscript)
- [Get callTranscript content](/microsoftteams/platform/graph-api/meeting-transcripts/api-transcripts#get-calltranscript-content)
- [List callTranscripts](/microsoftteams/platform/graph-api/meeting-transcripts/api-transcripts#list-calltranscripts).
- [Get callTranscript](/microsoftteams/platform/graph-api/meeting-transcripts/api-transcripts#get-calltranscript).
- [Get callTranscript content](/microsoftteams/platform/graph-api/meeting-transcripts/api-transcripts#get-calltranscript-content).

You can use the following APIs to get Teams meeting recordings and transcripts:

- [List available drives](/onedrive/developer/rest-api/api/drive_list)
- [Get Drive](/onedrive/developer/rest-api/api/drive_get)
- [List items shared with the signed-in user](/onedrive/developer/rest-api/api/drive_sharedwithme)
- [Download the contents of a DriveItem](/onedrive/developer/rest-api/api/driveitem_get_content)
- [List available drives](/onedrive/developer/rest-api/api/drive_list).
- [Get Drive](/onedrive/developer/rest-api/api/drive_get).
- [List items shared with the signed-in user](/onedrive/developer/rest-api/api/drive_sharedwithme).
- [Download the contents of a DriveItem](/onedrive/developer/rest-api/api/driveitem_get_content).

## Support

As you start working with Microsoft Graph, check out these references to get started:

- [Get started with Microsoft Graph Toolkit](/graph/toolkit/get-started/overview)
- [Best practices for working with Microsoft Graph](/graph/best-practices-concept)
- [Get started with Microsoft Graph Toolkit](/graph/toolkit/get-started/overview).
- [Best practices for working with Microsoft Graph](/graph/best-practices-concept).
- [Export options for switching from Microsoft Teams](migration-from-teams.md).

Developers who are working with and implementing the scenarios described in this article can obtain assistance from Microsoft and its engineers, including managed technical support, by emailing [[email protected]](mailto:[email protected]).
Developers and admins who are working with and implementing the scenarios described in this article can obtain assistance from Microsoft and its engineers, including managed technical support, by emailing [[email protected]](mailto:[email protected]).
4 changes: 4 additions & 0 deletions Teams/devices/check-in-and-auto-release.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,10 @@ To turn on check-in notifications,

**Answer:** No, this feature is only available for room mailboxes created in Exchange Online after Teams app 1449/1.0.97.2024061108. To learn more about how to manage room mailboxes, see [Manage resource mailboxes in Exchange Online](/exchange/recipients-in-exchange-online/manage-resource-mailboxes).

**Question: Does 'Send check-in notification' in Teams Admin Settings and Teams Admin Center control whether a Teams chat to check-in is sent?**

**Answer:** No, this setting does not control [chat notifications](/microsoft-365/places/enable-auto-release?branch=main). This setting controls the banner(s) that appear on the front of room display. See 'Turn on check-in notifications' above for more information.

## Related topics

- [How to use Microsoft Teams panels](use-teams-panels.md)
Expand Down
48 changes: 42 additions & 6 deletions Teams/devices/cloud-intelliframe.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Cloud IntelliFrame shows the smart feed when there are nine or less people in th

:::image type="content" source="../media/video-conference.png" alt-text="Screenshot that shows how a video conference looks like." lightbox="../media/video-conference.png":::

People in the room can disable IntelliFrame by using the in-meeting settings on the console. These settings turn off Cloud IntelliFrame and switches back to standard view of the room. All online attendees would then see the standard view of the room.
People in the room can disable IntelliFrame by using the in-meeting settings on the console. These settings turn off Cloud IntelliFrame and switch back to standard view of the room. All online attendees would then see the standard view of the room.

:::image type="content" source="../media/standard-view-of-teams-room.png" alt-text="Screenshot that shows how the standard view of a Teams Room looks on a computer." lightbox="../media/standard-view-of-teams-room.png":::

Expand All @@ -60,13 +60,13 @@ The following table provides information about which client can view Cloud Intel

### Data Retention

Cloud IntelliFrame runs on Azure and is fully compliant with M365 data processing with full separation between tenant boundaries. The infrastructure of Cloud IntelliFrame is no different from the infrastructure we use to record Teams Meetings.
Cloud IntelliFrame runs on Azure and is fully compliant with Microsoft 365 data processing with full separation between organizational boundaries. The infrastructure of Cloud IntelliFrame is no different from the infrastructure we use to record Teams Meetings.

Cloud IntelliFrame does not store meeting data or any identifiable information. The only data we log is what is needed to improve the service (for example, how long did it take to switch from room view to gallery, how often does the view layout change during the meeting), and to understand how Cloud IntelliFrame was used (for example, are end-users enabling/disabling it?).
Cloud IntelliFrame doesn't store meeting data or any identifiable information. The only data we log is what is needed to improve the service (for example, how long did it take to switch from room view to gallery, how often does the view layout change during the meeting), and to understand how Cloud IntelliFrame was used (for example, are end-users enabling/disabling it?).

## Cameras enabled by default

The following camera models do not have their own built in intelligence. When deployed in Microsoft Teams Rooms on Windows with a Pro license, Teams Rooms automatically enables Cloud IntelliFrame:
The following camera models don't have their own built in intelligence. When deployed in Microsoft Teams Rooms on Windows with a Pro license, Teams Rooms automatically enables Cloud IntelliFrame:

- AVer CAM520 Pro
- AVer CAM520 Pro2
Expand Down Expand Up @@ -110,6 +110,42 @@ To switch off Cloud IntelliFrame in a room, perform the following steps:

1. Restart the console for the configuration changes to take effect.

## Override Default Settings

Admins have granular control over Cloud IntelliFrame's end-user behavior. These settings can be configured either through XML or directly from the in-room console:

#### XML Settings

|Setting|Values|Purpose|
| -------- | -------- | -------- |
| EnableCloudIntelliFrame|True / False |Enable or disable Cloud IntelliFrame for this room.|
|EnableCIFOnByDefault|True / False|Enable by default or allow room users to manually switch it on.|
|EnableCIFOnSupportedCamerasOnly|True / False|Restrict to supported cameras or allow any camera.|

#### Console Setting

To modify Cloud IntellIFrame settings via the console, navigate to **Settings > Peripherals > Cameras > Cloud intelliFrame** to:

- Enable or disable Cloud IntelliFrame

- Configure whether Cloud IntelliFrame is on by default or if in-room users can manually enable it

- Override the default setting to allow Cloud IntelliFrame to work on any camera

![Console setting: Cloud IntelliFrame is on for this room using supported camera.](media/cloud-intelliframe/on,-supported-cameras-only,-supported-camera-selected.png)

When using an unsupported camera, the console settings appear as below. Even though Cloud IntelliFrame setting is on, the experience isn't enabled for the room because it's using an unsupported camera.

![Cloud IntelliFrame disabled for unsupported camera.](media/cloud-intelliframe/on,-supported-cameras-only,-unsupported-camera-in-use.png)

Uncheck the unsupported cameras only setting to override the supported camera list and enable Cloud IntelliFrame for a room with any camera:

![Cloud intelliFrame enabled for unsupported camera via override.](media/cloud-intelliframe/on,-all-cameras,-unsupported-camera-in-use.png)

When enabling Cloud IntelliFrame on a nonsupported camera, ensure that other AI features (for example, Speaker Tracking, Grid View) are turned off, as they can interfere with Cloud IntelliFrame.

> [!IMPORTANT]
> You are responsible for compliance with local laws and regulations when you enable Cloud IntelliFrame in a particular jurisdiction, including with respect to obligations around notice, consent, and data retention. These obligations may include installing appropriate signage outside any meeting room where you enable Cloud IntelliFrame advising people about the feature.
> Cloud IntelliFrame does not have the capacity to identify particular individuals, due to the uncertainty regarding the scope of “biometrics” in the State of Illinois law; therefore, Cloud IntelliFrame is not intended for use in Illinois.
> You're responsible for compliance with local laws and regulations when you enable Cloud IntelliFrame in a particular jurisdiction, including with respect to obligations around notice, consent, and data retention. These obligations may include installing appropriate signage outside any meeting room where you enable Cloud IntelliFrame advising people about the feature.
> Cloud IntelliFrame doesn't have the capacity to identify particular individuals, due to the uncertainty regarding the scope of “biometrics” in the State of Illinois law; therefore, Cloud IntelliFrame isn't intended for use in Illinois.
> When enabling Cloud IntelliFrame on a nonsupported camera, ensure that other AI features (for example, Speaker Tracking, Grid View) are turned off, as they can interfere with Cloud IntelliFrame.
Loading

0 comments on commit 75f4ed7

Please sign in to comment.