# Notifications

## How to Integrate

Navigate to the Settings > Integrations page and select the **Add Integration** button in the upper righthand corner of the screen. Click **Add Integration** and select **Notifications** from the list.

Sedai integrates with the following notification providers to support your internal response workflows for recommended actions and insights:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Asana</strong></td><td><a href="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2FxxdoEB2n3BXEAkQOYJbY%2FAsana.png?alt=media&#x26;token=7dbfcdbf-1de4-4911-93d1-c8788a3df388">Asana.png</a></td><td><a href="#asana">#asana</a></td></tr><tr><td><strong>Datadog</strong></td><td><a href="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2FTZmYpbN8UD2SoGOw0fOn%2FDatadog.png?alt=media&#x26;token=f7b0503d-03f7-40be-857b-023d2cce782f">Datadog.png</a></td><td><a href="#datadog">#datadog</a></td></tr><tr><td><strong>Jira</strong></td><td><a href="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2FHnAX6Us7SsWTjrQ6s0PT%2FJira.png?alt=media&#x26;token=2a42bf26-f2bb-40a5-86f9-835c136f6c64">Jira.png</a></td><td><a href="#jira">#jira</a></td></tr><tr><td><strong>Microsoft Teams</strong></td><td><a href="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2Feju6uLi8APpS3FWZ0SfK%2FTeams.png?alt=media&#x26;token=6eddaf7d-8fae-4e1c-b117-46db1ad3d966">Teams.png</a></td><td><a href="#microsoft-teams">#microsoft-teams</a></td></tr><tr><td><strong>PagerDuty</strong></td><td><a href="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2FAkhAmySle8IFPgsAJ2AK%2FPageDuty.png?alt=media&#x26;token=383b8c8b-469a-4a23-8d7f-a1baa9e6526e">PageDuty.png</a></td><td><a href="#pagerduty">#pagerduty</a></td></tr><tr><td><strong>Slack</strong></td><td><a href="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2F6y0bWfTygHabkxR83jFQ%2Fslack.png?alt=media&#x26;token=8a2f33c8-fba6-4202-8033-238e2389384f">slack.png</a></td><td><a href="#slack">#slack</a></td></tr></tbody></table>

Sedai also supports custom webhooks and email. For email integrations, we recommend coordinating with your IT team to obtain an email account for Sedai to use as a sender address. Notifications can be sent to a preconfigured target email address or a group email ID.

{% hint style="info" %}
You can add multiple integrations for the same provider (such as per project or channel).  Give your integration a unique nickname to help identify the difference between integrations from the same provider. This also helps in case you choose to send specific types of alerts or map groups of resources to a single integration.
{% endhint %}

### Resource Mapping

