---
title: "Echobell Direct: Cảnh báo webhook cá nhân, không cần lập kênh"
date: 2026-03-05
description: "Echobell Direct cho bạn một webhook URL cá nhân để nhận thông báo tức thì từ script, tác vụ CI và công cụ tự động hóa - không cần thiết lập kênh."
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Echobell
  - Echobell Direct
  - cảnh báo tức thì
  - thông báo đẩy
  - thông báo chung
---

[Echobell Direct](/vi/docs/direct) là chế độ cảnh báo cá nhân bỏ qua hoàn toàn việc lập kênh. Bạn tạo một khóa Direct, nhận một webhook URL, rồi POST một `title` + `body` để nhận thông báo tức thì trên thiết bị. Không người đăng ký, không mẫu, không cấu hình định tuyến.

Bài này nói về Direct là gì, thiết lập ra sao, và khi nào nên dùng nó thay cho Kênh.

## Echobell Direct là gì?

Mỗi khóa Direct sinh ra một webhook URL riêng (`/d/{token}`). Gửi một request tới URL đó là thông báo đến thiết bị của bạn ngay lập tức.

Hãy dùng Direct khi bạn cần:

- Thông báo cá nhân từ script, cron job hay pipeline CI
- Tiêu đề và nội dung tùy biến theo từng request thay vì mẫu cố định
- Thiết lập nhanh mà không phải cấu hình cả một kênh

Nếu bạn cần thông báo dùng chung, mẫu tái sử dụng hoặc gửi có điều kiện, hãy dùng [Kênh qua Webhook](/vi/docs/webhook).

## Thiết lập trong 3 bước

### Bước 1: Tạo một khóa Direct

Mở Echobell, chạm **Direct** trong danh sách kênh, rồi tạo một khóa. Hãy đặt tên theo dịch vụ mà nó phục vụ (ví dụ `CI Server`, `Cron`, `AI Tasks`).

### Bước 2: Sao chép webhook URL của bạn

Mỗi khóa có một URL theo dạng:

```text
https://hook.echobell.one/d/YOUR_KEY_TOKEN
```

Hãy coi URL này là bí mật — ai có nó cũng gửi thông báo cho bạn được.

### Bước 3: Gửi thông báo đầu tiên

```bash
curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy failed",
    "body": "api-service failed health check",
    "notificationType": "time-sensitive",
    "externalLink": "https://dashboard.example.com/deploys/123"
  }'
```

Tham chiếu đầy đủ các trường: [Direct API](/vi/docs/direct)

## Các mức độ khẩn

Direct hỗ trợ `notificationType` để bạn khớp mức khẩn với sự kiện:

- `active` — cập nhật thông thường
- `time-sensitive` — cảnh báo quan trọng, xuyên qua chế độ Tập trung
- `calling` — sự cố nguy cấp (cần gói premium còn hiệu lực; nếu không sẽ tự hạ xuống time-sensitive)

Xem [Các kiểu thông báo](/vi/docs/notification) để biết chi tiết hành vi.

## Thêm bối cảnh cho cảnh báo

Hãy đưa `externalLink` vào phần thân request để gắn một URL vào thông báo — rất tiện khi muốn dẫn thẳng tới log triển khai, dashboard hay pull request.

Với AI agent và các tác vụ bất đồng bộ chạy lâu, Direct là cách gọn gàng để được báo khi công việc xong thay vì phải tự kiểm tra liên tục. Xem thêm: [WebhookMCP + Echobell](/vi/blog/get-notified-with-webhook-mcp).

## Direct và Kênh

| | Direct | Kênh |
|---|---|---|
| Người nhận | Chỉ mình bạn | Chia sẻ với đồng đội |
| Mẫu | Nội dung theo từng request | Mẫu cố định, dùng lại được |
| Thời gian thiết lập | Dưới một phút | Cần cấu hình kênh |
| Điều kiện | Không hỗ trợ | Có hỗ trợ |

Hãy dùng Kênh khi cảnh báo cần đến nhiều người hoặc khi bạn muốn định dạng nhất quán cho cả một dịch vụ. [Tài liệu về mẫu](/vi/docs/template) · [Echobell là gì](/vi/docs/what-is-echobell)

## Thói quen bảo mật

- Lưu token Direct trong biến môi trường hoặc trình quản lý bí mật, đừng để trong code
- Tạo mỗi dịch vụ một khóa để có thể thu hồi riêng lẻ
- Xoay token ngay khi nghi ngờ một URL bị lộ
- Chỉ dùng `calling` cho sự cố thật — lạm dụng sẽ gây mệt mỏi vì cảnh báo

## Câu hỏi thường gặp

**Direct chỉ dành cho lập trình viên à?** Không. Ai có công cụ gửi được HTTP request đều dùng được.

**Direct có hỗ trợ request GET không?** Có, nhưng nên dùng POST kèm JSON.

**Nếu gói đăng ký hết hạn mà tôi dùng `calling` thì sao?** Nó tự hạ xuống `time-sensitive`.

---

Hãy bắt đầu với [hướng dẫn Direct](/vi/docs/direct). Khi quy trình của bạn lớn đến mức cần cộng tác hoặc cần mẫu, [Kênh](/vi/docs/webhook) là bước tiếp theo rất tự nhiên.

## Bài liên quan

- [Tài liệu Direct API](/vi/docs/direct) — tham chiếu đầy đủ các trường và ví dụ
- [WebhookMCP + Echobell](/vi/blog/get-notified-with-webhook-mcp) — thông báo khi tác vụ AI hoàn tất, dùng Direct
- [Cách vượt qua chế độ Tập trung của iOS](/vi/blog/how-to-bypass-ios-focus-mode-for-critical-alerts) — chọn đúng mức khẩn cho thông báo
- [Thông báo webhook từ Zapier](/vi/blog/zapier-webhook-notifications-to-phone) — quy trình tự động cho người không lập trình
- [Các kiểu thông báo](/vi/docs/notification) — hành vi của Thông thường, Khẩn cấp và Cuộc gọi