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

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

  1. 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>

  2. Navigate to the channel you want the webhooks to be triggered from in MSTeams, manage the channel and click on Apps.

  3. Click on Create an outgoing webhook, and provide the following information. Give a name, the callback URL, and a short description and press Create.

MSTeams webhook

  1. Copy the Secret key provided by teams as shown below and click on save.

MSTeams inbound trigger

  1. Provide the security permissions for the webhook user on the Trigger (right click the trigger, security settings).

MSTeams inbound permissions