Microsoft Teams
Microsoft Teams integration allowing inbound and outbound message exchange. Due to Microsoft decommissioning the teams webhooks. The teams integration has been adjusted to allow a teams-bot. For more detail, check the Guide on how to configure a custom teams-app to allow the interaction between A-Ops and Teams.
Guide for creating and configuring an A-Ops teams bot: Guide Page
Triggers
MSTeams Incoming Message
Inbound webhook to read messages coming from the configured teams channel.
Input
Name | Description | Type | Required | Syntax |
---|---|---|---|---|
token | input | False | False | |
securityToken | password-input | False | False |
Actions
MSTeams Post Message
Post a message to a configured teams channel.
Input
Name | Description | Type | Required | Syntax |
---|---|---|---|---|
teamsWebhookUrl | input | False | False | |
message | input | False | False |
Output
Name | Description | Type | always_present | values |
---|---|---|---|---|
result | Returns True when successful. | boolean | True | {"True": {"description": "Successful."}, "False": {"description": "Failure."}} |
rc | Returns the exit code for the action. | number | True | {"0": {"description": "Successful."}} |
API
POST /integration/msteams/[accessKey]/[token]
Args
Returns
Examples
Configure inbound messages from MSTeams to A-Ops
Example use of the Trigger MSTeams Incoming Message
Requirements
- A-Ops webhook user having the role: cluster.messages.trigger
- A-Ops webhook user API secret key
- An Outbound Webhook app configured on a teams channel, and the secret key provided.
Walkthrough
-
Construct Callback URL:
https://prod-eu-west-1.a-ops.cloud/integration/msteams/<API Secret Key of webhook user>/<token within the inbound webhook trigger>
-
Navigate to the channel you want the webhooks to be triggered from in MSTeams, manage the channel and click on Apps.
-
Click on Create an outgoing webhook, and provide the following information. Give a name, the callback URL, and a short description and press Create.
- Copy the Secret key provided by teams as shown below and click on save.
- Provide the security permissions for the webhook user on the Trigger (right click the trigger, security settings).