> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help-shopify.17track.net/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 如何将17TRACK与Klaviyo集成？

通过 Klaviyo 集成，17TRACK 可以把包裹的物流状态同步到 Klaviyo。你可以在 Klaviyo 中根据物流事件创建自动化邮件或短信，例如发货通知、派送提醒、签收感谢、异常提醒等。
|| 新版 Klaviyo 集成使用 OAuth 授权连接。你不需要手动复制或填写 Klaviyo Public API Key。
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_7ky7ug.png)
## 一、使用前准备
在开始前，请确认：
* 你已经有可用的 Klaviyo 账号；
* 你有权限管理当前 17TRACK 账号；
* 你的 17TRACK 套餐支持 Klaviyo 集成。Klaviyo 集成适用于 Pro 及以上套餐；
* 如果你准备通过 Klaviyo 发送通知，请检查是否已经在 17TRACK 中开启了邮件通知，避免同一物流状态重复通知顾客。
|| 如果当前套餐不支持 Klaviyo 集成，系统会在授权前提示你升级。升级成功后，你可以继续完成 Klaviyo 连接，不需要重新开始。
## 二、从 17TRACK 连接 Klaviyo
1. 进入 Shopify 后台，打开 17TRACK App。
2. 在左侧菜单中进入「集成」。
3. 在「自动化」分类中找到 Klaviyo。
4. 点击「连接」。
5. 系统会跳转到 Klaviyo 授权页面。
6. 确认授权的 Klaviyo 账号无误后，点击「Allow」或「允许访问」。
7. 授权完成后，你会回到 17TRACK 的 Klaviyo 设置页。
8. 检查要同步的事件和字段，然后保存设置。

![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_w33gw2.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_mcq11r.png)
## 三、可以同步哪些物流事件
连接成功后，你可以在 17TRACK 中选择要同步到 Klaviyo 的物流事件。
  
| 事件名称 | 什么时候触发 | 常见用途 |
| ---- |
| Shipment status updated | 包裹主状态发生变化时 | 发货、运输中、派送中、签收、异常等状态通知 |
| Shipment stalled | 包裹连续一段时间没有新的物流轨迹时 | 主动安抚顾客，减少“我的包裹在哪里”咨询 |
| Shipment delayed | 包裹运输时效超过正常阈值时 | 延误提醒、客服介入 |
| Estimated delivery missed | 包裹超过预计送达时间仍未签收时 | EDD 逾期提醒、补偿或客服跟进 |


![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_14h4xii.png)

## 四、会发送哪些信息到 Klaviyo
17TRACK 会把创建 Flow 所需的信息随物流事件发送到 Klaviyo。
必需字段无法关闭，包括：
* 收件人邮箱；
* 运单号；
* 运单链接；
* 物流状态。
你也可以选择是否同步更多信息，例如：
* 收件人电话、姓名、国家；
* 第一运输商、第二运输商；
* 订单号、下单时间、发货时间；
* 订单金额、币种、标签、数量；
* 店铺名、最新物流事件、产品信息。
请只开启你在 Klaviyo Flow 中确实需要使用的字段。
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_15qh4cb.png)

## 五、旧版 Public API Key 用户如何处理
||| 如果你之前已经使用 Public API Key 连接了 Klaviyo，旧连接不会因为新版上线而立即停止。
在 17TRACK 中，你会看到当前连接方式为「Public API Key」或「旧版连接」。你可以选择暂时保留旧连接，也可以升级到新版 OAuth 连接。
升级时请注意：
* 授权成功前，旧连接会继续工作；
* 系统会尽量保留你原来选择的同步字段；
* 授权成功并完成验证后，17TRACK 会停止旧的 Public API Key 发送通道，避免同一物流事件重复进入 Klaviyo；
* 你原来在 Klaviyo 中创建的 Flow 不会被 17TRACK 自动修改、启用或删除；
* 旧的 Metric，例如 `17TRACK shipment status update`，会继续保留一段时间，方便你查看历史数据或迁移 Flow；
* 新连接会使用 OAuth 授权，后续不需要继续维护 Public API Key。
||| 如果旧 Public API Key 已失效，建议直接改用 OAuth 重新连接。新版公开后，新用户一般不再需要，也不再建议手动填写 Public API Key。
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_1qcky9n.png)

