Tích hợp dành cho nhà phát triển
Đẩy mọi sự kiện khách hàng thân thiết từ 7stamp sang hệ thống của riêng bạn trong thời gian thực. Không bỏ phiếu và không có cuộc gọi API theo lịch trình. Các sự kiện sẽ đến dưới dạng yêu cầu HTTPS POST trong vòng vài giây kể từ khi diễn ra.
Sử dụng webhooks để giữ CRM, ERP hoặc phần phụ trợ tùy chỉnh của bạn đồng bộ với những gì đang diễn ra ở phía khách hàng thân thiết: ai đã tham gia, ai đã nhận tem, ai đã đổi phiếu thưởng, ai đã kích hoạt quà tặng sinh nhật và ai đã không hoạt động. Sau đó, hệ thống của bạn sẽ quyết định phải làm gì với dữ liệu đó.
Webhooks là phần bên ngoài của ngăn xếp tích hợp. Chúng phản ánh hoạt động của khách hàng và khen thưởng vào các hệ thống mà bạn đã tin cậy để bán hàng, dịch vụ, phân tích và nhắn tin.
Mỗi con dấu, phiếu thưởng, ngày sinh nhật và trình kích hoạt không hoạt động đều ghi vào hồ sơ khách hàng trong CRM của bạn. Bạn thấy dòng thời gian trung thành đầy đủ bên cạnh doanh số bán hàng, cuộc gọi và vé mà không cần đăng nhập vào 7stamp.
Khi khách hàng đổi phiếu thưởng, hãy gửi lời cảm ơn SMS từ cổng SMS hiện có của bạn. Khi khách hàng đạt được mục tiêu, hãy đăng lời chúc mừng trong Slack. Khi ai đó không hoạt động, hãy chuyển trường hợp đó đến người quản lý tài khoản của bạn.
Truyền phát các sự kiện vào công cụ, kho hoặc quy trình đối chiếu BI của bạn. So sánh số lần đổi phiếu thưởng với biên lai POS và tính toán mức độ trung thành ROI theo số liệu của riêng bạn.
Điểm cuối của bạn phải chấp nhận HTTPS POST, xác thực hình dạng yêu cầu, duy trì hoặc xếp hàng sự kiện, sau đó trả về phản hồi 2xx thành công. Đừng thực hiện cuộc gọi CRM hoặc nhắn tin chậm trước khi xác nhận nếu nó có thể được xếp hàng an toàn.
Mọi sự kiện liên quan đều có thể mang External ID và External Source tùy chọn mà bạn đã sử dụng khi tạo hoặc quét thẻ. Sử dụng cặp này để cập nhật CRM, POS hoặc bản ghi đơn đặt hàng của riêng bạn mà không cần đoán từ tên hoặc email.
Lưu trữ khóa xử lý lâu bền hoặc dấu vân tay sự kiện trước khi kích hoạt tác dụng phụ. Nếu người nhận của bạn nhìn thấy lại giao hàng tương tự, họ sẽ không thêm ghi chú, chứng từ hoặc tin nhắn CRM trùng lặp. Hãy coi điểm cuối URL là bí mật.
json {
"event_type": "SCAN",
"scanned_at": "2026-07-23T12:34:56Z",
"user_card_id": 123,
"card_template_id": 42,
"card_template_name": "Coffee Loyalty",
"stamps_added": 1,
"stamps_before": 4,
"stamps_after": 5,
"amount": 24.5,
"external_order_id": "order_2048",
"external_id": "crm_contact_8821",
"external_source": "hubspot"
}Tạo điểm cuối HTTPS trong phần phụ trợ của bạn, lớp tích hợp CRM, Make webhook hoặc Zapier Catch Hook. Make đảm bảo bạn kiểm soát đích đến trước khi sao chép URL của nó.
Trong 7stamp Admin, mở Stamp Cards → API & Integrations → Webhooks.
Thêm điểm cuối URL và chỉ chọn các loại sự kiện mà quy trình nhận thực sự cần.
Lưu cài đặt hồ sơ, sau đó kích hoạt quét thử nghiệm dùng một lần hoặc hành động thẻ để tạo sự kiện.
Kiểm tra tải trọng đã nhận. Khớp External ID và External Source với bản ghi dự kiến và xác nhận người nhận trả lời phản hồi thành công.
Chỉ kích hoạt CRM, phiếu thưởng hoặc tác dụng phụ nhắn tin sau khi bạn đã xử lý và giám sát lỗi an toàn khi phát lại.
Trong Make, sử dụng Webhooks → Custom webhook để tạo URL nhận và dán nó vào 7stamp hồ sơ. Trong Zapier, sử dụng Webhooks by Zapier → Catch Hook cho cùng mục đích. Hồ sơ 7stamp sở hữu đăng ký vì API hiện tại không hiển thị các điểm cuối đăng ký webhook tự động.
Sử dụng phần Webhooks của tài liệu tham khảo công khai OpenAPI làm nguồn cho lược đồ tải trọng hiện tại và ý nghĩa của trường. Yêu cầu HTTPS, loại bỏ máy thu URL khỏi nhật ký công khai và khiến quá trình xử lý trở nên bình thường. Xác nhận quy trình xác thực yêu cầu/signature cho hồ sơ 7stamp của bạn trong quá trình giới thiệu trước khi thực thi tên tiêu đề cụ thể hoặc chính sách thử lại trong sản xuất.
Vâng. Chọn loại sự kiện trong cài đặt webhook của hồ sơ 7stamp để người nhận chỉ nhận được những sự kiện quan trọng đối với quy trình làm việc của mình.
Tạo webhook nhận trong Make hoặc Catch Hook trong Zapier, sao chép URL đã tạo, sau đó dán vào cài đặt webhook của hồ sơ 7stamp và gửi sự kiện thử nghiệm.
Sử dụng External ID và khi có mặt, External Source. Đây là những giá trị nhận dạng mà tiện ích tích hợp của bạn cung cấp khi thẻ được tạo hoặc quét.
Không. Hãy sử dụng hợp đồng giao hàng OpenAPI/profile hiện tại và xác nhận quy trình xác thực cho hồ sơ của bạn trong quá trình giới thiệu trước khi mã hóa cứng tiêu đề hoặc thử lại giả định.
Các trang liên quan
Bước tiếp theo
Tạo bộ thu, dán HTTPS URL vào hồ sơ, chạy quét dùng một lần và xác thực kết quả khớp External ID trước khi bật tự động hóa xuôi dòng.