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 Create an incoming webhook for information.
  2. Go to Security Fabric > Automation and click Create New.
  3. Enter the stitch name.
  4. Configure the trigger:
    1. Click Add Trigger.
    2. Click Create and select Configuration Change.
    3. Enter a name (Teams).
    4. Click OK.
    5. Select the trigger in the list and click Apply.
  5. Configure the action:
    1. Click Add Action.
    2. Click Create and select Webhook.
    3. Enter the following:

      Name

      send to Teams

      Protocol

      HTTPS

      URL

      Enter the incoming webhook URL created in Teams

      Custom port

      Enable and enter 443

      Method

      POST

      HTTP body

      { \"text\": \"<message to send>\" }

      HTTP header

      Content-type : application/json

    4. Click OK.
    5. Select the action in the list and click Apply.
  6. Click OK.
To create a webhook automation stitch for Teams integration in the CLI:
  1. Create an incoming webhook in Teams. See Create an incoming webhook for information.
  2. Create the automation trigger:
    config system automation-trigger
        edit "Teams"
            set event-type config-change
        next
    end
  3. 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
  4. Create the automation stitch:
    config system automation-stitch
        edit "Teams"
            set trigger "Teams"
            config actions
                edit 1
                    set action "send to Teams"
                    set required enable
                next
            end
        next
    end
Tooltip

For information about more advanced messages that can be configured and sent to the Teams incoming webhook, see Sending messages to connectors and webhooks.

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 Create an incoming webhook for information.
  2. Go to Security Fabric > Automation and click Create New.
  3. Enter the stitch name.
  4. Configure the trigger:
    1. Click Add Trigger.
    2. Click Create and select Configuration Change.
    3. Enter a name (Teams).
    4. Click OK.
    5. Select the trigger in the list and click Apply.
  5. Configure the action:
    1. Click Add Action.
    2. Click Create and select Webhook.
    3. Enter the following:

      Name

      send to Teams

      Protocol

      HTTPS

      URL

      Enter the incoming webhook URL created in Teams

      Custom port

      Enable and enter 443

      Method

      POST

      HTTP body

      { \"text\": \"<message to send>\" }

      HTTP header

      Content-type : application/json

    4. Click OK.
    5. Select the action in the list and click Apply.
  6. Click OK.
To create a webhook automation stitch for Teams integration in the CLI:
  1. Create an incoming webhook in Teams. See Create an incoming webhook for information.
  2. Create the automation trigger:
    config system automation-trigger
        edit "Teams"
            set event-type config-change
        next
    end
  3. 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
  4. Create the automation stitch:
    config system automation-stitch
        edit "Teams"
            set trigger "Teams"
            config actions
                edit 1
                    set action "send to Teams"
                    set required enable
                next
            end
        next
    end
Tooltip

For information about more advanced messages that can be configured and sent to the Teams incoming webhook, see Sending messages to connectors and webhooks.