Webhook và APIAdd-on

Nối HVSC Chat với hệ thống của bạn

Mỗi sự kiện được gửi tới URL bạn khai báo, có chữ ký để kiểm tra. Khoá API cho phép đọc hội thoại và gửi tin từ n8n, Zapier hoặc phần mềm riêng.

Đăng ký Đăng nhập

POST tới URL của bạn

X-HVSC-Event: message.received
X-HVSC-Timestamp: 1760000000
X-HVSC-Signature: v1=<hex>

{
  "event": "message.received",
  "data": {
    "conversation": { "id": "…", "channel": "web" },
    "message": { "sender_type": "visitor", "body": "…" }
  }
}

Đây là add-on. Giá: Liên hệ. Sau khi đăng ký, nhân viên HVSC tư vấn và quản trị viên duyệt trước khi bật cho workspace của bạn. Mặc định tắt, bật theo từng website. Xem danh mục add-on.

Sự kiện gửi đi

Đăng ký theo từng địa chỉ nhận. Ghi chú nội bộ không bao giờ được gửi.

Các sự kiện webhook
Sự kiện	Khi nào
`conversation.created`	Khách gửi tin đầu tiên của một hội thoại
`message.received`	Mỗi tin công khai của khách
`conversation.closed`	Nhân viên đóng hội thoại
`order.created`, `order.updated`	Có đơn mới hoặc đơn đổi (khi bật Đơn hàng trong chat)
`ticket.*`	Ticket mới, đổi, sắp quá hạn SLA, quá hạn (khi bật CSKH chuyên sâu)
`campaign.completed`, `contact.tagged`	Chiến dịch xong, khách được gắn thẻ (khi bật Marketing)
`kpi.period_locked`	Kỳ KPI được khoá, chỉ kèm tổng và mã kiểm tra, không có tên hay số tiền từng người

Giao nhận và an toàn

Chữ ký HMAC-SHA256 trên dấu thời gian và nội dung gốc; bí mật chỉ hiện một lần khi tạo
Trả mã 2xx trong 8 giây là thành công. Lỗi thì thử lại sau 1 phút, 5 phút, 30 phút, 2 giờ, 6 giờ rồi dừng; có nhật ký và nút Gửi lại
Chỉ nhận địa chỉ https trỏ ra internet công khai, chặn địa chỉ nội bộ, không theo chuyển hướng
Tối đa 10 địa chỉ nhận và 10 khoá API mỗi website. Khoá API chỉ hiện một lần, hệ thống lưu mã băm

API công khai

Địa chỉ gốc https://chat.hvscweb.com/api/public/v1/, khoá đặt trong tiêu đề Authorization. Giới hạn 120 yêu cầu mỗi phút cho một khoá.

API công khai
Yêu cầu	Quyền	Việc làm
`GET conversations`	Đọc	Danh sách hội thoại, phân trang
`GET conversations/{id}/messages`	Đọc	Tin công khai của hội thoại
`GET contacts`	Đọc	Tìm khách theo tên, email, số điện thoại, mã
`POST conversations/{id}/messages`	Ghi	Gửi tin hoặc ghi chú nội bộ
`PATCH conversations/{id}`	Ghi	Đổi trạng thái, mức ưu tiên

Kiểm tra chữ ký (Node.js)

crypto.createHmac('sha256', secret)
  .update(timestamp + '.' + rawBody)
  .digest('hex') === signature.slice(3)

Ghi chú. Kiểm thử bằng máy nhận giả và bộ kiểm thử tự động của HVSC. Dùng với n8n bằng nút Webhook và HTTP Request, có mẫu quy trình trong tài liệu. Chưa có sự kiện khi tạo khách mới hoặc khi khách gửi form.

Xem thêm

Đơn hàng trong chat Ticket, SLA, QA và trợ giúp KPI và hoa hồng Phân quyền chi tiết Tất cả tính năng

Muốn dùng thử cho doanh nghiệp của bạn?

Đăng ký tài khoản, đội tư vấn của HVSC sẽ liên hệ để hiểu nhu cầu và đề xuất cấu hình phù hợp.

Đăng ký Nhận tư vấn