Skip to main content

Microsoft Teams via Webhook

This Integration is part of the Microsoft Teams Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.2.0 and later.

Integration for sending notifications to a Microsoft Teams channel via workflow. This integration was integrated and tested with version 6.8 of Microsoft Teams via Webhook

Configure Microsoft Teams via Webhook on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.
  2. Search for Microsoft Teams via Webhook.
  3. Click Add instance to create and configure a new integration instance.
  4. Click Test to validate the URLs, token, and connection.
ParameterDescriptionRequired
Microsoft workflow URLThe workflow URL in the Teams ChannelTrue
Trust any certificate (not secure)False
Use system proxy settingsFalse

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

ms-teams-message#


Send a message to Microsoft Teams via Incoming Webhook.

Base Command#

ms-teams-message

Input#

Argument NameDescriptionRequired
messageThe message to send. For example: "This is a message from Cortex XSOAR,". Default is None.Optional
team_webhookThe alternative webhook for a different team. If not defined, the integration's default webhook is used.Optional
alternative_urlThe alternative URL to send in place of the link to the Cortex XSOAR Investigation.Optional
url_titleThe title for the link. Defaults to "Cortex XSOAR URL". Default is Cortex XSOAR URL.Optional
adaptive_cards_formatWhether the adaptive card format be used or a single text message.Optional
overwrite_adaptive_card_jsonJSON object used to overwrite the default adaptive card JSON.Optional

Context Output#

There is no context output for this command.

Troubleshooting#

By default the message is being sent with a message template: X Used a Workflow template to send this card. In order to eliminate this line you can use the following approach:

  1. Navigate to Microsoft’s Power Automate portal and sign into your Microsoft Teams account where you’ve previously set up the Flow.
  2. Click My flows from the left side menu.
  3. Click the newly created Flow to open its details page.
  4. On the Flow’s details page, click Save As.
  5. Give your new Flow a name and click **Save"".
  6. Navigate back to My flows from the left side menu.
  7. Find the copy Flow and click its name to access its details page.
  8. On the Flow’s details page, click Turn On.
  9. In order to find the new URL link, navigate to the Edit tab on the Flow’s details page.
  10. Click the action task and copy the HTTP URL.
  11. Configure an instance of the integration and add the copied Workflow URL for the Teams channel.