You can choose to receive alerts for all resources connected to Sedai or map specific [groups](https://docs.sedai.io/get-started/platform/settings/groups) of resources to an integration.

{% hint style="info" %}
We recommend creating integrations based on individual teams so you can map the group(s) of resources teams are responsible for managing (and avoid noisy alerts).
{% endhint %}

### How to Subscribe

After you create a notification integration, navigate to Settings > Notifications to subscribe to alerts.&#x20;

Select a notification category to view a list of alerts. From the dropdown, click the integration you want to connect to the alert.&#x20;

***

## Asana

<table data-header-hidden><thead><tr><th width="238"></th><th></th></tr></thead><tbody><tr><td><strong>Workspace</strong></td><td>To find your ID, navigate to your Account Settings within Asana.</td></tr><tr><td><strong>Project</strong></td><td>From the home page, look for the <strong>Projects</strong> module or find a list of projects in the side navigation. You can add more than one project within a single integration, but we recommend identifying one project per integration.</td></tr><tr><td><strong>Token</strong></td><td>To generate a personal access token, go to the <a href="https://app.asana.com/0/my-apps">developer console</a> within your account profile. Visit <a href="https://developers.asana.com/docs/personal-access-token">Asana Docs</a> to learn more about creating and managing tokens.</td></tr></tbody></table>

{% hint style="warning" %}
**Note:** Issues will not be updated after they are generated.
{% endhint %}

***

## Datadog

To send notifications to Datadog, you will need to generate an API key. From your Datadog account, go to **Organization Settings → Access → API Keys**. Select **New Key** and copy the key.

***

## Jira

{% hint style="info" %}
Adding Jira as a **notification** integration will automatically create issues but will not update their statuses. If you prefer Sedai to automatically create Jira issues as well as update their statuses, add a [Jira ticketing integration](https://docs.sedai.io/get-started/platform/ticketing-and-service-management#jira) instead.
{% endhint %}

<table data-header-hidden><thead><tr><th width="186"></th><th></th></tr></thead><tbody><tr><td><strong>Project Key</strong></td><td>This identifies the project Sedai issues will be created under. To find your Key, navigate to your preferred project within your Jira dashboard and select the Project Settings.</td></tr><tr><td><strong>URL</strong></td><td>This is your organization's unique Jira URL (for example, https://<mark style="background-color:purple;"><strong>enter-your-domain</strong></mark>.atlassian.net)</td></tr><tr><td><strong>User Email</strong></td><td>To generate a token, go to the <a href="https://id.atlassian.com/manage-profile/security/api-tokens">security section</a> within your account profile. Visit <a href="https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/">Atlassian Support</a> to learn more about managing your API tokens.</td></tr><tr><td><strong>Token</strong></td><td>This can be for any user associated with the Jira account.</td></tr></tbody></table>

***

## Microsoft Teams

To receive Sedai notifications in your organization's workspace, you will need to setup a Webhook. Learn more:

{% embed url="<https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook?tabs=dotnet>" %}

Webhooks represent a single destination within Microsoft Teams, but you can create multiple webhooks based on your team's communication needs. You can create a webhook for direct messages or channels. &#x20;

{% hint style="info" %}
You can send alerts to existing channels in your workspace, but we recommend creating specific channels for Sedai activity only that teams can subscribe to (for example, you can create a channel to alert developers about new release scorecards, and another channel for SRE team members to monitor critical activity in Sedai).
{% endhint %}

***

## PagerDuty

You can optionally integrate PagerDuty manually through Sedai, or log in to your PagerDuty account directly to automatically connect both platforms.

If you choose to integrate manually, you will need the following information to integrate PagerDuty within Sedai:

* Service Name
* Integration URL
* Integration Key

To find this information, go to your PagerDuty account and navigate to the [Service Directory](https://support.pagerduty.com/docs/service-directory) from the Services menu. Choose to add an integration to one of your existing services or a new service:

{% tabs %}
{% tab title="Add to Existing Service" %}

1. Select the service you want to add Sedai to, then select the Integrations tab and click **New Integration**.
2. Name the integration using the format **Monitoring tool: Service name**.
3. From the **Integration Type** menu, select Sedai.
4. Select **Add Integration** to save; the screen will redirect to the Integrations tab for the service.
5. PagerDuty will generate an **Integration Key** and **Integration URL** for the new service.&#x20;
   {% endtab %}

{% tab title="Add to New Service" %}

1. Reference PagerDuty’s documentation to [create a new service](https://support.pagerduty.com/docs/services-and-integrations#section-create-a-new-service).
2. Select Sedai as the **Integration Type**.&#x20;
3. Select **Add Integration** to save; the screen will redirect to the Integrations tab for the service.
4. PagerDuty will generate an **Integration Key** and **Integration URL** for the new service. Both of these will be needed in the next section to integrate PagerDuty in Sedai.
   {% endtab %}
   {% endtabs %}

New service events will be created for each subscribed alert.

{% embed url="<https://support.pagerduty.com/docs/alerts>" %}

{% embed url="<https://support.pagerduty.com/docs/incidents>" %}

{% embed url="<https://support.pagerduty.com/docs/services-and-integrations#section-configuring-services-and-integrations>" %}

{% embed url="<https://support.pagerduty.com/docs/api-access-keys#section-events-api-keys>" %}

***

## Slack

{% hint style="info" %}
Sedai currently integrates with Slack via webhooks. Support for a Slack App is coming soon.
{% endhint %}

You will need to [setup a Webhook URL](#how-to-create-a-slack-webhook-url) to reference when adding Slack as an integration within Sedai.&#x20;

Webhooks represent a single destination within Slack, but you can create multiple webhooks based on your team's communication needs. You can create a webhook for direct messages or channels. &#x20;

{% hint style="info" %}
You can send alerts to existing channels in your workspace, but we recommend creating specific channels for Sedai activity only that teams can subscribe to (for example, you can create a channel to alert developers about new release scorecards, and another channel for SRE team members to monitor critical activity in Sedai).
{% endhint %}

#### How to create a Slack Webhook URL

You will need to create a private Slack App and select which channels or individuals are alerted from it.

To add an App to your Slack workspace, log in to your account and go to the Slack API documentation page; select **Create an App** and choose **From scratch.**

{% embed url="<https://api.slack.com/apps?new_app=1>" %}
View Slack's API documentation to create an App
{% endembed %}

You can name the App however you like, but we recommend including Sedai and referencing the types of alerts that you intend to send to it (such as "Sedai Release Intelligence").

<figure><img src="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2FrFGcYYm1WmZ1x4BXDnVE%2Fimage.png?alt=media&#x26;token=894783ac-8045-47bf-8137-c1c34baf3a94" alt=""><figcaption></figcaption></figure>

The page will redirect to your new App's home page. From the lefthand panel, find the Features section and select **Incoming Webhooks**. Turn the toggle on to activate the feature, then select the **Add New Webhook to Workspace** button near the bottom.&#x20;

<figure><img src="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2FGU6HdlwpQcWM9POXlGKV%2Fimage%20(1).png?alt=media&#x26;token=f2a093b4-7a5c-47b9-bf71-56c5ddab7b15" alt=""><figcaption></figcaption></figure>

You will be prompted to select a destination in your Slack workspace — this could be any public, private, or external channel, or a Direct Message to an individual. Once you choose your destination, select **Allow**. The App home page will refresh to display the new Webhook URL near the bottom of the screen. Select **Copy;** this URL can now be used to [setup your Slack integration in Sedai](https://docs.sedai.io/sedai/sedai-user-guide/controls/integrations/notifications-integrations/slack#undefined).

<figure><img src="https://718462512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrF70A0mjyczIwzn72g6Y%2Fuploads%2FNxZ1QuRXm8z8Yjh2oqmm%2Fimage%20(2).png?alt=media&#x26;token=5807b94c-61a2-4e7b-92e6-7e42a2403d98" alt=""><figcaption><p>Copy the URL and go to Settings > Integrations in Sedai to connect Slack.</p></figcaption></figure>

{% embed url="<https://api.slack.com/messaging/webhooks>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sedai.io/get-started/platform/integrations/notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.