Tài liệu

Webhook — Tổng quan và thiết lập Pro

Webhook Savebase nối thư viện với Zapier, Make, Slack, Airtable, Discord, máy chủ riêng hay công cụ tự động hóa khác. Khi bài được lưu, gắn thẻ, xóa hoặc khôi phục, Savebase gửi HTTP POST đến địa chỉ đã đăng ký.

Tính năng Pro

Webhook có trên Pro và Lifetime. Nâng cấp tại savebase.space/pricing.

Tổng quan

Khi có sự kiện trong thư viện, Savebase gửi JSON có chữ ký tới mọi endpoint đã bật đăng ký sự kiện đó. Bạn có thể có nhiều endpoint, ví dụ mỗi tích hợp một endpoint.

Thiết lập webhook

1

Đi tới Cài đặt → Webhook

Đi đến Dashboard → Settings → Webhooks.
2

Nhấp Thêm webhook

Nhập URL điểm cuối của bạn (phải là HTTPS), nhãn tùy chọn và chọn các sự kiện muốn đăng ký nhận.
3

Sao chép khóa bí mật ký

Sau khi tạo webhook, hiển thị rồi sao chép Khóa bí mật ký. Dùng thông tin này để xác minh yêu cầu đến từ Savebase.
4

Thử địa chỉ đích

Nhấp Gửi sự kiện thử để gửi ngay dữ liệu mẫu.

Sự kiện hỗ trợ

Sự kiệnKhi kích hoạt
post.savedMột bài mới được thêm vào thư viện của bạn
post.taggedMột thẻ được thêm vào bài viết
post.deletedMột bài được chuyển vào thùng rác
post.restoredMột bài được khôi phục từ thùng rác

Định dạng payload

Mọi sự kiện dùng cùng cấu trúc bao JSON:

bash
{
  "event": "post.saved",
  "timestamp": "2026-03-11T12:00:00.000Z",
  "data": {
    "id": 123,
    "url": "https://x.com/user/status/...",
    "title": "Post title or null",
    "source": "x",
    "author_name": "username",
    "tags": ["design", "ai"],
    "saved_at": "2026-03-11T12:00:00.000Z"
  }
}

Tích hợp Zapier

1

Tạo Zap mới

Trong Zapier, nhấp Create Zap và tìm Webhooks by Zapier làm ứng dụng kích hoạt.
2

Chọn Catch Hook

Chọn Catch Hook. Zapier sẽ tạo một URL webhook riêng.
3

Đăng ký URL trong Savebase

Sao chép URL Zapier vào Settings → Webhooks và chọn sự kiện.
4

Thử trình kích hoạt

Lưu bài. Zapier nhận diện payload; ánh xạ data.url, data.title, v.v. vào các bước hành động.
5

Thêm hành động của bạn

Kết nối bất kỳ hành động Zapier nào: hàng Google Sheets, tin nhắn Slack, trang Notion, bài đăng Discord.

Không có xác minh chữ ký gốc trong Zapier

Thêm bước Filter hoặc Code trong Zapier để xác minh X-Savebase-Signature nếu cần xác thực bảo mật.

Make (Integromat)

1

Tạo kịch bản mới

Trong Make, thêm một Webhook → Webhook tùy chỉnh .
2

Đăng ký trong Savebase

Sao chép URL Make vào Settings → Webhooks.
3

Xác định cấu trúc dữ liệu

Lưu bài trong Savebase; Make tự nhận diện cấu trúc payload.
4

Tạo kịch bản của bạn

Bản đồ data.url, data.source, cùng các trường khác sang các mô-đun tiếp theo như Airtable, Notion hoặc email.

Trước

Khắc phục sự cố

Tiếp theo

Bảo mật và ký HMAC