Tài liệu

Tham chiếu

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.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

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

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ề

{
  "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.

Trang này có hữu ích không?

Kiểm lại lần cuối: 24/10/2026 · bản 2.0