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ý
Với mỗi lần gửi, hãy đọc timestamp (t) và chữ ký (v1) từ header chữ ký, rồi tính HMAC-SHA256 của chuỗi "{timestamp}.{raw request body}" bằng khóa bí mật ký của bạn và so với giá trị v1. Từ chối mọi yêu cầu không khớp, hoặc có timestamp cũ hơn 5 phút, để bạn chỉ xử lý những payload còn mới và thực sự đến từ Mercateer. (Hàm verify trong SDK của chúng tôi làm sẵn tất cả những việc này cho bạn.)
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