## 六、如何避免重复通知
||| 17TRACK 邮件通知和 Klaviyo Flow 都可以向顾客发送物流消息。如果两个渠道都针对同一状态发送通知，顾客可能会收到重复邮件。
建议你在启用 Klaviyo Flow 前检查：
* 17TRACK 中是否已经开启相同状态的邮件通知；
* Klaviyo 中是否已经有旧 Flow 使用 `17TRACK shipment status update`；
* 新 Flow 是否和旧 Flow 使用了相同的触发条件；
* 同一个状态是否会同时触发邮件和短信。
如果你希望 Klaviyo 负责物流通知，可以在确认 Klaviyo Flow 正常后，调整 17TRACK 中对应的邮件通知设置。
## 七、查看连接状态和管理连接
连接成功后，你可以在 17TRACK 的 Klaviyo 设置页查看：
* 当前连接状态；
* 已连接的 Klaviyo 账号；
* 当前 17TRACK 账号；
* 最近一次事件同步时间；
* 最近同步结果；
* 已开启的物流事件；
* 发送到 Klaviyo 的字段；
* 重新授权、断开连接等操作。
||| 如果 Klaviyo 授权失效，17TRACK 会暂停同步新的物流事件。你可以点击「重新授权」恢复连接。重新授权后，已配置的事件和字段设置会尽量保留。
如果你断开连接，17TRACK 将停止向 Klaviyo 同步新的物流事件。Klaviyo 中已有的 Metric、Flow 和历史事件不会被 17TRACK 删除。
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_dgcg3y.png)
## 八、套餐降级或到期后会怎样
|| Klaviyo 集成适用于 Pro 及以上套餐。
如果你已经连接 Klaviyo，但之后套餐降级、试用到期或权益失效：
* 17TRACK 会暂停向 Klaviyo 同步新的物流事件；
* 你的 Klaviyo 授权、账号连接和字段设置会保留；
* Klaviyo 中已有的 Metric、Flow 和历史事件不会被删除；
* 恢复 Pro 及以上套餐后，如果 Klaviyo 授权仍然有效，事件同步会恢复；
* 如果授权也已失效，你需要重新授权。
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_18ygszt.png)
## **九、使用17TRACK APP运单状态创建触发器**
1. 登录Klaviyo App
2. 点击 Flows进入模块，点击右上角 Create Flow，再次点击右上角Create from Scratch进行新建自动化流程
3. 输入自动化流程的名字，这里示例使用“17TRACK-签收”
4. 左侧导航中点击Metric > FLOW TRIGGER > 选择 17TRACK shipment status update.
5. TRIGGER FILTERS > Add a Trigger Filter >选择 shipment\_status > 在输入框中输入“Delivered ”。这代表在有运单变更为签收状态时，则会触发该流程。您也可以输入其他的运输状态文本用来控制触发器。
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_ivi6lm.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_1468yyb.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_xo638t.png)


