> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/welcome/platform/notification-center/configure-bot.md).

# Bots

Bots send notifications from zenConsole to your Instant Messaging (IM) groups via Webhook.

## Supported IM Apps

* Slack
* WeCom
* Feishu
* DingTalk
* Telegram
* Custom Webhook

## Add a Bot

1. In Notification Center, go to **Bots**.
2. Click **+ Add Bot**.
3. Select your IM app.
4. Enter the webhook URL provided by your IM app and give the bot a name.
5. Click **Confirm**.

For custom webhook setup, see [Custom Webhook](#custom-webhook) below.

## Custom Webhook

Use the **Webhook** option to integrate zenConsole alerts with any service that accepts HTTP requests.

### Configuration

| Field         | Description                                                                         |
| ------------- | ----------------------------------------------------------------------------------- |
| Webhook URL   | The endpoint that receives notification requests.                                   |
| Bot name      | A display name to identify this bot.                                                |
| HTTP Method   | The HTTP method for sending requests. Defaults to `POST`.                           |
| Authorization | Optional. The value of the `Authorization` header. Defaults to the `Bearer` scheme. |

### Request Body

Zenlayer sends the notification as a JSON body, where `${content}` is replaced with the notification message:

```json
{
  "text": "${content}"
}
```

The following is an example of a notification payload:

```json
{
  "teamName": "QC-TEST15",
  "duration": "5min",
  "restoreTime": "2025-11-14 09:00:28 UTC",
  "instance": "d01f4c25-026c-4bdc-be1e-22d5803fc07f",
  "instanceName": "qctest0924e.ecn.zenlayer.net",
  "metricDesc": "Edge 5xx Codes Error Rate",
  "information": "Edge 5xx Codes Error Rate > 50% for 5 min",
  "triggerTime": "2025-11-14 08:55:00 UTC",
  "currentValue": "100.00%"
}
```

### Success Condition

Your endpoint must return HTTP `200`. Any other status code is treated as a delivery failure.