API 与集成

14. API 与集成

[截图：0601_Apikey.png]

API 和集成 部分包含用于将7stamp 与外部系统（CRM、POS、ERP、分析、消息机器人）进行编程集成的工具。

API Keys

该部分的主页是API键列表。栏目：

• 名称 — 键名称（通常与链接的员工名称匹配）。
• 登录 — 密钥所绑定的员工登录名。
• API Key — 密钥本身（以 7loc_sc_... 开头，默认隐藏，一键复制）。
• 状态 —“活动”。
• 🔄 — 重新生成密钥。
• 🗑️ — 删除密钥。

创建 API 密钥

[截图：0602_Apikey.png]

点击 + ADD API KEY — 将打开 Generate API Key 弹出窗口：

• 扫描仪 — 下拉菜单中选择密钥将绑定到的Staff Login（一名员工可以拥有一把密钥）。
• 按钮 取消 / 生成。

GENERATE 之后，密钥将被创建并显示在列表中。立即复制 — 完整密钥可能不会再次显示。

您可以通过API做什么

• 通过电子邮件/电话向客户发行卡。
• 向特定客户添加stamp。
• 签发凭证（模板或自定义，带有Redeem Code）。
• 兑换优惠券（如果您通过自己的POS工作）。
• 读取卡片的状态、进度、历史记录。
• 订阅 Webhooks 以实时接收事件。

网络钩子

Webhook 将卡片事件发送到外部系统。支持（参见事件词汇表）：

• “卡已发行”、“卡已保存”、“卡已打开”。
• stamp_added。
• “目标达成”、“奖励发放”。
• 优惠券_已发行、优惠券_兑换、优惠券_过期。
• lottery_played（结果）。
• 已达到生日。
• 不活动触发。
• 营销活动已发送。

Webhook 负载示例

{
"event": "优惠券兑换",
"时间stamp": "2026-05-11T12:34:56Z",
“business_id”：“b_123”，
“location_id”：“loc_45”，
“顾客”： {
“id”：“c_789”，
"wallet_pass_id": "wp_abc",
“语言”：“en”
  },
“卡”：{“id”：“card_001”，“goal_index”：2}，
“代金券”： {
“id”：“v_555”，
“类型”：“优惠券”，
"redeem_code": "免费咖啡",
"redeem_code_formats": ["文本", "qr", "条形码"],
"status": "已赎回",
“redeemed_via”：“staff_scanner”
  }
}

现成的 POS 集成

• Poster — 现成的集成，只需点击几下即可连接。
• 服务——现成的集成。
• 其他收银机 — 根据要求制作。 如果技术上可行，则免费（即，您的收银机公开开放的 API 或 Webhooks）。

Messenger 通过 7loc.com 进行广播

对于 WhatsApp、Telegram、Viber 广播，已连接 7loc.com 集成。一旦激活，“messengers”通道将在“PUSH”和Email 旁边的“Campaigns”中可用。

无代码场景：Zapier 和 Make

7stamp API + Webhook 与 Zapier 和 Make (Integromat) 配合使用，让您无需编码即可构建场景：

• “当voucher_redeemed时——在Mailchimp中添加一个标签”。
• “当goal_reached时——发送通知到Slack”。
• “当birthday_reached时——在CRM中创建一个任务”。

---