![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_13zj5u.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_1di7pcl.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_ho7wov.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_4f7eaf.png)
## 十、如何在邮件模板中使用 17TRACK 变量
如果邮件中无法显示订单号或物流信息，请先确认 Flow 使用的是 17TRACK 物流事件，然后使用该事件提供的变量。不要直接套用 Shopify 事件中的 `extra.line_items`、`subtotal_price` 或 `shipping_lines` 等变量，因为 17TRACK 事件不提供这些字段。
操作步骤：
1. 在 Klaviyo 中进入「Flows」，打开需要编辑的 Flow。
2. 确认 Flow 的触发器是 17TRACK 事件，例如 `Shipment status updated`。
3. 打开 Flow 中的邮件，进入邮件模板编辑页面。
4. 将下面的变量添加到需要显示对应信息的位置。
5. 使用 Klaviyo 的预览功能，选择一条包含完整数据的近期 17TRACK 事件进行检查。
变量名区分大小写，请按下表填写：
| 名称 | 模板变量 |
|---|---|
| 收件人邮箱 | `{{ event.email\|default:'' }}` |
| 运单号 | `{{ event.trackNo\|default:'' }}` |
| 运单链接 | `{{ event.trackUrl\|default:'' }}` |
| 物流状态 | `{{ event.shipment_status\|default:'' }}` |
| 收件人电话 | `{{ event.phone\|default:'' }}` |
| 收件人姓名 | `{{ event.first_name\|default:'' }}` `{{ event.last_name\|default:'' }}` |
| 收件人国家 | `{{ event.country\|default:'' }}` |
| 第一运输商 | `{{ event.carrierCode\|default:'' }}` `{{ event.carrierUrl\|default:'' }}` |
| 第二运输商 | `{{ event.secondCarrierCode\|default:'' }}` `{{ event.secondCarrierUrl\|default:'' }}` |
| 订单号 | `{{ event.orderNo\|default:'' }}` |
| 下单时间 | `{{ event.orderTime\|default:'' }}` |
| 发货时间 | `{{ event.shipTime\|default:'' }}` |
| 订单总金额 | `{{ event.orderTotal\|default:'' }}` |
| 订单币种 | `{{ event.orderCurrency\|default:'' }}` |
| 订单标签 | `{{ event.orderTags\|default:'' }}` |
| 店铺名 | `{{ event.shopName\|default:'' }}` |
| 订单数量 | `{{ event.buyerOrderNum\|default:'' }}` |
| 最新事件 | `{{ event.lastEventTime\|default:'' }}` `{{ event.lastEventDesc\|default:'' }}` |
| 产品信息 | `{% for item in event.products %}` … `{% endfor %}` |
| 产品名称 | `{{ item.product_name\|default:'' }}` |
| 产品 SKU | `{{ item.sku\|default:'' }}` |
| 产品价格 | `{{ item.price\|default:'' }}` |
| 产品币种 | `{{ item.currency\|default:'' }}` |
| 产品链接 | `{{ item.product_url\|default:'' }}` |
| 产品图片 | `{{ item.image\|default:'' }}` |
## 十一、常见问题
### 连接新版 Klaviyo 集成还需要 Public API Key 吗？
不需要。新版集成通过 OAuth 授权连接，不需要手动复制或填写 Klaviyo Public API Key。
### 我以前填过 Public API Key，还能继续用吗？
可以。已有的有效旧连接不会立即停止。你可以先继续使用旧连接，也可以在 17TRACK 中点击「升级连接」改用 OAuth。升级成功前，旧连接会继续工作；升级成功后，旧通道会停止发送，避免重复同步。
### 升级到 OAuth 后，我以前的 Klaviyo Flow 会被删除吗？
不会。17TRACK 不会自动删除、修改或启用你已有的 Klaviyo Flow。你需要根据新的事件名称和字段，手动检查或调整 Flow。
### 为什么 Klaviyo 没有发送邮件？
17TRACK 负责把物流事件同步到 Klaviyo。邮件或短信是否发送，取决于 Klaviyo 中的 Flow 设置、过滤条件、发送状态、收件人的同意状态以及 Klaviyo 的发送规则。你可以先确认 17TRACK 中最近同步结果是否成功，再检查 Klaviyo Flow 是否已设置为 Live。
### 断开连接后，Klaviyo 中的历史数据会消失吗？
不会。断开后，17TRACK 只会停止同步新的物流事件，不会删除 Klaviyo 中已有的 Metric、Flow 或历史事件。
### 我可以连接多个 Klaviyo 账号吗？
当前一个 17TRACK 账号只支持连接一个 Klaviyo 账号。如果你需要更换 Klaviyo 账号，请先断开当前连接，再重新授权新的账号。