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. Select Configuration Change.

   3. 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 "Configuration Change"
           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
           config http-headers
               edit 1
                   set key "Content-type"
                   set value "application/json"
               next
           end
       next
   end

4. Create the automation stitch:

   config system automation-stitch
       edit "Teams"
           set trigger "Configuration Change"
           config actions
               edit 1
                   set action "send to Teams"
                   set required enable
               next
           end
       next
   end

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