Webhook làm gì
Webhook gửi thông tin của một sự kiện trong cửa hàng tới nơi khác ngay khi sự kiện xảy ra. Bạn chọn sự kiện và nơi nhận:
- API: Storeep gửi dữ liệu sự kiện tới một địa chỉ web (URL) của máy chủ, CRM, kịch bản Zapier hoặc Make, hoặc công cụ theo dõi quảng cáo của bạn.
- Email: Storeep gửi dữ liệu sự kiện tới một địa chỉ email, ví dụ để nhận email cho mỗi đơn hàng mới.
Mở Cài đặt > Webhook. Bạn cần quyền Cài đặt.
Nhiều công cụ đã có sẵn ứng dụng riêng, dễ dùng hơn: Google Sheets, mạng lưới đơn vị vận chuyển và pixel quảng cáo. Hãy xem Chợ ứng dụng trước.
Tạo webhook
Nhấn Thêm webhook mới, điền biểu mẫu và nhấn Thêm.
- Kích hoạt: được đánh dấu theo mặc định. Khi được đánh dấu, sự kiện được gửi ngay. Bỏ đánh dấu để giữ webhook nhưng tạm dừng nó.
- Tên: nhãn trong danh sách của bạn, ví dụ "Đơn mới gửi CRM".
- Loại: API hoặc Email.
- Sự kiện:
- Đơn hàng được tạo: khách hàng đặt một đơn mới.
- Đơn hàng được cập nhật: trạng thái hoặc thông tin của đơn hàng thay đổi.
- Phiên truy cập được tạo: một khách truy cập mới vào cửa hàng. Chỉ dành cho loại API.
- Định dạng: Json.
- URL (loại API): địa chỉ nhận dữ liệu. Phần
https://được thêm sẵn, nên bạn chỉ gõ phần còn lại, ví dụapi.example.com/orders. - Địa chỉ email (loại Email): nơi email được gửi tới.
Webhook Email chỉ gửi sự kiện đơn hàng. Nếu bạn chọn Email với Phiên truy cập được tạo, sẽ không có gì được gửi.
Đưa dữ liệu đơn hàng vào URL
Bạn có thể đặt bất kỳ trường nào của dữ liệu sự kiện vào URL bằng dấu ngoặc nhọn kép, {{field_name}}. Ví dụ:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
URL này gửi Facebook click ID và tổng tiền đơn hàng tới một nền tảng theo dõi quảng cáo hoặc tiếp thị liên kết, không cần thêm máy chủ nào. Trường không tồn tại sẽ thành giá trị trống. Để xem tên các trường, hãy tạo một webhook Email cho cùng sự kiện và xem dữ liệu bạn nhận được.
Danh sách webhook
Mỗi dòng hiển thị Tên, URL / Email, Loại, Sự kiện, Định dạng và Trạng thái (Đã kích hoạt hoặc Đã vô hiệu hóa). Nhấn vào một dòng để sửa. Đánh dấu các dòng và chọn Xóa webhook để xóa vĩnh viễn. Mỗi cửa hàng có số lượng webhook tối đa, và bạn sẽ thấy thông báo khi đạt đến mức đó.
Bạn có thể tạo nhiều webhook cho cùng một sự kiện, ví dụ một cái gửi tới CRM và một cái gửi tới công cụ theo dõi quảng cáo.
Khi gửi thất bại
- Máy chủ của bạn nên trả lời nhanh bằng mã thành công (2xx). Trả lời chậm được tính là thất bại.
- Nếu máy chủ ngừng hoạt động hoặc quá tải (trả lời 5xx hoặc 429, hoặc không trả lời), Storeep thử lại nhiều lần trong vài phút tiếp theo. Chỉ những webhook thất bại mới được gửi lại, nên các webhook khác không bị trùng lặp.
- Nếu máy chủ từ chối yêu cầu (trả lời 4xx như 404 hoặc 403), Storeep không thử lại, vì địa chỉ hoặc cấu hình bảo mật của nó bị sai.
- Khi một webhook thất bại nhiều lần liên tiếp, chủ cửa hàng nhận một email: "Cần xử lý: webhook Storeep của bạn đang bị lỗi", kèm tên webhook, địa chỉ, sự kiện và mã lỗi gần nhất. Sau khi webhook hoạt động lại, một sự cố mới trong tương lai có thể gửi cảnh báo mới. Bạn có thể tắt email này trong Thông báo.
- Webhook Email được gửi một lần, không thử lại.
Webhook bị tạm dừng do số dư chưa thanh toán
Nếu cửa hàng có số tiền phải trả chưa thanh toán và ví không đủ để trả, webhook sẽ chờ. Chúng được gửi sau khi bạn nạp tiền và khoản đó được thanh toán. Xem Ví và thanh toán.
Mẹo
- Nếu máy chủ của bạn cần mật khẩu hoặc khóa, hãy đặt nó trong phần truy vấn của URL, ví dụ
?key=yoursecret. - Phiên truy cập được tạo được kích hoạt với mọi khách truy cập, có thể rất nhiều với cửa hàng đông khách. Chỉ dùng nếu máy chủ của bạn chịu tải được.
- Để một công cụ đọc đơn hàng và sản phẩm bất cứ khi nào nó muốn, hãy dùng access token.