Mục lục
Echobell 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.
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:
https://hook.echobell.one/d/YOUR_KEY_TOKENHã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
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
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ườngtime-sensitive— cảnh báo quan trọng, xuyên qua chế độ Tập trungcalling— 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 để 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.
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 · Echobell là gì
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
callingcho 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. 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 là bước tiếp theo rất tự nhiên.
Bài liên quan
- Tài liệu Direct API — tham chiếu đầy đủ các trường và ví dụ
- WebhookMCP + Echobell — 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 — chọn đúng mức khẩn cho thông báo
- Thông báo webhook từ Zapier — quy trình tự động cho người không lập trình
- Các kiểu thông báo — hành vi của Thông thường, Khẩn cấp và Cuộc gọi