Cấu hình Webhooks và Tích hợp Sự kiện thời gian thực

Webhooks cho phép SolidSuite tự động gửi một gói tin dữ liệu (HTTP POST Payload) đến máy chủ của bạn hoặc các nền tảng tự động hóa (như n8n, Make, Zapier) ngay khi có một sự kiện nghiệp vụ xảy ra trong hệ thống.

1. Các sự kiện Webhook hỗ trợ

• Sự kiện CRM:

  • lead.created: Kích hoạt khi có khách hàng tiềm năng mới đăng ký.
  • deal.stage_changed: Kích hoạt khi cơ hội bán hàng chuyển sang giai đoạn mới (ví dụ: Chuyển sang Thắng).
• Sự kiện Work:

  • task.created: Kích hoạt khi có công việc mới được tạo.
  • task.completed: Kích hoạt khi công việc hoàn thành hoặc được duyệt xong.
• Sự kiện HRM:

  • leave_request.approved: Kích hoạt khi đơn xin nghỉ phép được phê duyệt.
  • employee.onboarded: Kích hoạt khi nhân viên mới hoàn tất tiếp nhận.

2. Hướng dẫn thiết lập Webhook Endpoint

1. 1

   Mở trang Quản lý Webhooks

   Trong SolidAdmin, chọn menu Nhà phát triển > Webhooks (đường dẫn /developers/webhooks). Nhấp + Thêm Webhook mới.

2. 2

   Điền thông tin máy chủ nhận dữ liệu

   • Tên Webhook: Đặt tên mô tả (ví dụ: Bắn thông báo vào Telegram khi có Lead mới).
   • Endpoint URL: Địa chỉ URL nhận gói tin (phải hỗ trợ HTTPS, ví dụ: https://webhook.yourcompany.com/solid-lead).
   • Chọn các sự kiện lắng nghe: Đánh dấu chọn các sự kiện tương ứng (ví dụ: lead.created, task.completed).
3. 3

   Thiết lập Chữ ký bảo mật (Webhook Secret Signature)

   Hệ thống tự động sinh một mã bí mật (Secret Key) để ký số vào Header X-SolidSuite-Signature của mỗi request gửi đi, giúp máy chủ của bạn xác thực chắc chắn rằng gói tin được gửi từ chính máy chủ SolidSuite.

4. 4

   Gửi gói tin kiểm thử (Send Test Ping)

   Nhấp nút Gửi thử nghiệm (Test Payload) để kiểm tra máy chủ của bạn đã phản hồi mã trạng thái HTTP 200 OK thành công hay chưa.