> For the complete documentation index, see [llms.txt](https://help.proxidize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.proxidize.com/legacy-products/proxy-builder/proxy-builder-cloud-dashboard/alerts-management.md).

# Alerts Management

## Monitor your hosts and endpoints and get notified on Slack, Discord, Telegram, Email, or Webhook when something needs your attention.

### Overview

Alerts Management lets you create automated alerts triggered by specific conditions on your hosts and endpoints. When a threshold is crossed, Proxidize notifies you through whichever platform you've configured.

{% hint style="warning" %}
Available on: Business plan only
{% endhint %}

**Available alert types:**

* Host CPU Usage
* Host RAM Usage
* Host Data Usage
* Host Down
* Endpoint Status

**Supported delivery platforms:**

* Email
* Webhook
* Slack
* Discord
* Telegram

You can find Alerts Management in the left sidebar of your Cloud Dashboard.

***

### Creating an Alert

Regardless of which platform you use, all alerts are created the same way:

{% stepper %}
{% step %}

## Go to Alerts Management

Go to **Alerts Management** in the sidebar.
{% endstep %}

{% step %}

## Create a new alert

Click **New Alert**.
{% endstep %}

{% step %}

## Fill in the alert details

Fill in the alert details:

* **Name:** a label to identify this alert
* **Host:** the host to monitor
* **Type:** the condition to trigger on (CPU, RAM, Data Usage, Host Down, Endpoint Status)
* **Receive On:** the platform to deliver the alert to
* **Threshold / Limit:** the value at which the alert fires (where applicable)

![](/files/c4e61296a8ff2473597695509605f2d762a7d321)
{% endstep %}

{% step %}

## Confirm

Click **Confirm**.
{% endstep %}
{% endstepper %}

Once created, the alert appears in the table with its name, host, type, and current status. You can pause or delete any alert from this table at any time.

![](/files/4ef78b3252f0bd84c6258305ec6196f5e574a349)

{% hint style="info" %}
Each platform requires a one-time setup before you can select it when creating an alert. See the relevant section below.
{% endhint %}

***

### Email

To receive alerts by email, the destination address must be added as a sub-account under your main Proxidize account first.

1. [Add the email address as a sub-account](broken://pages/a3f4d2a112cc4ea346262e7df4e1ecb818d2241d)
2. Once added, go to **Alerts Management** and create a new alert
3. Select **Email** as the delivery platform, your sub-account emails will appear in the dropdown
4. Select the address you want to receive the alert and confirm

***

### Webhook

Webhook alerts send an HTTP request to a URL of your choice whenever an alert is triggered, useful for integrating with custom systems or automation pipelines.

When creating an alert and selecting **Webhook** as the platform, you'll be prompted for:

* **URL:** the endpoint to send the request to
* **Method:** GET or POST

No external setup is required beyond having a URL ready to receive the request.

***

### Slack

{% stepper %}
{% step %}

## Create a Slack App

1. Go to [api.slack.com/apps](https://api.slack.com/apps) and click **Create an App**
2. Select **From scratch**, give it a name (e.g. "Proxidize Alerts"), and choose your workspace
3. From the **Features** menu, select **Incoming Webhooks** and toggle it on
4. Click **Add New Webhook to Workspace**, select the channel you want alerts posted to, and click **Allow**
5. Copy the generated **Webhook URL**
   {% endstep %}

{% step %}

## Create the Alert

1. Open Alerts Management on your Proxidize dashboard and create a new alert
2. Select **Slack** as the platform and paste the Webhook URL
3. Confirm to save
   {% endstep %}
   {% endstepper %}

***

### Discord

{% stepper %}
{% step %}

## Invite the Proxidize Bot

1. Click [this link](https://discord.com/oauth2/authorize?client%5Fid=1244629276918284319\&permissions=2048\&scope=bot) to invite the Proxidize Bot to your Discord server
2. Select the server you want to use and complete the authorization process

![image (1)-1](/files/1cc4f512996e8618f4b9dfd6429b95615da803bb)
{% endstep %}

{% step %}

## Enable Developer Mode

1. In Discord, go to **User Settings → Advanced**
2. Toggle on **Developer Mode**

![image (4)-1](/files/8f250d765dc0449eeb7b709c334517522f29b4d9)
{% endstep %}

{% step %}

## Get Your Server ID and Channel ID

1. Right click on your server icon and select **Copy ID** to get the **Server ID**
2. Right click on the channel you want alerts sent to and select **Copy ID** to get the **Channel ID**
   {% endstep %}

{% step %}

## Create the Alert

1. Open Alerts Management on your Proxidize dashboard and create a new alert
2. Select **Discord** as the platform
3. Enter the **Server ID** and **Channel ID**
4. Confirm to save
   {% endstep %}
   {% endstepper %}

***

### Telegram

Telegram alerts can be delivered to a Channel, a Group, or your Private Messages. The setup differs slightly depending on which you use, but all three require adding ***@ProxidizeBot*** and retrieving a Chat ID.

{% tabs %}
{% tab title="Option A: Telegram Channel" %}

1. Open Telegram web and go to your channel
2. Click the channel name to open channel info, then tap the **Edit** button (pencil icon)
3. Go to **Administrators** → **Add Administrator**
4. Search for **@ProxidizeBot** and add it
5. In the permissions screen, enable only **Post Messages** and disable everything else, then confirm
6. While viewing the channel in a web browser, copy the **Chat ID** from the URL, include the dash if present (e.g. `-1002xxxxxxxx`)

![Telegram5](/files/a75ae93cb985d5d41911016c95d2e7d01566aa55)

7. Go to Alerts Management in Proxidize, create a new alert, select **Telegram**, and paste the Chat ID
   {% endtab %}

{% tab title="Option B: Telegram Group" %}

1. Open Telegram web and go to your group
2. Click the group name to open group info, then tap **Add Members**
3. Search for **@ProxidizeBot** and add it to the group
4. While viewing the group in a web browser, copy the **Chat ID** from the URL, include the dash if present
5. Go to Alerts Management in Proxidize, create a new alert, select **Telegram**, and paste the Chat ID
   {% endtab %}

{% tab title="Option C: Private Messages" %}

1. Go to [telegram.me/ProxidizeBot](https://telegram.me/ProxidizeBot) and click **Open in Web**
2. Click the **Start** button to initiate the bot
3. Click the burger menu (☰) and navigate to **Saved Messages**
4. While viewing Saved Messages in a web browser, copy the **Chat ID** from the URL, include the dash if present
5. Go to Alerts Management in Proxidize, create a new alert, select **Telegram**, and paste the Chat ID
   {% endtab %}
   {% endtabs %}

***

### Need Help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at **<support@proxidize.com>**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.proxidize.com/legacy-products/proxy-builder/proxy-builder-cloud-dashboard/alerts-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
