Fortinet white logo
Fortinet white logo

Administration Guide

Microsoft Teams integration webhook

Microsoft Teams integration webhook

A webhook can be created to post messages and notifications to Microsoft Teams.

In this example, a configuration change triggers the FortiGate to post a message to Teams.

To create a webhook automation stitch for Teams integration in the GUI:
  1. Create an incoming webhook in Teams. See https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook for information.
  2. Go to Security Fabric > Automation.
  3. Click Create New.
  4. Enter a name for the stitch.
  5. Select the trigger Configuration Change.
  6. Select Webhook and configure the settings:

    The URI is the URL from the incoming webhook created in Teams. The HTTP body can also contain log parameters.

  7. Click OK.
To create a webhook automation stitch for Teams integration in the CLI:
  1. Create an incoming webhook in Teams. See https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook for information.
  2. Create the automation action:
    config system automation-action
        edit "send to Teams"
            set action-type webhook
            set protocol https
            set uri "outlook.office.com/webhook/XXXXXXXXXXXX/IncomingWebhook/XXXXXXXXXXXX/XXXXXXXXXXXX"
            set http-body "{ \"text\": \"<message to send>\" }"
            set port 443
            set headers "Content-type:application/json"
        next
    end
  3. Create the automation trigger:
    config system automation-trigger
        edit "Teams"
            set event-type config-change
        next
    end
  4. Create the automation stitch:
    config system automation-stitch
        edit "Teams"
            set trigger "Teams"
            set action "send to Teams"
        next
    end
Tooltip

For information about more advanced messages that can be configured and sent to the webhook, see https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using

Microsoft Teams integration webhook

Microsoft Teams integration webhook

A webhook can be created to post messages and notifications to Microsoft Teams.

In this example, a configuration change triggers the FortiGate to post a message to Teams.

To create a webhook automation stitch for Teams integration in the GUI:
  1. Create an incoming webhook in Teams. See https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook for information.
  2. Go to Security Fabric > Automation.
  3. Click Create New.
  4. Enter a name for the stitch.
  5. Select the trigger Configuration Change.
  6. Select Webhook and configure the settings:

    The URI is the URL from the incoming webhook created in Teams. The HTTP body can also contain log parameters.

  7. Click OK.
To create a webhook automation stitch for Teams integration in the CLI:
  1. Create an incoming webhook in Teams. See https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook for information.
  2. Create the automation action:
    config system automation-action
        edit "send to Teams"
            set action-type webhook
            set protocol https
            set uri "outlook.office.com/webhook/XXXXXXXXXXXX/IncomingWebhook/XXXXXXXXXXXX/XXXXXXXXXXXX"
            set http-body "{ \"text\": \"<message to send>\" }"
            set port 443
            set headers "Content-type:application/json"
        next
    end
  3. Create the automation trigger:
    config system automation-trigger
        edit "Teams"
            set event-type config-change
        next
    end
  4. Create the automation stitch:
    config system automation-stitch
        edit "Teams"
            set trigger "Teams"
            set action "send to Teams"
        next
    end
Tooltip

For information about more advanced messages that can be configured and sent to the webhook, see https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using