无代码自动化指南

将 7stamp 连接到 Zapier — 逐步

实施指南

当您的工作流程是一个清晰的序列时使用 Zapier：出现联系人或订单， 7stamp 执行一个操作，然后更新另一个业务工具。今天的安全路由是 API by Zapier（用于传出 7stamp API 呼叫）和 Webhooks by Zapier → Catch Hook（用于传入 7stamp 事件）。

Zapier 的市场中没有公开的 7stamp 应用程序。在可用的情况下使用 API by Zapier → API Request：它将静态 API 密钥存储在应用程序连接中，而不是在 Zap 步骤中公开它。仅对传入的 Catch Hook 事件使用 Webhooks by Zapier；不要将 7stamp Bearer 键放入可见的 Webhooks 操作字段中。

打开 Zapier 打开 API 参考

从线性、可测试的 Zap 开始

保持第一个 Zap 较小。可靠的联系人到卡片或支付订单到邮票流程是比广泛的双向 CRM 同步更好的起点。

从 CRM 联系人创建邀请

在新的或合格的联系人上触发，将其 CRM ID 映射到 External ID，创建卡片邀请，并将返回的安装 URL 传递给电子邮件或SMS步骤。

结帐后添加邮票

从已付款订单或已关闭收据触发，映射客户身份和订单ID，然后将Scan Card与订单金额或明确的邮票数量一起使用。

发放一次性恢复凭证

使用 CRM 规则、支持事件或分段导出来识别客户，向其卡发放凭证，并从正确的渠道发送后续消息。

将卡牌事件写回您的CRM

使用Webhooks by Zapier > Catch Hook 接收7stamp 卡牌事件。将返回的External ID与CRM记录进行匹配，并添加相关注释、标签或任务。现在

7stamp操作，通过Zapier

Add API by Zapier → API Request after your trigger. Create one 7stamp API-key connection, then select the exact method and full URL below. Each operation returns fields that you can map into the next Zap step.

API 通过 Zapier 操作 POST /cards/invite

创建 Card Invite

为一个外部联系人创建新的钱包卡安装 URL 和交付插入代码。

Required
external_id。
下一步
将 install_url 映射到电子邮件、SMS 或 CRM 字段。
API 通过 Zapier 操作 POST /cards/invite/bulk

批量创建 Card Invites

从受控的 JSON 批次中创建最多 100 个邀请链接。

必需
包含 1–100 个邀请对象的项目数组。
检查
在交付前阅读success_count、error_count以及每个结果。
API 通过 Zapier 操作 POST /cards/scan

Scan Card

按 User Card ID 或 External ID 添加邮票，包含金额、邮票数量、订单ID，以及可选的收据数据。

身份
external_id加上可选的external_source；如果两者都在场，则user_card_id获胜。
印花规则
stamps_count 优先于金额。
API 通过 Zapier 操作 POST /vouchers/issue

Issue Voucher

直接向持卡人发放代金券。

需要
优惠券。short_description和目标external_id或已知user_card_id。
结果
将 unique_code、状态或 expires_at 映射到 CRM 注释或消息。
API 通过 Zapier 操作 POST /messages/send

Send Message

将钱包卡推送和 /or 电子邮件内容发送给卡所有者。

卡片推送
card_push_text仅限20个字符。
电子邮件
主题加正文；结果报告交付是否已排队。
API 通过 Zapier 操作 GET /cards

Find Cards

按 External ID 查找卡片记录，具有可选的源和模板过滤器。

需要
external_id 作为查询参数。
首先使用
当您的规则避免重复邀请时，请在创建邀请之前使用。
API 通过 Zapier 操作 GET /cards/{user_card_id}

获取卡详细信息

通过卡的 7stamp 内部 ID 读取卡的状态。

必需
将 {user_card_id} 替换为 7stamp 返回的 ID。
有用的输出
stamps_count、钱包状态和active_vouchers_count。
API by Zapier 操作 GET /templates

List Templates

列出可用于已连接配置文件的模板并验证 API 连接。

第一次测试
在任何写入操作之前调用它：它不会更改客户数据。
稍后使用
当存在多个模板时，活动 ID 变为 template_id。
API 通过 Zapier 操作 GET /templates/{template_id}/design

Get Template Design

检索已知模板 ID 的模板设计设置。

Zapier触发 Webhooks by Zapier → Catch Hook

接收卡片事件

Catch Hook给Zapier一个独特的HTTPSURL。将其粘贴到 7stamp Admin 的 webhook 设置中并使用真实的卡片事件进行测试。

