---
title: "Gửi thử webhook"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/webhooks.test
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Gửi thử webhook

Gửi ngay một sự kiện mẫu có chữ ký (test: true) và trả mã trạng thái, độ trễ, lỗi và phần đầu câu trả lời của bên nhận, kèm việc một sự kiện thật như vậy có qua bộ lọc không. Chạy được cả khi đang tạm dừng / tắt.

Gửi ngay một sự kiện mẫu có chữ ký (test: true) và trả mã trạng thái, độ trễ, lỗi và phần đầu câu trả lời của bên nhận, kèm việc một sự kiện thật như vậy có qua bộ lọc không. Chạy được cả khi đang tạm dừng / tắt.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `webhooks.test` |
| Scope cần | `webhooks.manage` |
| Mức | Ghi |
| 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ó |   |
| `eventType` | `chữ` | Không | Mặc định: loại đầu tiên đã đăng ký. |
| `contentMode` | `"full" \| "thin" \| "none"` | Không |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/webhooks.test \
  -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 |
| --- | --- | --- |
| `ready` | `đúng/sai` | Có |
| `delivery_id` | `chữ` | Có |
| `webhook_id_header` | `chữ` | Có |
| `delivered` | `đúng/sai` | Có |
| `status` | `chữ` | Có |
| `status_code` | `null \| số` | Có |
| `duration_ms` | `null \| số` | Có |
| `error_code` | `null \| chữ` | Có |
| `error_text` | `null \| chữ` | Có |
| `response_snippet` | `null \| chữ` | Có |
| `key_ids` | `chữ[]` | Có |
| `ok` | `true` | Có |
| `event_type` | `chữ` | Có |
| `subscribed` | `đúng/sai` | Có |
| `filter` | `đối tượng` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ready": true,
    "delivery_id": "00000000-0000-4000-8000-000000000000",
    "webhook_id_header": "text",
    "delivered": true,
    "status": "text",
    "status_code": 1,
    "duration_ms": 1,
    "error_code": "text",
    "error_text": "text",
    "response_snippet": "text",
    "key_ids": [
      "text"
    ],
    "ok": true,
    "event_type": "text",
    "subscribed": true,
    "filter": {
      "match": true,
      "text": "text"
    }
  }
}
```

## Dùng qua MCP

Tool `webhooks_test` 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`.