将忠诚度历史记录反映到您的CRM
每个印章、优惠券、生日和不活动触发器都会记录在您的 CRM 中的客户记录中。您无需登录7stamp，即可在销售、电话和门票旁边看到完整的忠诚度时间表。
开发人员集成
7stamp Webhooks
可用将每个忠诚度活动从 7stamp 实时推送到您自己的系统。没有轮询，也没有预定的 API 呼叫。事件在发生后几秒内作为 HTTPS POST 请求到达。
使用 webhook 使您的 CRM、ERP 或自定义后端与忠诚度方面发生的情况保持同步：谁加入、谁获得印章、谁兑换优惠券、谁触发生日礼物以及谁变得不活跃。然后您的系统决定如何处理这些数据。
使用 Webhooks 可以执行的操作
Webhooks 是集成堆栈的出站端。它们将客户和奖励活动反映到您已经信任的销售、服务、分析和消息传递系统中。
触发您自己的消息堆栈
当客户兑换优惠券时，从您现有的 SMS 网关发送感谢SMS。当客户进球时，在Slack中发布庆祝信息。当有人变得不活跃时，请将案例转交给您的客户经理。
强大的分析和协调
将事件流式传输到您的 BI 工具、仓库或协调管道中。将优惠券兑换与 POS 收据相匹配，并按照您自己的指标计算忠诚度 ROI。
卡事件类型
SCAN — 卡收到扫描/stamp 操作。
REWARD_EARNED — 该卡已获得奖励。
VOUCHER_ISSUED — 已发放优惠券。
VOUCHER_REDEEMED — 兑换券已兑换。
LOTTERY_WIN — 抽奖中奖了。
DELIVERY_INSERT — 记录了交付-插入流程。
CARD_JOINED — 一位客户加入了一张卡。
CARD_CAMPAIGN — 发生卡牌活动。
BIRTHDAY_GREETING — 发生生日祝福活动。
ADMIN_VOUCHER_ISSUE — 管理员发放凭证。
CARD_ADDED_TO_WALLET — 客户将卡添加到钱包中。
CARD_REMOVED_FROM_WALLET — 一位顾客从钱包中取出了该卡。
构建安全的webhook接收器
持久处理后确认
您的端点应该接受HTTPS POST，验证请求形状，将事件持久化或排队，然后返回成功的 2xx 响应。如果可以安全排队，请不要在确认之前进行缓慢的 CRM 或消息调用。
与External ID
关联 每个相关事件都可以携带您在创建或扫描卡片时使用的External ID 和可选的External Source。使用此对更新您自己的 CRM、POS 或订单记录，而无需根据姓名或电子邮件进行猜测。
Make 传递幂等
在触发副作用之前存储持久的处理密钥或事件指纹。如果您的收件人再次看到相同的递送，则不应添加重复的 CRM 注释、凭证或消息。将端点 URL 视为秘密。
事件负载形状示例
将其复制到您的自动化步骤中
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"
}配置并测试 Webhook
在后端创建 HTTPS 端点、CRM 集成层、Make webhook 或 Zapier Catch Hook。 Make 确保在复制URL 之前控制目标。
在7stamp Admin，打开Stamp Cards → API & Integrations → Webhooks。
添加端点 URL 并仅选择接收工作流实际需要的事件类型。
保存配置文件设置，然后触发一次性测试扫描或卡操作以生成事件。
检查接收到的有效负载。将External ID和External Source与预期记录进行匹配，并确认接收方返回成功的响应。
仅在进行重放安全处理和故障监控后，才启用 CRM、凭证或消息传递副作用。
无代码选项：Make 和 Zapier
在Make 中，使用Webhooks → Custom webhook 生成接收URL 并将其粘贴到7stamp简介。在Zapier中，使用Webhooks by Zapier → Catch Hook达到同样的目的。 7stamp 配置文件拥有订阅，因为当前 API 不公开自动 Webhook 注册端点。
安全及交付合同
使用公共 OpenAPI 参考的 Webhooks 部分作为当前有效负载架构和字段含义的来源。要求HTTPS，使接收者URL远离公共日志，并使处理幂等。在生产中强制执行特定标头名称或重试策略之前，请在入职期间确认您的 7stamp 配置文件的请求身份验证/signature 过程。
常见问题
我可以仅选择某些 Webhook 事件吗？
是的。在 7stamp 配置文件的 Webhook 设置中选择事件类型，以便接收器仅获取对其工作流程重要的事件。
如何将 webhooks 连接到 Make 或 Zapier？
在 Make 中创建接收 Webhook 或在 Zapier 中创建 Catch Hook，复制生成的 URL，然后将其粘贴到 7stamp 配置文件的 Webhook 设置中并发送测试事件。
我应该如何将活动与我的 CRM 联系人匹配？
使用External ID，如果存在，External Source。这些是您的集成在创建或扫描卡时提供的标识符。
我应该假设签名标头还是重试时间？
否。请使用当前的 OpenAPI/profile 交付合同，并在入职期间确认您的个人资料的身份验证程序，然后再对标头进行硬编码或重试假设。
下一步
准备好发送第一张卡片事件了吗？
创建接收器，将其 HTTPS URL 粘贴到配置文件中，运行一次性扫描，并在启用下游自动化之前验证匹配的 External ID。