在 Zapier
使用 Catch Hook 解析事件数据；仅当您还需要原始请求标头/body.
匹配
Find the CRM contact using external_id and optional external_source from the event.

三个Zapier 可以逐步构建的工作流程

每个场景都使用真实的、当前可用的 Zapier 模块。首先建立一条小路线，并在打开 Zap 之前使用一次性触点对其进行测试。

1. 合格CRM联系→发卡

预期结果: 下一步Zap收到install_url，可以发送给客户或写回CRM记录。

  1. 1 创建 Zap 并选择 CRM 事件，这意味着联系人有资格获得忠诚度。测试触发器并确认您拥有联系人的不可变ID。
  2. 2 添加API by Zapier → API Request。创建或选择7stamp API键连接，选择POST，并将URL设置为https://api.7loc.com/cards-api/cards/invite.
  3. 3 将正文设置为JSON。将CRM ID映射到external_id，设置一个固定的external_source，例如kommo，仅当多个7stamp模板处于活动状态时才添加template_id。
  4. 4 测试动作。确认响应包含相同的 external_id 的 install_url 和 delivery_insert_code。
  5. 5 添加您的 CRM 更新、电子邮件或 SMS 操作。从 API 响应映射 install_url；不要硬编码或复制测试URL。

检查: 创建 Card Invite 始终返回新的邀请。如果您的政策是每个联系人一次邀请，请先添加 Find Cards 请求或 Zapier 过滤器。

2. 已付款订单→奖励邮票

预期结果: 订单创建可追溯的7stamp扫描，Zap可以在源系统中记录stamps_added或scan_id。

  1. 1 使用付费订单/Closed 收据触发器并进行测试。在继续之前，请确认客户 ID 和唯一订单 ID 都存在。
  2. 2 添加 API by Zapier → API Request 与 POST https://api.7loc.com/cards-api/cards/scan 并选择相同的 7stamp 连接。
  3. 3 发送 JSON 以及 external_id、external_source、external_order_id，以及基于金额的模板的金额或 stamps_count 以获得明确的邮票奖励。
  4. 4 使用一次性订单进行测试。检查响应中的成功、scan_id和stamps_added。
  5. 5 添加一个仅在成功响应后才继续的过滤器，然后使用确认的结果更新 order/CRM。

检查: 如果重播 Zap，请在发送另一次扫描之前检查原始顺序。保持 external_order_id 稳定，以便稍后可以协调事件。

3. 7stamp 事件 → 创建 CRM 注释或任务

预期结果: Zapier 接收已解析的 7stamp 事件，通过 external_id 找到客户，并创建适当的后续行动。

  1. 1 以 Webhooks by Zapier 作为触发器创建一个新的 Zap。选择 Catch Hook，继续，然后复制测试步骤中显示的唯一 URL。
  2. 2 在7stamp Admin中，打开API & Integrations → Webhooks，添加Catch Hook URL，仅选择需要的事件类型，然后保存。
  3. 3 引发真实的测试扫描或卡事件。返回Zapier，单击Test trigger并确认event_type、external_id和external_source作为示例字段到达。
  4. 4 使用external_id 添加CRM 查找联系人操作。为 event_type 添加过滤器或路径规则，例如将 SCAN 与 REWARD_EARNED 分开。
  5. 5 创建CRM 注释/task 并仅映射该事件存在的字段，例如scanned_at、stamps_after、external_order_id 或issued_vouchers。

检查: A Catch Hook URL 是一个秘密。如果Zap已转让给其他所有者，请在依赖它之前更新7stamp Admin中的URL。

在构建 Zap 之前创建 7stamp API 密钥

这些是 7stamp 侧步骤。执行此操作一次，然后仅在 API by Zapier 连接内使用该密钥，而不是在 Webhooks by Zapier 操作字段或注释中。

7stamp Admin API 与集成屏幕，其中包含 Add API Key 操作
打开 API 与集成，选择 API Keys，然后在帐户设置允许的情况下为 Zap 创建一个单独的密钥。
新生成的 7stamp API 密钥已准备好复制
通过 Zapier 连接将密钥复制到安全的 API 中，而不是复制到明文 Webhooks 步骤或共享文档中。

防止数据不匹配的连接规则

将 API 密钥保留在 Zapier 连接的 API 中

在 7stamp Admin 中，选择 API & Integrations → API Keys → Add API Key。在 API 和 Zapier 中，创建一个 API 键连接，其中包含静态 Authorization 标头，其中包含 Bearer，后跟该键。 API by Zapier 将凭证保留在连接中，而不是可见的 Zap 步骤；限制对连接的访问​​，并在密钥暴露时轮换密钥。

