Webhooks

Webhooks cho phép Shifton gửi thông báo thời gian thực đến hệ thống bên ngoài khi có sự kiện xảy ra trong công ty.

Hướng dẫn từng bước

Truy cập tab Webhooks

Trên thanh bên trái nhấn Tích hợp.

Chuyển đến trang Nhà phát triển → tab Webhook.

Tạo webhook mới

Nhấn «Webhook mới».

Điền cấu hình:

Trường	Mô tả
URL	Điểm cuối nhận dữ liệu sự kiện
Sự kiện	Sự kiện Shifton kích hoạt webhook
Hoạt động	Công tắc bật/tắt

Lưu. Shifton sẽ gửi yêu cầu HTTP POST đến URL đã chỉ định.

Quản lý webhooks

Nhấn vào webhook để chỉnh sửa URL, cập nhật sự kiện hoặc thay đổi trạng thái hoạt động.

Kiểm tra webhook

Tạo sự kiện tương ứng trong Shifton (ví dụ, tạo ca test).

Kiểm tra nhật ký máy chủ — dữ liệu phải đến.

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

H: ca làm việcon gửi dữ liệu ở định dạng nào?
HTTP POST với body ở định dạng JSON. Cấu trúc dữ liệu theo từng loại sự kiện xem trong tài liệu API.

H: Có thể tạo nhiều Webhook cho một sự kiện không?
Có, với URL khác nhau.

H: Nếu máy chủ không khả dụng khi webhook kích hoạt thì sao?
Gửi có thể thất bại. Chi tiết về chính sách thử lại — trong tài liệu API.

H: Webhook không kích hoạt — tại sao?
Đảm bảo công tắc Hoạt động đã bật và URL có thể truy cập công khai.

H: Làm thế nào kiểm tra webhook nhận dữ liệu?
Tạo sự kiện test trong Shifton (ví dụ, thêm ca) và kiểm tra nhật ký máy chủ có yêu cầu POST đến.

H: Tôi có thể cấu hình xác thực webhook không?
Có. Thêm khóa bí mật hoặc token vào URL hoặc header webhook. Chi tiết trong tài liệu API.

H: Body yêu cầu webhook trông như thế nào?
Đối tượng JSON với dữ liệu sự kiện. Cấu trúc tùy thuộc vào loại sự kiện — xem tài liệu API để có ví dụ.

H: Một webhook có thể theo dõi nhiều sự kiện không?
Có. Khi tạo webhook chọn nhiều sự kiện — một URL sẽ nhận thông báo cho tất cả sự kiện đã chọn.

H: «Chính sách thử lại» cho webhook là gì?
Nếu máy chủ trả lỗi (không phải 200), Shifton có thể thử lại yêu cầu. Chi tiết tùy thuộc vào cấu hình nền tảng.

H: Có giới hạn số lượng Webhook không?
Không có giới hạn cụ thể trong tài liệu, nhưng khuyến nghị chỉ tạo cần thiết.

H: Có cần sử dụng HTTPS cho URL webhook không?
Khuyến nghị. URL HTTP có thể hoạt động nhưng HTTPS đảm bảo truyền dữ liệu an toàn.

H: Có thể nhận thông báo webhook khi lịch trình thay đổi không?
Có. Thêm sự kiện loại «Ca làm việc đã được tạo» hoặc «schedule updated» khi cấu hình webhook.

H: Ai có quyền tạo Webhook?
Chỉ Owner. Quản lý và nhân viên không thấy mục Developer.

H: Có thể tắt webhook mà không xóa không?
Có. Tắt công tắc Hoạt động trong cài đặt webhook — nó ngừng kích hoạt nhưng giữ cấu hình.

H: Các lần kích hoạt webhook có được ghi nhật ký trong ca làm việcon không?
Nhật ký gửi webhook chi tiết không được cung cấp trong giao diện. Theo dõi — phía máy chủ của bạn.

H: Có thể lọc webhook theo dự án hoặc lịch trình không?
Không. Webhook kích hoạt cho tất cả sự kiện loại đã chọn trong toàn công ty. Lọc — phía máy chủ nhận.

H: Điều gì xảy ra với webhook khi xóa công ty?
Tất cả webhooks bị xóa cùng với công ty.