Add integration for Slack or Teams

This page provides detailed instructions on how to set up webhook subscriptions in AGILITY to send notifications to Slack and Microsoft Teams. Follow these steps to configure your webhooks.


Prerequisites

  • Access to AGILITY with permissions to set up webhooks.

  • Administrative permissions to Slack or Microsoft Teams where you want to send notifications.

  • Basic familiarity with webhook setup and configuration in AGILITY (as described here).

Configure AGILITY webhook for Slack

Generate Webhook URL in Slack

  1. Create a Slack App:

    • Navigate to Slack API.

    • Select Create New App.

    • Enter an app name and select the workspace where you want to send notifications.

image-20240709-014912.png
  1. Enable Incoming Webhooks:

    • In your Slack app settings, navigate to Incoming Webhooks.

    • Turn on Activate Incoming Webhooks.

image-20240709-015050.png
  1. Create a Webhook URL:

    • Select Add New Webhook to Workspace.

    • Select the channel where you want to post messages.

    • Select Allow to generate a webhook URL.

  1. Copy the Webhook URL:

    • Copy the generated webhook URL for use in AGILITY.

Configure the webhook in AGILITY

  1. Open AGILITY and log in with necessary permissions.

  2. Go to Settings > Application Settings > Webhook Configuration.

  1. Select New Endpoint.

    • Enter your details:

      • Endpoint URL: Paste the Slack webhook URL copied earlier.

      • Description: Provide a description (e.g., Slack Notifications).

      • Subscription Events: Select the events you want to monitor (e.g., Analysis Done, Positive Feedback, Negative Feedback).

      • Notification Type: Select Slack.

    • Select Send Test to verify that the endpoint is working.

    • Once verified, select Save & Close.

Enable the webhook

Enable the new Slack webhook in the Webhook System Subscriptions List to activate the webhook subscription.

 


Configure AGILITY webhook for Microsoft Teams

Generate webhook URL in Microsoft Teams

Follow instructions as described in https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook?tabs=newteams%2Cdotnet

  1. Create a Webhook Connector:

    • Open the Microsoft Teams application.

    • Navigate to the channel where you want to receive notifications.

    • Click on ... (More options) next to the channel name.

    • Select Connectors.

  2. Add Incoming Webhook:

    • Under Incoming Webhook and select Configure.

    • Enter a name for the webhook and upload an image if desired.

    • Select Create.

  3. Copy the Webhook URL:

    • Copy the generated webhook URL for use in AGILITY.

Configure the webhook in AGILITY

  1. Open AGILITY and log in with necessary permissions.

  2. Go to Settings > Application Settings > Webhook Configuration

  3. Select New Endpoint.

    • Enter your details:

      • Endpoint URL: Paste the Microsoft Teams webhook URL copied earlier.

      • Description: Provide a description (e.g., Teams Notifications).

      • Subscription Events: Select the events you want to monitor (e.g., Analysis Done, Positive Feedback, Negative Feedback).

      • Notification Type: Select Teams.

      • Select Send Test to verify that the endpoint is working.

      • Once verified, select Save & Close.

Enable the webhook

Enable the new Teams webhook in the Webhook System Subscriptions List to activate the webhook subscription.

Â