地图External ID和External Source一致

External ID是您自己稳定的客户标识符； External Source 标记其来源，例如 hubspot、bitrix24、shopify 或海报。使用同一对创建、查找、扫描、凭证和 Webhook 流程。

了解哪个卡标识符获胜

卡定位操作接受 User Card ID 或 External ID。当两者都存在时，User Card ID优先。仅在受信任的 7stamp 步骤返回后才使用内部 ID；否则更喜欢源系统External ID。

准确 API 通过 Zapier 请求：奖励一枚邮票

将其复制到您的自动化步骤中 http 
Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
  Authorization: Bearer YOUR_7STAMP_API_KEY
  Content-Type: application/json
Data:

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "stamps_count": 1,
  "external_order_id": "order_2048"
}

构建您的第一个 Zap

01

在管理中创建7stamp API 密钥：API & Integrations → API Keys → Add API Key。如果可用，请使用单独的测试密钥/profile。

02

在Zapier中，创建一个Zap并测试源触发器。使用真实样本，以便可以映射联系人 ID、客户 ID、订单 ID 和金额。

03

添加API by Zapier → API Request。为静态 Bearer Authorization 标头创建 7stamp 连接，而不是将密钥放入 Webhooks by Zapier 操作字段中。先拨打

04

拨打GEThttps://api.7loc.com/cards-api/templates。这确认了关键工作并显示了哪些活动模板 ID 可用，而无需修改客户数据。

05

选择 POST /cards/invite 或 POST /cards/scan，将 JSON 设置为主体类型，并映射稳定的 External ID 加上相关模板/order 字段触发。

06

使用一次性联系人运行操作，检查其确切的响应字段，然后将这些字段映射到下一个 CRM、电子邮件或消息传递步骤，然后再发布 Zap。

仅对记录的路由使用通用请求

将 API 与 Zapier 用于带有 Bearer API 键的 7stamp 请求：它将静态标头键保留在应用程序连接中。使用 Webhooks by Zapier 进行 Catch Hook 事件传递，而不是作为 7stamp 秘密的首选位置。将基础 URL 保留在 https://api.7loc.com/cards-api, 使用公共 OpenAPI 参考来获取确切的架构，并且切勿将凭据或客户数据发送到未经验证的 URL。

通过 Catch Hook 接收 7stamp 事件

创建 Webhooks by Zapier → Catch Hook，复制测试设置中显示的唯一 URL，将其粘贴到 7stamp 配置文件的 Webhook 设置中，选择事件类型，然后发送真实的测试扫描或卡事件。使用事件负载的 External ID 和 External Source 查找正确的 CRM 联系人。仅当您特别需要未解析的正文和请求标头时，才选择Catch Raw Hook。

使用安全Zapier路线

API通过Zapier和Catch Hook足以满足每个公共7stamp API操作和卡事件。如果您需要未来的原生 7stamp Zapier 应用程序，请将您的团队最常使用的确切操作/trigger 发送给我们。

询问原生连接器

常见问题

在哪里可以找到 Zapier 中的 7stamp 应用程序？

今天没有公共 7stamp 市场应用程序。使用 API by Zapier → API Request 进行 7stamp API 呼叫，使用 Webhooks by Zapier → Catch Hook 进行传入 7stamp 事件。

在哪里创建 Zapier 代币？

在管理中的API & Integrations → API Keys → Add API Key下创建一个7stamp API密钥。将其作为静态 Bearer Authorization 标头存储在 API by Zapier 连接中，而不是存储在可见的 Webhooks by Zapier 操作字段中。

Zapier如何领取印章或优惠券活动？

在Webhooks by Zapier中创建Catch Hook，将生成的URL粘贴到7stamp配置文件的Webhook设置中，选择事件，并在启用CRM更新之前发送测试事件。

我应该选择Zapier还是Make？

选择 Zapier 以获得大部分线性触发操作工作流程。当您需要路由器、复杂转换或长时间的多分支场景时，请选择Make。两者都使用相同的 7stamp API 密钥和端点。

相关页面

打开Zapier API由Zapier帮助 ZapierCatch Hook帮助 7stamp API参考 Webhook设置 Make指南

下一步

使用测试联系人构建第一个Zap

创建API密钥，测试GET /templates 到 API 再到 Zapier，然后构建一个联系人到卡片或订单到图章操作。一旦出站流具有经过验证的测试结果，请添加Catch Hook。

打开7stamp Admin 读取API参考