---
title: "Chi tiết webhook"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/webhooks.get
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Chi tiết webhook

Cấu hình đầy đủ, revision (gửi lại làm expectedRevision khi cập nhật), khoá ký (kid, hạn — không bao giờ có bí mật), câu mô tả bộ lọc, phạm vi thực tế (loại / tài khoản / trường bị che thực sự được gửi). revealUrl=true trả URL đầy đủ (có ghi nhật ký).

Cấu hình đầy đủ, revision (gửi lại làm expectedRevision khi cập nhật), khoá ký (kid, hạn — không bao giờ có bí mật), câu mô tả bộ lọc, phạm vi thực tế (loại / tài khoản / trường bị che thực sự được gửi). revealUrl=true trả URL đầy đủ (có ghi nhật ký).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `webhooks.get` |
| 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ả |
| --- | --- | --- | --- |
| `id` | `uuid` | Có |   |
| `revealUrl` | `đúng/sai` | Không | Trả về URL đầy đủ (chỉ chủ sở hữu; có ghi nhật ký). |

## Ví dụ gọi

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

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

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

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "webhook": {
      "keys": [
        {
          "kid": "text",
          "created_at": "2026-10-22T12:00:00.000Z",
          "expires_at": "2026-10-22T12:00:00.000Z",
          "revoked_at": "2026-10-22T12:00:00.000Z",
          "active": true
        }
      ],
      "health_24h": {
        "endpoint_id": "00000000-0000-4000-8000-000000000000",
        "delivered": 1,
        "failed": 1,
        "filtered": 1,
        "pending": 1,
        "dead": 1
      },
      "stats_24h": {
        "hours": [
          {
            "at": "text",
            "ok": 1,
            "failed": 1
          }
        ],
        "attempts": 1,
        "ok": 1,
        "p95_ms": 1,
        "p50_ms": 1
      },
      "last_replay": {
        "id": "00000000-0000-4000-8000-000000000000",
        "status": "text",
        "from_at": "2026-10-22T12:00:00.000Z",
        "to_at": "2026-10-22T12:00:00.000Z",
        "event_types": [
          "text"
        ],
        "only_failed": true,
        "total": 1,
        "enqueued": 1,
        "created_at": "2026-10-22T12:00:00.000Z",
        "finished_at": "2026-10-22T12:00:00.000Z"
      },
      "history": [
        {
          "at": "text",
          "action": "text",
          "by": "connection",
          "actor_id": "00000000-0000-4000-8000-000000000000",
          "changed": [
            "text"
          ],
          "revision": 1
        }
      ],
      "effective": {
        "ok": true,
        "types": [
          "text"
        ],
        "account_ids": [
          "text"
        ],
        "all_accounts": true,
        "masked_fields": [
          "text"
        ]
      },
      "applicable_filters": [
        "direction"
      ],
      "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"
    }
  }
}
```

## Dùng qua MCP

Không có tên sẵn trong profile nào: gọi `tools_describe` rồi `tools_run` với `code: "webhooks.get"`. Tên tool khi được liệt kê: `webhooks_get`.