IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Microsoft Teams connector and action
editMicrosoft Teams connector and action
editThe Microsoft Teams connector uses Incoming Webhooks.
Connector configuration
editMicrosoft Teams connectors have the following configuration properties.
- Name
- The name of the connector. The name is used to identify a connector in the management UI connector listing, or in the connector list when configuring an action.
- Webhook URL
-
The URL of the incoming webhook. See Add Incoming Webhooks for instructions on generating this URL. If you are using the
xpack.actions.allowedHosts
setting, make sure the hostname is added to the allowed hosts.
Preconfigured connector type
editmy-teams: name: preconfigured-teams-connector-type actionTypeId: .teams secrets: webhookUrl: 'https://outlook.office.com/webhook/abcd@0123456/IncomingWebhook/abcdefgh/ijklmnopqrstuvwxyz'
Secrets defines sensitive information for the connector type.
-
webhookUrl
- A string that corresponds to Webhook URL.
Define connector in Stack Management
editDefine Teams connector properties.
Test Teams action parameters.
Action configuration
editMicrosoft Teams actions have the following properties.
- Message
-
The message text, converted to the
text
field in the Webhook JSON payload. Currently only the text field is supported. Markdown, images, and other advanced formatting are not yet supported.
Configure a Microsoft Teams account
editYou need a Microsoft Teams webhook URL to configure a Microsoft Teams action. To create a webhook URL, add the Incoming Webhook App through the Microsoft Teams console:
- Log in to teams.microsoft.com as a team administrator.
- Navigate to the Apps directory, search for and select the Incoming Webhook app.
- Choose Add to team and select a team and channel for the app.
-
Enter a name for your webhook and (optionally) upload a custom icon.
- Click Create.
-
Copy the generated webhook URL so you can paste it into your Teams connector form.