Salezy
Hướng dẫn sử dụng

API và webhook: nối Salezy với hệ thống khác

Tạo khoá API để website hay ứng dụng của bạn đọc và tạo dữ liệu Salezy, và thêm webhook để Salezy tự gửi sự kiện như lead mới, đơn hàng mới.

Cập nhật 10/10/2026
Trong bài này

Salezy có Public API v1 để hệ thống của bạn gọi vào (đọc/tạo lead, liên hệ, đọc cơ hội, đơn hàng…) và webhook để Salezy chủ động gửi sự kiện ra ngoài. Tài liệu kỹ thuật đầy đủ cho lập trình viên ở Tài liệu cho nhà phát triển và API Reference.

Trước khi bắt đầu

Chỉ chủ tổ chức và người có quyền quản trị tổ chức mới vào được Cài đặt › Tích hợp.

Tạo khoá API

  1. Vào Cài đặt › Tích hợp, kéo tới khối Khóa API, bấm Tạo khóa API.

  2. Đặt Tên khóa theo nơi dùng (ví dụ “Website bán hàng”) và tích các Quyền cần thiết (Đọc lead, Tạo lead, Đọc liên hệ…).

  3. Sao chép khoá ngay. Hộp thoại có sẵn lệnh mẫu để thử gọi API.

Lưu ý: Khoá chỉ hiện một lần. Hãy lưu vào nơi an toàn; mất khoá thì thu hồi và tạo khoá mới. Khoá bị thu hồi thì ứng dụng đang dùng nó không gọi được API nữa.

Thêm webhook

  1. Ở khối Webhook, bấm Thêm webhook, nhập Địa chỉ nhận (URL).

  2. Chọn Tất cả sự kiện CRM (trừ tin nhắn) hoặc Chọn sự kiện theo nhóm: Lead, Liên hệ, Cơ hội, Đơn hàng, Phiếu hỗ trợ, Form, Hội thoại. Bấm Thêm webhook.

  3. Lưu Mã bí mật hiện ra — hệ thống của bạn dùng mã này để kiểm chữ ký X-Salezy-Signature của mỗi lần gửi.

  4. Bấm Gửi thử để kiểm tra, mở Nhật ký để xem từng lần gửi thành công hay lỗi, dữ liệu đã gửi và phản hồi nhận được.

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

Không biết lập trình có dùng được không?

Có thể nối qua các công cụ tự động hoá không cần code nhận webhook — xem mục kết nối không code ở trang Tài liệu cho nhà phát triển. Nếu chỉ cần gửi dữ liệu một bản ghi khi có sự kiện, bước Gửi dữ liệu sang hệ thống khác (webhook) trong Tự động hoá cũng làm được.

Webhook gửi lỗi thì sao?

Salezy tự gửi lại sau một khoảng thời gian; nhật ký ghi rõ trạng thái từng lần. Hết lượt tự gửi, bạn bấm Gửi lại trong nhật ký.

Bài này có hữu ích không?

Bài liên quan