API & Integrations

14. API & Integrations

Phần API & Integrations chứa các công cụ để tích hợp phần mềm 7stamp với các hệ thống bên ngoài của bạn — CRM, POS, ERP, phân tích, bot nhắn tin.

API Chìa khóa

Trang chính của phần này là danh sách khóa API. Cột:

• Tên — tên của khóa (thường giống với tên Staff được liên kết).
• Đăng nhập — Staff đăng nhập bằng khóa được ràng buộc.
• API Khóa — chính khóa đó (bắt đầu bằng 7loc_sc_..., được ẩn theo mặc định, được sao chép bằng một cú nhấp chuột).
• Trạng thái — Active.
• 🔄 — thả chìa khóa ra.
• 🗑️ — xóa chìa khóa.

Tạo khóa API

Nhấn + ADD API KEY — cửa sổ bật lên Tạo API Key sẽ mở ra:

• Máy quét — thả xuống để chọn Staff Login mà khóa sẽ được liên kết (một Staff có thể có một khóa).
• Các nút HỦY / TẠO.

Sau TẠO, khóa sẽ được tạo và xuất hiện trong danh sách. Sao chép nó ngay lập tức — khóa đầy đủ có thể không còn được hiển thị.

Có thể làm được gì thông qua API

• Cấp thẻ cho khách hàng qua email/điện thoại.
• Thêm tem cho một khách hàng cụ thể.
• Phát hành phiếu thưởng (mẫu hoặc tùy chỉnh, với Redeem Code).
• Đổi phiếu thưởng (nếu bạn làm việc thông qua POS của riêng bạn).
• Đọc trạng thái thẻ, tiến độ, lịch sử.
• Đăng ký Webhooks để nhận các sự kiện theo thời gian thực.

Webhooks

Webhooks gửi sự kiện thẻ tới hệ thống bên ngoài. Được hỗ trợ (xem thuật ngữ sự kiện):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (có kết quả).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Ví dụ về tải trọng webhook

{
 "event": "voucher_redeemed",
 "timestamp": "2026-05-11T12:34:56Z",
 "business_id": "b_123",
 "location_id": "loc_45",
 "customer": {
  "id": "c_789",
  "wallet_pass_id": "wp_abc",
  "language": "en"
 },
 "card": { "id": "card_001", "goal_index": 2 },
 "voucher": {
  "id": "v_555",
  "type": "voucher",
  "redeem_code": "FREECOFFEE",
  "redeem_code_formats": ["text", "qr", "barcode"],
  "status": "redeemed",
  "redeemed_via": "staff_scanner"
 }
}

POS tích hợp đã sẵn sàng

• Áp phích — tích hợp sẵn, được kết nối chỉ sau vài cú nhấp chuột.
• Phục vụ — sẵn sàng tích hợp.
• Các khoản thanh toán khác — được thực hiện theo yêu cầu. Miễn phí nếu có thể về mặt kỹ thuật (tức là khi thanh toán của bạn sẽ mở API hoặc Webhooks).

Tin nhắn Messenger qua 7loc.com

Đối với các thư WhatsApp, Telegram, Viber, việc tích hợp với 7loc.com được kết nối. Sau khi kích hoạt, kênh “người đưa tin” sẽ xuất hiện bên cạnh PUSH và Email trong Campaigns.

Tập lệnh không mã: Zapier và Make

7stamp API + Webhooks hoạt động với Zapier và Make (Integromat), cho phép bạn tạo tập lệnh mà không cần mã:

• “Khi voucher_redeemed — thêm thẻ vào Mailchimp.”
• “Khi goal_reached — gửi thông báo trong Slack.”
• “Khi birthday_reached — tạo một tác vụ trong CRM.”

---