---
title: "Danh sách webhook"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/webhooks.list
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Danh sách webhook

Các webhook của bạn (mọi webhook của workspace nếu có integrations.manage) kèm trạng thái, chủ sở hữu, câu mô tả bộ lọc và sức khoẻ 24 giờ (delivered / failed / filtered / pending / dead).

Các webhook của bạn (mọi webhook của workspace nếu có integrations.manage) kèm trạng thái, chủ sở hữu, câu mô tả bộ lọc và sức khoẻ 24 giờ (delivered / failed / filtered / pending / dead).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `webhooks.list` |
| Scope cần | `webhooks.read` |
| Mức | Chỉ đọc |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Trả kết quả ngay |
| Cần `Idempotency-Key` | Không |
| Vai trò thành viên được phép | `owner`, `manager`, `agent` |
| Trong app | Cài đặt → Webhook |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `status` | `"active" \| "paused" \| "disabled" \| "suspended"` | Không |   |
| `owner` | `"all" \| "mine" \| "people" \| "connections"` | Không |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/webhooks.list \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `webhooks` | `đối tượng[]` | Có |
| `limits` | `đối tượng` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "webhooks": [
      {
        "health_24h": {
          "endpoint_id": "00000000-0000-4000-8000-000000000000",
          "delivered": 1,
          "failed": 1,
          "filtered": 1,
          "pending": 1,
          "dead": 1
        },
        "url_host": "text",
        "status": "active",
        "status_reason": "text",
        "status_changed_at": "2026-10-22T12:00:00.000Z",
        "owner": {
          "kind": "human",
          "user_id": "00000000-0000-4000-8000-000000000000",
          "connection_id": "00000000-0000-4000-8000-000000000000",
          "connection_name": "text"
        },
        "event_types": [
          "text"
        ],
        "account_scope": {
          "mode": "all"
        },
        "filters": {
          "direction": "in",
          "keywords": {
            "any": [
              "text"
            ],
            "none": [
              "text"
            ]
          },
          "chat_types": [
            "channel"
          ],
          "mention_only": true,
          "exclude_self": true,
          "exclude_sent_by": [
            "campaign"
          ],
          "exclude_connection_ids": [
            "text"
          ],
          "exclude_own_connection": true,
          "include_backfill": true,
          "conversation_ids": [
            "text"
          ],
          "conversation_tags": [
            "text"
          ],
          "has_media": true,
          "person_stage_ids": [
            "text"
          ],
          "campaign_ids": [
            "text"
          ]
        },
        "filters_text": "text",
        "content_mode": "full",
        "content_type": "application/json",
        "revision": 1,
        "verified_at": "2026-10-22T12:00:00.000Z",
        "tested_at": "2026-10-22T12:00:00.000Z",
        "ready": true,
        "consecutive_failures": 1,
        "failing_since": "text",
        "last_success_at": "2026-10-22T12:00:00.000Z",
        "last_failure_at": "2026-10-22T12:00:00.000Z",
        "created_at": "2026-10-22T12:00:00.000Z",
        "updated_at": "2026-10-22T12:00:00.000Z",
        "url": "text",
        "id": "00000000-0000-4000-8000-000000000000",
        "name": "text",
        "description": "text",
        "url_masked": "text"
      }
    ],
    "limits": {
      "per_workspace": 50,
      "per_connection": 10
    }
  }
}
```

## Dùng qua MCP

Tool `webhooks_list` có tên sẵn trong profile: Đầy đủ (`full`). Ở profile khác, tìm bằng `tools_search` rồi chạy bằng `tools_run`.