← Tất cả bài viết
Nhà phát triển APINhà phát triểnTự động hóa

Gửi sự kiện sona.to đi bất cứ đâu bằng webhook

05 Aug, 2026
Gửi sự kiện sona.to đi bất cứ đâu bằng webhook

Cho đến nay, muốn biết bài đăng đã ra chưa thì phải đi hỏi. Bạn gọi API, kiểm tra trạng thái, rồi lát sau gọi lại. Cách đó chạy được, nhưng bản chất là hỏi liên tục: hỏi quá dày thì lãng phí yêu cầu, hỏi quá thưa thì biết muộn. Webhook đảo ngược điều đó. Bạn đưa cho sona.to một URL, và sona.to gọi cho bạn ngay khi có chuyện xảy ra. Hiện đã có trong mọi gói.

Có bốn sự kiện để đăng ký, và chúng bao quát những kết quả đáng phản hồi: bài đăng đã đăng, bài đăng bị lỗi, kiểm tra trang web hoàn tất và kiểm tra trang web bị lỗi. Bạn chọn mỗi webhook nhận sự kiện nào, nên một cảnh báo Slack có thể chỉ nghe lỗi trong khi hệ thống báo cáo nhận tất cả. Payload dùng đúng tên trường mà REST API trả về, nên phần bạn đã phân tích từ một yêu cầu GET vẫn chạy y nguyên.

Thiết lập mất một phút. Mở trang API trong bảng điều khiển, dán URL mà công cụ của bạn cung cấp, tích những sự kiện bạn muốn rồi lưu. Khóa ký hiện đúng một lần vào lúc đó. Hãy sao chép ngay, vì nó không hiện lại lần nữa.

Khóa đó là cách bạn biết một yêu cầu là thật. Mỗi lần gửi đều mang một header chữ ký chứa dấu thời gian và một HMAC SHA-256 tính từ dấu thời gian đó cùng phần thân yêu cầu, bằng khóa của bạn. Hãy tính lại ở phía bạn và so sánh hai giá trị bằng một hàm thời gian hằng số. Vì dấu thời gian nằm trong phần được ký, một yêu cầu bị bắt lại không thể phát lại để chống bạn về sau. Từ chối mọi thứ cũ hơn vài phút là đủ.

Việc gửi không bỏ cuộc ngay ở sự cố đầu tiên. Nếu điểm nhận của bạn sập hoặc trả về lỗi, yêu cầu sẽ được thử lại sau 60 giây, rồi 5 phút, rồi 30 phút. Mỗi lần thử đều được ghi lại kèm mã trạng thái và thời lượng, nên một điểm nhận trục trặc là thứ bạn xem được chứ không phải đoán. Điểm nhận liên tục thất bại sẽ tự động bị tắt, và bạn bật lại sau khi sửa xong.

Nơi hiển nhiên để trỏ tới là một nền tảng tự động hóa. Zapier, Make và n8n đều cấp cho bạn một URL webhook để dán, và sự kiện đến ở dạng JSON, sẵn sàng nối vào bước tiếp theo: một tin nhắn trong kênh, một dòng trong bảng tính, một việc trong công cụ theo dõi. Máy chủ của riêng bạn hoạt động y hệt, không cần nền tảng ở giữa.

Một lưu ý về những gì sona.to chấp nhận. Đích đến phải dùng https và phải là địa chỉ công khai. URL trỏ vào mạng nội bộ sẽ bị từ chối, cả khi lưu lẫn khi gửi, và hệ thống không đi theo chuyển hướng. Nếu bạn tự vận hành bộ nhận trong mạng nội bộ, hãy đặt nó sau một tên máy chủ công khai hoặc một đường hầm.

Webhook đứng cùng REST API và máy chủ MCP như cách thứ ba để điều khiển sona.to từ bên ngoài bảng điều khiển. API để hỏi, MCP để một trợ lý AI hỏi bạn, còn webhook để bạn được báo. Toàn bộ chi tiết, gồm cả ví dụ xác minh chữ ký, nằm trong tài liệu API.