本条还可参阅：

如何将17TRACK与Klaviyo集成？

通过 Klaviyo 集成，17TRACK 可以把包裹的物流状态同步到 Klaviyo。你可以在 Klaviyo 中根据物流事件创建自动化邮件或短信，例如发货通知、派送提醒、签收感谢、异常提醒等。

新版 Klaviyo 集成使用 OAuth 授权连接。你不需要手动复制或填写 Klaviyo Public API Key。

一、使用前准备

在开始前，请确认：

  • 你已经有可用的 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. 检查要同步的事件和字段，然后保存设置。



三、可以同步哪些物流事件

连接成功后，你可以在 17TRACK 中选择要同步到 Klaviyo 的物流事件。


事件名称

什么时候触发

常见用途

Shipment status updated

包裹主状态发生变化时

发货、运输中、派送中、签收、异常等状态通知

Shipment stalled

包裹连续一段时间没有新的物流轨迹时

主动安抚顾客，减少“我的包裹在哪里”咨询

Shipment delayed

包裹运输时效超过正常阈值时

延误提醒、客服介入

Estimated delivery missed

包裹超过预计送达时间仍未签收时

EDD 逾期提醒、补偿或客服跟进




四、会发送哪些信息到 Klaviyo

17TRACK 会把创建 Flow 所需的信息随物流事件发送到 Klaviyo。
必需字段无法关闭，包括：

  • 收件人邮箱；
  • 运单号；
  • 运单链接；
  • 物流状态。

你也可以选择是否同步更多信息，例如：

  • 收件人电话、姓名、国家；
  • 第一运输商、第二运输商；
  • 订单号、下单时间、发货时间；
  • 订单金额、币种、标签、数量；
  • 店铺名、最新物流事件、产品信息。

请只开启你在 Klaviyo Flow 中确实需要使用的字段。


五、旧版 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。


六、如何避免重复通知

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 删除。

八、套餐降级或到期后会怎样

Klaviyo 集成适用于 Pro 及以上套餐。

如果你已经连接 Klaviyo，但之后套餐降级、试用到期或权益失效：

  • 17TRACK 会暂停向 Klaviyo 同步新的物流事件；
  • 你的 Klaviyo 授权、账号连接和字段设置会保留；
  • Klaviyo 中已有的 Metric、Flow 和历史事件不会被删除；
  • 恢复 Pro 及以上套餐后，如果 Klaviyo 授权仍然有效，事件同步会恢复；
  • 如果授权也已失效，你需要重新授权。

九、使用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 ”。这代表在有运单变更为签收状态时，则会触发该流程。您也可以输入其他的运输状态文本用来控制触发器。





十、如何在邮件模板中使用 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 账号，请先断开当前连接，再重新授权新的账号。

更新于： 21/09/2026

这篇文章有帮助吗？

分享您的反馈意见

取消

谢谢！