# Personal notifications

We know how easily notifications can become noisy. Swarmia's bot only sends you a direct message when an *action is required* in your GitHub workflow. In addition, you can customize what type of notifications you want to receive in your Swarmia profile.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2Fgit-blob-8e69cf87680ae4a775f6807f7c2ba5968c96215f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Here are some concrete examples of how the notifications look like:

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2Fgit-blob-c6df41d1cf8dc0b6306090bd5854fe9788521151%2Fimage%20(118).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2Fgit-blob-3d967ab630f98ceecb225df22b07dec713c10f65%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

To ensure a smooth notification experience and minimise context switching, we've built a bunch of features into our Slack and Microsoft Teams integrations. For instance, you won't receive notifications about bot comments, and you'll be able to reply to comments directly via the Slack or Microsoft Teams bot to avoid jumping around.

<figure><img src="https://2772466312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMa8uBmGhQgR7MTPq9yh7%2Fuploads%2Fgit-blob-436ec8b97ea7ff26ed7f9c871029446dd645e3c2%2Fresponding-in-slack.gif?alt=media" alt=""><figcaption></figcaption></figure>

You can also get a notification on failed CI checks and view the failure logs directly in Slack (Microsoft Teams coming soon).

![](https://20011531.fs1.hubspotusercontent-na1.net/hubfs/20011531/CleanShot%202024-11-06%20at%2021-43-55-png.png)

### Getting started

Navigate to [Manage notifications](https://app.swarmia.com/notifications) under your profile picture to connect your Slack or Microsoft Teams account to Swarmia. Once connected, the bot will be able to send you direct messages with the following updates:

* Pull Request review requests
* Pull Request approval & comments
* Failed CI builds
* Once a Pull Request is merged, the bot helps you to link it to a relevant Jira issue

{% hint style="info" %}
The Microsoft Teams integration does not yet support all of the notification types above, but we’re steadily expanding its capabilities.
{% endhint %}

{% hint style="info" %}
From January 22nd, 2025, onwards, the Slack connection is made automatically if the Slack account email matches the user's email in Swarmia.
{% endhint %}


---

# 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://help.swarmia.com/settings/personal/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.