Tạo và cập nhật Webhook
Hướng dẫn tạo webhook để gửi sự kiện từ Cropany sang hệ thống bên ngoài.
Webhook giúp Cropany tự động gửi thông tin sang hệ thống bên ngoài khi một sự kiện được chọn xảy ra, ví dụ đơn hàng được thêm mới hoặc sản phẩm được cập nhật.
Vị trí thao tác
Vào trang Webhook trong nhóm cài đặt tích hợp. Nhấn Thêm mới để tạo webhook hoặc nhấn vào bản ghi cần sửa trong danh sách.
Giao diện tổng thể
Form webhook gồm thông tin sự kiện, địa chỉ nhận dữ liệu, trạng thái và danh sách header bổ sung nếu hệ thống nhận webhook yêu cầu.
Thông tin cần nhập
| Trường | Bắt buộc | Ghi chú |
|---|---|---|
| Nhóm sự kiện | Có | Chọn nhóm nghiệp vụ, ví dụ đơn hàng, khuyến mãi, khách hàng hoặc sản phẩm. |
| Sự kiện | Có | Chọn sự kiện cụ thể trong nhóm đã chọn. |
| URL nhận webhook | Có | Địa chỉ hệ thống bên ngoài sẽ nhận dữ liệu webhook. |
| Trạng thái | Không | Dùng để bật hoặc tạm ngưng webhook. |
| Header | Không | Nhập các cặp tên và giá trị header nếu endpoint nhận webhook yêu cầu xác thực hoặc cấu hình riêng. |
Nhóm sự kiện và sự kiện hỗ trợ
Sau khi chọn nhóm sự kiện, danh sách sự kiện sẽ thay đổi theo nhóm đó.
| Nhóm | Ví dụ sự kiện có thể chọn |
|---|---|
| Đơn hàng | Thêm mới đơn, cập nhật đơn, thêm hoặc xoá sản phẩm trong đơn. |
| Khuyến mãi | Thêm mới hoặc cập nhật chương trình khuyến mãi. |
| Kho hàng | Tạo hoặc cập nhật phiếu nhập, phiếu xuất kho. |
| Khách hàng | Thêm mới hoặc cập nhật khách hàng. |
| Sản phẩm | Thêm, sửa, xoá sản phẩm hoặc biến thể sản phẩm. |
| Thu chi | Thêm mới hoặc cập nhật phiếu thu chi. |
Khi đổi nhóm sự kiện, lựa chọn sự kiện cũ sẽ được xoá để bạn chọn lại sự kiện phù hợp với nhóm mới.
Header
Mỗi header gồm một tên và một giá trị. Nhấn Thêm hàng để thêm header mới hoặc nút xoá trên từng dòng để bỏ header không dùng nữa.
Nếu nhập nhiều header trùng tên, hệ thống nhận webhook có thể chỉ sử dụng giá trị cuối cùng. Nên đặt tên header rõ ràng và không trùng lặp.
Các lối đi từ trang
- Sau khi lưu thành công, danh sách webhook được cập nhật.
- Tab Webhook trong cài đặt: Tab API/Webhook.
Lưu ý - Lỗi thường gặp
- Đổi nhóm sự kiện làm mất sự kiện đã chọn: đây là hành vi bình thường để tránh lưu sai sự kiện.
- Không dùng được webhook: kiểm tra gói phần mềm có hỗ trợ tích hợp webhook không.
- URL nhận không hoạt động: kiểm tra URL có truy cập được từ bên ngoài và hệ thống nhận webhook có ghi nhận yêu cầu hay không.
- Header trùng tên: đặt tên header duy nhất nếu cần gửi nhiều giá trị khác nhau.
- Không có nhóm sự kiện cần dùng: liên hệ đội hỗ trợ để kiểm tra khả năng bổ sung sự kiện.
Ai được xem và chỉnh?
- Cần quyền cài đặt nâng cao để tạo hoặc sửa webhook.
- Tab Webhook trong cài đặt chỉ hiển thị khi tài khoản và gói phần mềm có quyền phù hợp.