Nhận sự kiện lễ tân từ Mercateer dưới dạng webhook
Đăng ký một endpoint để nhận sự kiện từ Mercateer và nhận dữ liệu đã ký ngay khi cuộc gọi kết thúc, có khách hàng tiềm năng mới hoặc công việc được đặt lịch. Đăng ký và quản lý endpoint qua API hoặc bảng điều khiển, và xác minh từng bản gửi bằng HMAC.
Webhooks là gì?
Webhook đẩy các sự kiện lễ tân từ Mercateer đến URL do bạn quản lý theo thời gian thực, giúp hệ thống của bạn phản hồi ngay mà không cần chủ động gọi API. Mỗi lần gửi là một payload JSON được ký bằng HMAC; bạn đăng ký và quản lý endpoint qua API hoặc bảng điều khiển, và các lần gửi thất bại sẽ được thử lại theo cơ chế lùi dần.
Bạn có thể làm gì với Webhooks
Cài đặt trong vài phút
Tạo một endpoint
Đăng ký URL của bạn và chọn các sự kiện muốn theo dõi, thông qua API hoặc tại Cài đặt > Nhà phát triển. Mercateer sẽ trả về một bí mật ký (signing secret) dành riêng cho endpoint đó. Quyền truy cập API đã được bao gồm trong các gói Crew và Fleet.
Xác minh chữ ký
IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)
Xử lý các lần thử lại một cách idempotent
Phản hồi mã 2xx nhanh chóng để xác nhận đã nhận. Các lần gửi thất bại sẽ được thử lại theo cơ chế lùi dần, vì vậy hãy dùng ID sự kiện làm khóa xử lý để bỏ qua bản trùng và chỉ xử lý mỗi sự kiện một lần duy nhất.
Câu hỏi thường gặp
Tương thích với toàn bộ hệ thống công cụ của bạn
Mercateer sử dụng cùng giao thức như những công cụ bạn đang dùng.
Sử dụng Mercateer cùng Webhooks
Bắt đầu miễn phí và kết nối bộ phận lễ tân của bạn trong vài phút.
Không cần thẻ tín dụng