Video hướng dẫn
Xem nhanh video hướng dẫn dưới đây, hoặc đọc các bước chi tiết ngay bên dưới video.
Giới thiệu
Webhook là cơ chế “có việc là báo ra ngoài”: mỗi khi có sự kiện trong SellMate Chat (ví dụ có tin nhắn mới), hệ thống tự gửi một gói dữ liệu (payload) tới một địa chỉ URL mà doanh nghiệp chỉ định — thường là CRM, hệ thống chăm sóc khách hàng khác, hoặc server trung gian của đội kỹ thuật.
Đây là tính năng dành cho bộ phận kỹ thuật/tích hợp. Nếu doanh nghiệp bạn chưa có hệ thống nào nhận dữ liệu, bạn có thể bỏ qua bài này — mọi tính năng chat vẫn hoạt động bình thường khi webhook tắt.
Các bước thực hiện
Bước 1: Mở trang Webhook và đọc các trường chính
Vào Cấu hình → Webhook (nhóm Hệ thống). Các thành phần chính:
- Bật webhook: công tắc tổng — tắt thì không có dữ liệu nào được gửi ra.
- Địa chỉ nhận: URL của hệ thống nhận, bắt buộc là HTTPS. Trang cũng lưu ý ngay: payload chứa nội dung tin nhắn — địa chỉ nhận phải là hệ thống tin cậy của doanh nghiệp.
- Khoá ký: một chuỗi bí mật dùng để ký lên mỗi payload, giúp phía nhận chắc chắn dữ liệu thật sự từ SellMate Chat gửi. Ô này có nút Hiện và nút Tạo khoá ký ngẫu nhiên — khóa ký là bí mật, không chia sẻ ra ngoài nhóm kỹ thuật.
Ảnh minh họa để trống các trường này — không có khóa thật nào được tạo trong quá trình viết bài.
Bước 2: Đọc phần “Cách xác minh” phía nhận
Nửa dưới trang là hướng dẫn cho phía nhận dữ liệu: đoạn mã mẫu kiểm tra chữ ký HMAC-SHA256 — phía nhận dùng chính khóa ký ở bước 1 để tính lại chữ ký và so với chữ ký đi kèm payload; khớp thì mới tin dữ liệu. Có nút Sao chép để lấy đoạn mã mẫu gửi cho đội kỹ thuật.
Hiểu nguyên tắc này giúp bạn phối hợp đúng người khi tích hợp gặp lỗi “phía nhận báo sai chữ ký”: gần như luôn do hai bên dùng khác khóa ký (ví dụ SellMate vừa đổi khóa mà phía nhận chưa cập nhật).
Kết quả
Khi webhook bật và cấu hình đúng: mỗi sự kiện mới trong hệ thống chat được đẩy gần như tức thì sang hệ thống ngoài kèm chữ ký xác thực — nền tảng cho các tích hợp như đồng bộ CRM, tạo ticket tự động, hoặc thống kê riêng.
Lưu ý
- Khóa ký lộ = mất an toàn tích hợp: ai có khóa ký đều giả mạo được dữ liệu “từ SellMate Chat”. Nghi ngờ lộ khóa thì tạo khóa mới và cập nhật đồng thời cả hai phía.
- Payload chứa nội dung tin nhắn của khách — chỉ trỏ webhook tới hệ thống thuộc quyền kiểm soát của doanh nghiệp, và cân nhắc quy định bảo vệ dữ liệu cá nhân.
- Trước khi bật thật, đội kỹ thuật nên kiểm thử ở môi trường thử nghiệm; trang cấu hình này không có nút “gửi thử” — đừng bật thẳng lên hệ thống chính khi chưa kiểm thử.
- Thay đổi webhook cũng phải bấm Lưu cấu hình mới có hiệu lực và được ghi vào Lịch sử thay đổi.
