> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tweet-catcher.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> Send task events to Discord, Telegram, a custom webhook, or the WebSocket

Each task delivers its events to one destination. Pick it in the **Notifications** section when you [create or edit a task](https://docs.tweet-catcher.com/monitor/create-task.md#notifications). Account-wide options, such as compact embeds and Telegram buttons, live in [Settings](https://docs.tweet-catcher.com/monitor/settings.md)

| Destination | You fill in | Plan |
| - | - | - |
| [Discord](#discord) | Webhook URL and a ping option | Any |
| [Telegram](#telegram) | Chat ID | Any |
| [Webhook](#webhook) | URL that accepts `POST` requests | Pro |
| [WebSocket](#websocket) | Nothing, you connect with your API key | Pro |

## Discord

**1. Create a webhook**

In Discord, open the channel settings, then go to **Integrations → Webhooks → New Webhook**. Copy the webhook URL

**2. Paste it on the task**

Set **Notification** to **Discord** and paste the URL into **Webhook**. It should look like `https://discord.com/api/webhooks/...`

**3. Choose a ping**

Pick who gets mentioned when a notification arrives. See [Ping options](#ping-options) below

### Ping options

| Option | Effect |
| - | - |
| No Ping | No mention |
| Everyone | Mentions `@everyone` |
| Here | Mentions `@here`, only online members |
| Role | Mentions the role set in **Ping Role ID** |

To get a role ID, turn on **Developer Mode** in Discord (**User Settings → Advanced**), then right-click the role and choose **Copy Role ID**

> [!TIP]
>
> Combine pings with [ping keywords or a regex](https://docs.tweet-catcher.com/monitor/create-task.md#advanced-options) so only the posts you care about mention anyone

### Split events across channels

By default, **Same channel** toggle sends every event type to one webhook. Uncheck it to give posts, follows, unfollows, profile changes, and deletions their own webhook field, so each type can land in a different channel

### Message appearance

* **Compact webhooks** in [Settings](https://docs.tweet-catcher.com/monitor/settings.md#discord) sends shorter, less noisy embeds
* **Webhook Appearance** sets the username, avatar, color, and footer of the messages *(Pro only)*

## Telegram

Notifications are sent by the [Tweet Catcher Telegram bot](https://t.me/TweetCatcherMonitorBot)

**1. Open the bot**

Start a private chat with [the bot](https://t.me/TweetCatcherMonitorBot), or add it to the group that should receive alerts

**2. Get the chat ID**

Send `/chat_id`. The bot will reply with the ID

![Telegram bot replying with the chat ID](https://mintcdn.com/tweet-catcher-a58f76a0/KlztmTaRb5pMJOie/images/telegram-bot.png?fit=max\&auto=format\&n=KlztmTaRb5pMJOie\&q=85\&s=e9eea4a7d9b3658542d7f61be1e1f902)

**3. Paste it on the task**

Set **Notification** to **Telegram** and paste the ID into **Chat ID**. The dashboard checks the ID before saving

To post into a specific forum topic, append the topic ID after a pipe: `chatId|topicId`

> [!WARNING]
>
> Telegram can convert a group into a supergroup and give it a new chat ID. This happens when the group is made public, member or admin permissions change, history visibility changes, or the 201st member joins. When it does, notifications stop arriving. Send `/chat_id` again and update the task with the new ID

### Message extras

* **Quick Link** in the task's [Advanced Options](https://docs.tweet-catcher.com/monitor/create-task.md#advanced-options) adds a custom link to each message, to quickly perform actions related to the monitored profile
* **Enable message buttons** in [Settings](https://docs.tweet-catcher.com/monitor/settings.md#telegram) adds **View Post**, **View Profile**, **Copy Post Link**, and **Copy Username** buttons. Turn on only the ones you want

## Webhook

*Pro only.* Set **Notification** to **Webhook** and enter the URL that should receive the events. Tweet Catcher sends one `POST` request per event:

```http theme={null}
POST /your-endpoint HTTP/1.1
Content-Type: application/json
User-Agent: Tweet Catcher Monitor (https://tweet-catcher.com)
```

The body is the same object as a [WebSocket event](https://docs.tweet-catcher.com/pro/events.md)

> [!WARNING]
>
> Failed deliveries are not retried. Respond with a `2xx` status quickly, and do any slow processing after you respond

## WebSocket

*Pro only*, and the only destination for [Twitter Global](https://docs.tweet-catcher.com/plans.md#twitter-global). There is nothing to fill in: the task shows a **Login Token**, which is the same as your API key in [Settings → API](https://docs.tweet-catcher.com/monitor/settings.md#api). See [WebSocket](https://docs.tweet-catcher.com/pro/websocket.md) to connect

## In the dashboard

While the dashboard is open, every new event also shows up as a toast. Team member sessions do not receive these alerts

To modify or disable the notification sound, open **Settings → Notifications** and choose a sound and volume

> [!NOTE]
>
> Browsers often block audio until you interact with the page. Click anywhere in the dashboard once after opening it or [whitelist the website](https://help.taskworld.com/en/articles/4841740-allowing-or-blocking-sites-to-play-sound-in-google-chrome)

## Troubleshooting

> [accordion] The dashboard rejects my Discord webhook
>
> Check that you copied the full URL, starting with `https://discord.com/api/webhooks/`, and that the webhook still exists in the channel settings. If it was deleted, create a new one

> [accordion] The role ping doesn't mention anyone
>
> **Ping Role ID** needs the role's numeric ID, not its name. Copy it with Developer Mode turned on

> [accordion] Telegram notifications stopped arriving in a group
>
> The group was probably converted to a supergroup and has a new chat ID. Send `/chat_id` in the group and update the task

> [accordion] My webhook endpoint missed some events
>
> Deliveries are not retried, so any event that hit an error or a timeout is lost. Make sure your endpoint is reachable and responds with a `2xx` status quickly

> [accordion] I don't hear the notification sound
>
> Check that the sound is not set to **None** and the volume is up, then check if the browser is blocking audio and [whitelist the website](https://help.taskworld.com/en/articles/4841740-allowing-or-blocking-sites-to-play-sound-in-google-chrome)

> [accordion] I don't see toasts in the dashboard
>
> Toasts only appear while the dashboard is open, and never in team member sessions


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.