New chat component in Microsoft Graph Toolkit

Important

This component is in Preview and is subject to change. The use of these components in production applications is not supported.

Note

This component is currently only available as a React component and doesn't have a web component equivalent.

The new chat component allows user to create new 1:1 or group conversations in Microsoft Teams.

Example

The following example displays a new chat form using the mgt-new-chat component.

Properties

Attribute	Property	Description
mode	mode	Set to oneOnOne, group or auto. Default is auto.

<NewChat mode="group" />

CSS custom properties

The mgt-new-chat component doesn't define CSS custom properties.

Events

The following events are fired from the component.

Event	When is it emitted	Custom data	Cancelable	Bubbles	Works with custom template
onChatCreated	Fired when a new chat thread is created.	The chat object that was created as a Microsoft Graph chat.	No	No	No
onCancelClicked	Fired when user cancels the chat thread creation.	None	No	No	No

For more information about handling events, see events.

Templates

The mgt-new-chat component doesn't offer any template to override.

Microsoft Graph permissions

This control uses the following Microsoft Graph APIs and permissions.

Configuration	Permission	API
Default	Chat.Create, ChatMessage.Send	/chats, /chats/{id}/messages

Subcomponents

The mgt-new-chat component consists of one or more subcomponents that might require other permissions than the ones listed previously. For more information, see the documentation for each subcomponent: mgt-people-picker.

Authentication

The tasks component uses the global authentication provider described in the authentication documentation.

Cache

The mgt-new-chat component doesn't cache any data.

Localization

The mgt-new-chat component doesn't expose any localization variables.

Known issues

• The mgt-new-chat component doesn't support theming and won't respect browsers preferences.