在新的CRM联系人
之后创建一张卡片 使用CRM联系人ID作为External ID，创建一个7stamp卡片邀请，然后发送返回的安装URL 通过您常用的电子邮件、SMS 或消息传递步骤。
无代码自动化指南
将 7stamp 连接到 Make — 一步一步
实施指南使用 Make 将 7stamp 与 CRM、POS、在线商店、电子表格、消息传递工具或任何可以将数据发送到场景的系统连接。今天的生产就绪路由是用于 7stamp API 呼叫的 Make 的 HTTP 应用程序和用于传入 7stamp 事件的 Make 的 Custom webhook。
Make 的应用程序选择器中还没有公开的 7stamp 应用程序。不要等待：添加 HTTP → Make a request，使用确切的 URL、方法、Bearer 标头和下面的 JSON，然后映射源模块中的字段。这与未来连接器将使用的7stamp Integration API相同。
选择与您的工作流程匹配的第一个场景
从一个事件和一个结果开始。一旦测试数据正确，就添加过滤器、路由器、CRM更新以及围绕它的后续消息。
支付订单后添加邮票
从支付POS 或电子商务订单触发场景。将其稳定客户ID和订单ID映射到扫描卡中，然后使用金额或明确的邮票计数。
发送奖励后续
当卡事件报告奖励或优惠券时，分支场景：更新CRM，通知团队，仅在需要时发送钱包卡推送或电子邮件。
处理没有原生Make应用程序的系统
使用Make的HTTP模块直接调用7stamp。这是自定义 POS、ERP、预订引擎或任何 API 优先服务的通用选择。
7stamp从MakeHTTP调用的操作
对于下面的每张卡，添加HTTP → Make a request，然后完全按照所示设置方法和URL。对每个请求使用相同的 Bearer 密钥。所需的映射告诉您从 CRM、POS 或电子商务触发器提供什么。
Make触发器
Webhooks → Custom webhook 领取卡片活动
在Make中创建Custom webhook，复制其URL，然后将URL粘贴到7stamp配置文件Webhook设置中。当7stamp发送事件（例如SCAN、REWARD_EARNED或VOUCHER_ISSUED）时，这将启动一个场景。
- 在Make
- Webhooks → Custom webhook→添加；给它一个清晰的名称并复制其生成的URL。
- 在7stamp
- 管理→API & Integrations → Webhooks;粘贴URL，选择事件类型，保存，然后创建一个测试事件。
HTTP 操作
POST /cards/invite 创建 Card Invite
为一个外部联系人创建全新的个人安装 URL 和交付插入代码。
- 必需
- external_id — 映射您的马厩 CRM/contact ID，而不是名称。
- 然后使用
- 将响应中的 install_url 映射到您的电子邮件、SMS 或 CRM 更新步骤。
HTTP 操作
POST /cards/invite/bulk 批量创建Card Invites
在一次请求中最多创建 100 个邀请链接。将其用于受控迁移或活动，而不是无限制的联系人导出。
- 必需
- 项目 — JSON 1–100 个单独邀请请求对象的数组。在发送任何链接之前，
- 检查
- 阅读success_count、error_count以及每个结果。
HTTP 操作
GET /cards Find Cards
查找External ID的卡片记录，具有可选的模板和源过滤器。
- 必填
- 查询参数external_id。
- 可选
- external_source 和 template_id 当一个系统有多个节目时缩小查找范围。
HTTP 操作
GET /cards/{user_card_id} 获取卡详细信息
当前一步返回其内部 User Card ID 时读取一张卡的完整状态。
- 必需
- 将 {user_card_id} 替换为受信任的 7stamp 响应返回的内部 ID。
- 避免
- 不要猜测或存储来自不同配置文件的卡片 ID。
HTTP 操作
POST /cards/scan 扫描卡片
根据购买金额或明确计数添加邮票。它接受User Card ID或External ID，并且可以保留外部订单参考。
- 身份
- 使用external_id和可选external_source；如果两者都提供，user_card_id 获胜。
- 购买
- 对于基于金额的卡使用金额或stamps_count对于明确的数字； stamps_count优先。
- 溯源
- 从已付款订单/receipt映射external_order_id，以便可以匹配回7stamp事件。
HTTP 操作
GET /templates List Templates
列出API 键可用的卡片模板。使用它来测试连接或动态选择模板。
- 第一次测试
- 这是最安全的第一个请求：它没有正文，并且不会更改客户数据。
- 稍后映射
- 仅当配置文件具有多个活动模板时，才使用活动模板的 id 作为 template_id。
HTTP 操作
GET /templates/{template_id}/design Get Template Design
返回已知模板的视觉设计设置，当另一个系统需要显示一致的卡片选择时很有用。
HTTP 操作
POST /vouchers/issue 发放优惠券
向由 External ID 或 User Card ID 标识的持卡人发放优惠券。
- 需要
- 优惠券。short_description。以external_id或已知的user_card_id为目标卡。
- 有效性
- 将 validity_type 与 validity_value 一起使用，或阅读 OpenAPI 参考以了解固定到期日期。
HTTP 操作
POST /messages/send 发送消息
通过钱包卡推送和 /or 电子邮件向卡所有者发送内容，具体取决于配置的渠道和同意规则。
- 卡推送
- card_push_text仅限20个字符，需要安装钱包通行证。
- 电子邮件
- 发送主题加正文；基本HTML支撑在体内。
Make 模块
Full 7stamp endpoint URL HTTP → Make a request
这是调用上面每个 7stamp 路由的 Make 模块。使用完整的URL，选择记录的方法，添加Bearer标头，并且仅当路由需要主体时才使用JSON。
- 基础URL
- https://api.7loc.com/cards-api
- 标头
- Authorization：BearerYOUR_7STAMP_API_KEY； Content-Type：application/json，用于 POST 请求。
三个Make 场景，您可以完全按照所写的构建
下面的名称是真正的Make 模块。从第一个场景开始，针对一次性联系人运行它，然后添加路由器、过滤器或生产调度。
1.新增CRM联系人→发送7stamp卡链接
预期结果: 客户收到7stamp返回的install_url；您的 CRM 可以将 URL 保留在同一联系人记录中。
- 1 创建一个场景并添加您的 CRM 的新建/Created 联系人触发器。对于 Kommo，选择联系人创建触发器并运行一次以加载示例联系人。
- 2 添加HTTP → Make a request。将 Method 设置为 POST 并将 URL 设置为 https://api.7loc.com/cards-api/cards/invite.
- 3 添加 Authorization: Bearer YOUR_7STAMP_API_KEY 和Content-Type：application/json。在JSON正文中，将CRM联系人ID映射到external_id，并将external_source设置为固定标签，例如kommo。
- 4 运行一次HTTP模块。确认输出有 install_url、delivery_insert_code、external_id 和 template_id。
- 5 在 HTTP 之后添加您的电子邮件/SMS/CRM 更新模块，并从 HTTP 输出映射 install_url。如果团队稍后必须重新发送，请将 URL 保存在 CRM 联系人中。
检查: POST /cards/invite 始终创建新的邀请。如果您的业务规则是避免再次邀请现有联系人，请首先使用 Find Cards。
2. 付款订单 → 添加忠诚度印章
预期结果: 成功的扫描响应包括成功、scan_id、stamps_added以及下一步的扫描后卡状态。
- 1 从POS/ecommerce付费订单触发器开始。 Make 确定其样品中有稳定客户ID 以及订单/receipt ID。
- 2 添加 HTTP → Make a request 和 POST https://api.7loc.com/cards-api/cards/scan 以及相同的 Bearer 标头。
- 3 映射来自客户的external_id，来自系统名称的external_source，以及来自订单ID的external_order_id。对于基于金额的卡，请添加金额，或者对于明确数量的邮票，请添加 stamps_count。
- 4 Run once 带有测试订单。在启用场景计划之前，请检查返回的成功标志和stamps_added。
- 5 可以选择在 HTTP 步骤后添加过滤器：仅当 success 为 true 时才继续，然后将 scan_id 或 stamps_added 写回订单/CRM 记录。
检查: 重试时使用相同的 external_order_id ，以便可以在以后的 Webhook 事件中跟踪顺序；在一次不清楚的失败运行后，不要两次授予邮票。
3.7stamp活动→更新CRM
预期结果: Make立即收到7stamp事件，可以通过external_id和external_source找到匹配的CRM记录。
- 1 创建一个单独的 Make 场景。添加Webhooks → Custom webhook，选择添加，命名为7stamp-card-events，复制生成的URL。
- 2 在7stamp Admin，打开API & Integrations → Webhooks。添加 URL 并选择一小组事件，例如 SCAN 和 REWARD_EARNED。
- 3 在 7stamp 中创建一次性测试扫描或卡片事件。返回Make，使用Run once让Make确定事件数据结构。
- 4 使用 external_id 添加 CRM 搜索步骤。在event_type上添加过滤器或路由器，以便SCAN、REWARD_EARNED和VOUCHER_ISSUED可以采取不同的操作。
- 5 添加CRM更新/note操作。仅当所选事件类型存在这些字段时，才会映射 scanned_at、stamps_after、external_order_id 和 issued_vouchers。
检查: 保持 webhook URL 的私密性。在开启不可逆转的消息、凭证或CRM更改之前测试真实事件。
在打开Make
These are the exact 7stamp Admin screens. Create the key once, copy it into Make's secure HTTP connection/keychain, then immediately remove it from your clipboard.
在构建之前准备连接
每个环境创建一个 API 密钥
在 7stamp Admin 中，转到 API & Integrations → API Keys → Add API Key。当该选项可用时，将值存储在 Make 的 HTTP API-键连接/keychain 中。切勿从文本字段映射键、将其放置在注释中或在面向浏览器的工作流程中使用它。一把钥匙属于一个 7stamp 工作场所/profile.
使用稳定的 External ID
从您的 CRM、POS 映射不可变的 ID，或者商务平台 - 例如CRM联系人ID或客户UUID。当同一标识符可能出现在多个系统中时，请添加External Source，例如 hubspot、shopify 或海报。
决定应用哪个模板
当连接的7stamp 配置文件有一个活动的卡片模板时，模板可以留空。使用多个模板，有意映射或选择template_id，以便每次邀请和扫描都能达到预期的忠诚度计划。
精确 Make HTTP 设置：创建一张卡片邀请
将其复制到您的自动化步骤中
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}构建并测试您的第一个 Make 场景
在 7stamp Admin 中，在 API & Integrations → API Keys → Add API Key 中创建密钥。当您的帐户设置允许时，使用单独的测试配置文件/key。
在Make中，创建场景并添加源触发器。在映射之前运行一次，以便您可以看到真实的示例联系人或付款订单。
单击下一个加号，搜索HTTP，然后选择Make 请求。在此页面上设置操作卡的方法、完整URL和标题。
使用GET https://api.7loc.com/cards-api/templates 作为第一个请求。其成功的响应证明了关键功能无需更改任何客户数据。
对于 POST 路线，选择 application/json 并粘贴本指南中的体型。映射一个稳定的External ID；仅当配置文件有多个活动模板时才添加 template_id。
使用一次性联系人运行，检查 HTTP 输出，然后将其确切的响应字段映射到下一个 CRM、电子邮件或消息模块。
什么时候应该使用Make HTTP？
现在使用 HTTP 代替 7stamp：这是已记录的、可用于生产的路线，而不是减少后备。每当您需要 7stamp 操作、新的 API 路线或自定义 POS/ERP 连接时，请选择它。 OpenAPI 引用是方法、完整路径、正文和响应模式的真实来源；承载密钥和底座URL保持不变。
接收 Make 中的 7stamp 事件
对于事件驱动场景，添加 Webhooks → Custom webhook 并创建 Webhook。复制其URL，在7stamp配置文件中打开API & Integrations → Webhooks，粘贴URL，选择事件类型，保存并发送真实的测试事件。 7stamp 配置文件拥有该订阅；当前 API 不公开自动 webhook subscribe/unsubscribe 端点。
不需要公共 Make 连接器
此页面上的说明使用每个 Make 帐户都可用的 Make 模块。如果您想要未来的原生 7stamp 模块而不是 HTTP，请将您需要的工作流程发送给我们；在此之前，HTTP 和 Custom webhook 涵盖所有记录的 7stamp 操作。
常见问题
我在 Make 中找不到 7stamp。我还能自动化它吗？
是的。今天Make没有公开的7stamp应用程序。添加 HTTP > Make 请求，使用完整的 7stamp 端点 URL，然后发送 Authorization: Bearer，后跟您的 7stamp API 密钥。 HTTP可以调用每个记录的端点。
在哪里获取 Make 连接的令牌？
在7stamp Admin中，打开API集成，然后打开API Keys，然后打开Add API Key。密钥的范围仅限于创建它的工作场所/profile，因此请尽可能使用测试配置文件来测试场景。
我应该将哪个标识符映射为 External ID？
使用源系统中的稳定标识符，最好是CRM联系人ID或客户UUID。不要使用显示名称。电话号码或电子邮件可以使用，但可能会发生变化，因此应一致处理。
如何将7stamp事件放入Make？
在 Make 中创建 Webhooks > Custom webhook，然后将其生成的 URL 粘贴到 7stamp 配置文件的 Webhook 设置中。交付后使用Make过滤器或路由器来处理传入的event_type。
下一步
准备好自动执行第一个忠诚度操作了吗？
创建 API 密钥，测试 List Templates，并使用一次性联系人构建一个邀请或扫描场景。仅在简单的流程可靠后才添加路由器和消息传递。