Microsoft Teams integration guide

Overview

The Microsoft Teams integration allows you to:

• Receive notifications when new cases are created
• Get alerts when case data is added by human users
• Display rich, formatted cards with case details
• Provide direct links to view cases in Cydarm

Step 1: Configure Microsoft Teams webhook

Set up the incoming webhook

1. Open Microsoft Teams and navigate to the channel where you want to receive Cydarm alerts.
2. Click the more options (⋯) next to the channel name, then Manage channel
3. Find the Connectors section from the dropdown menu and click Edit
4. Search for Incoming Webhook and click Configure.
5. Name your webhook (e.g., "Cydarm Case Alerts").
6. Click Create
7. Important - copy the generated webhook URL as you will need this for the next step (Cydarm platform configuration)

Step 2: Create connector in Cydarm

Add the Microsoft Teams connector

1. Log into your Cydarm platform
2. Click Settings under the more options (⋯) in the right corner of the Cydarm navigation menu.
3. Click on Connectors in the left side menu.
4. Click on Create Connector and add the following information to the various fields:
   • Connector Type: Generic Webhook Sender
   • Name: Microsoft Teams
   • Description: Send case updates and notifications to team channels
   • Base URL: Paste the Teams webhook URL you copied in Step 1
   • API Key: Leave blank
   • ✓ Activate Connector 
   • Click Next

Step 3: Set up triggered automation

1. Create the case creation trigger

   • In Settings, navigate to the Triggered Automations in Cydarm settings 
   • Click on Create Triggered Automation in the top right corner
   • Select trigger: Case created
   • Name: Microsoft Teams Alerts (add as needed)
   • Description: Send case notification to teams (add as needed)
   • Click Next

2. Configure the action

   • Condition: Leave blank
   • Select action: Send Generic Webhook
   • Select connector: Microsoft Teams
   • ✓ Activate automation on Submit
   • Click Next

3. Configure the message template

   • URL Path: Leave blank
   • HTTP Method: POST
   • HTTP Content-Type: application/json
   • Headers: Leave blank
   • ✓ Process response in Cydarm 
   • Click Submit

4. Request template

   • Copy and paste this JSON (replace “your-cydarm-domain” with the domain name of your Cydarm instance):

{

  "type": "message",

  "attachments": [

    {

      "contentType": "application/vnd.microsoft.card.adaptive",

      "content": {

        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",

        "type": "AdaptiveCard",

        "version": "1.2",

        "body": [

          {

            "type": "TextBlock",

            "text": "New Case Created",

            "size": "Large",

            "weight": "Bolder",

            "horizontalAlignment": "Center"

          },

          {

            "type": "TextBlock",

            "text": "**Case ID:** ",

            "wrap": true

          },

          {

            "type": "TextBlock",

            "text": "**Created by:** ",

            "wrap": true

          },

          {

            "type": "TextBlock",

            "text": "**Description:** ",

            "wrap": true

          },

          {

            "type": "TextBlock",

            "text": "**Status:** ",

            "wrap": true

          },

          {

            "type": "TextBlock",
            "text": "[View in Cydarm](https://your-cydarm-domain.cydarm.com/caseview/)",
            "wrap": true
          }
        ]
      }
    }
  ]
}

5. Response template:

• Do not check the Process response in Cydarm box

Step 4: Testing the integration

To test the setup is working correctly:

1. Go to Cydarm
2. Click Create a case
3. Fill in the case details and click Submit
4. Check your Microsoft Teams channel for the notification

What you will see:

When a new case is created, your Teams channel will receive a formatted card showing:

• Case ID
• Creator name
• Case description
• Current status
• Direct link to view the case in Cydarm

Troubleshooting

Notifications not appearing:

• Verify the webhook URL is correct
• Check that automations are activated
• Ensure the connector is properly configured

Formatting issues:

• Verify JSON syntax in request templates
• Check that all template variables are properly formatted