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 {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}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 URL của điểm cuối. Webhook nhận mọi sự kiện thẻ của hồ sơ, vì vậy hãy lọc theo data.event_type ở phía nhậ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.
Dùng phần Webhooks trong tài liệu tham khảo OpenAPI công khai làm nguồn cho lược đồ dữ liệu hiện tại. Phần thân là một phong bì: profile_id và profile_name cho biết hồ sơ 7Stamp, event_id định danh sự kiện, còn bản thân sự kiện thẻ nằm trong data (với URL của Make hoặc Zapier, khóa là card_event). Mỗi lần gửi được ký trong một header duy nhất, X-Webhook-Signature: t=…,s=…. Tính HMAC-SHA256 bằng khóa bí mật của webhook trên t cộng với phần thân thô của yêu cầu, mã hóa kết quả dạng hex và so sánh với s; khóa bí mật nằm trên trang của webhook trong 7Stamp Admin. Dùng X-Webhook-Event-Id để loại bỏ các lần gửi lặp lại: lần thử lại được ký lại với một t mới. Bạn cũng có thể bảo vệ điểm cuối bằng Basic Auth. Bắt buộc dùng HTTPS và không để URL của bên nhận xuất hiện trong log công khai.
Không. Webhook của 7Stamp nhận mọi sự kiện thẻ của hồ sơ. Hãy lọc theo data.event_type ở phía nhận; trong Make và Zapier, sự kiện nằm trong card_event, vì vậy hãy lọc theo card_event.event_type.
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.
Dùng data.external_id và, nếu có, data.external_source: chúng được trả về trong mọi webhook cho các thẻ bạn đã phát hành qua API bằng ID của riêng bạn. Khách hàng tự lấy thẻ sẽ không có External ID, vì vậy hãy đối chiếu họ theo data.user.email. Địa chỉ “Hide My Email” của Apple là địa chỉ chuyển tiếp, không phải địa chỉ có trong CRM của bạn.
Tách header X-Webhook-Signature thành t và s, tính HMAC-SHA256 bằng khóa bí mật của webhook từ 7Stamp Admin trên t cộng với phần thân thô của yêu cầu, mã hóa kết quả dạng hex và so sánh với s. Lấy t đúng như khi được gửi và lấy phần thân dưới dạng các byte thô đã nhận, trước mọi bước phân tích JSON. Loại bỏ lần gửi có X-Webhook-Event-Id mà bạn đã xử lý: lần thử lại được ký lại với một t mới.
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.