连接 Omnisend 后，StoreClaw 可以在授权范围内读取您的营销活动、联系人、客户分段、订阅状态和自动化流程数据，用于营销分析、客户洞察和自动化运营。
本文介绍如何在 Omnisend 中创建 API Key，并在 StoreClaw 中完成连接和验证。
连接前准备
在开始连接前，请确认以下条件已满足：
- 已注册并可正常登录 Omnisend
- 当前账号拥有访问 Store Settings 和创建 API Key 的权限
- 已确认需要授予 StoreClaw 的 API Key 权限范围
- 已登录 StoreClaw
提示： 建议为 StoreClaw 单独创建一个 API Key，方便后续独立管理、审计和撤销。请不要与其他系统共用同一个 API Key。
获取 Omnisend API Key
1. 登录 Omnisend
打开 Omnisend 官网并登录您的账号。
2. 进入 API Key 管理页面
在 Omnisend 后台中，进入 Store Settings，然后打开 API keys 页面。
3. 创建 API Key
在 API keys 页面中，点击 Create API key，然后完成以下设置：
- 输入 API Key 名称，例如
StoreClaw Integration。 - 根据 StoreClaw 需要读取的数据，选择合适的权限范围。
- 点击 Create API key。
- 创建完成后，复制生成的 API Key，并妥善保存。
重要： API Key 相当于访问凭证。请不要将其发送到群聊、公开文档或截图中。如果 API Key 泄露，建议立即在 Omnisend 中删除旧 Key，并重新生成新的 API Key。
在 StoreClaw 中连接 Omnisend
您可以通过以下两种方式找到 Omnisend 连接器入口：
- 在 StoreClaw 会话框中输入
帮我连接 Omnisend。 - 点击左侧导航栏中的 连接器，在 营销 分类中找到 Omnisend 连接器卡片。
连接流程如下：
- 点击 Omnisend 连接器卡片上的 + 按钮。
- 在弹出的连接器窗口中，点击 连接 Omnisend。
- 在 Omnisend 授权中间页，根据提示输入 Omnisend API Key。
- 点击 Connect Account。
- 页面将自动跳转回 StoreClaw 的 连接器 页面。
- 当 Omnisend 卡片显示 已连接 状态时，表示连接成功。
安全说明： StoreClaw 仅在 API Key 授权范围内读取 Omnisend 数据，用于营销分析、客户洞察和自动化任务。连接过程不会删除或发布您的 Omnisend 数据。
验证连接状态
连接完成后，您可以通过以下方式确认连接是否正常：
- 进入 连接器 页面，确认 Omnisend 卡片显示 已连接 状态。
- 在 StoreClaw 对话框中输入类似指令，例如
查看我的 Omnisend 邮件活动。 - 如果系统能正常返回 Omnisend 数据，说明连接已生效。
如果连接失败，请检查 API Key 是否复制完整、权限是否足够，以及该 API Key 是否仍然有效。
断开连接
如需停止 StoreClaw 访问 Omnisend 数据，请按以下步骤操作：
- 前往 连接器 页面。
- 找到已连接的 Omnisend 卡片。
- 点击卡片，在弹窗中选择 断开连接。
- 确认断开操作。
说明： 断开连接后，StoreClaw 将停止继续读取该 Omnisend 账号的数据。断开连接不会删除 Omnisend 平台上的任何数据，也不会影响 StoreClaw 中已生成的历史分析结果。
建议： 如果您希望完全切断访问，请同时前往 Omnisend 的 API keys 页面删除对应的 API Key。
连接后可用功能
成功连接后，StoreClaw 可在 API Key 授权范围内读取 Omnisend 数据，并支持以下分析能力：
| 功能模块 | 可用能力 |
|---|---|
| 营销活动分析 | 查看营销活动列表、发送状态、打开率、点击率等表现指标 |
| 自动化流程分析 | 查询自动化序列、触发条件和流程表现 |
| 联系人分析 | 查看联系人信息、订阅状态和互动记录 |
| 客户分段 | 读取客户分段数据，按行为、属性等维度进行分析 |
| 订阅状态分析 | 分析订阅、退订和客户参与度变化 |
| 数据整合分析 | 将 Omnisend 数据与其他渠道数据结合，用于整体营销分析 |
注意： 实际可用的数据范围取决于 API Key 的权限范围、授权账号权限，以及您的 Omnisend 账号方案。未授权或账号无权限的数据不会被 StoreClaw 读取。
示例指令
连接成功后，您可以在 StoreClaw 中输入以下指令：
分析过去 30 天 Omnisend 邮件活动的打开率和点击率趋势统计不同客户分段的订阅率和参与度列出表现最好的三个 Omnisend 自动化流程查看近期退订用户的变化趋势总结最近一次 Omnisend 营销活动的表现对比不同客户分段的互动表现并给出优化建议
安全建议
为确保数据安全和账号安全，建议遵循以下做法：
- 使用专用 API Key： 为 StoreClaw 单独生成 API Key，不与其他系统共用。
- 遵循最小权限原则： 仅授予 StoreClaw 实际需要的权限范围。
- 定期审计： 定期检查 Omnisend 中已创建的 API Key 列表。
- 及时撤销： 如怀疑 API Key 泄露，请立即删除旧 Key 并重新生成。
- 避免公开传播： 不要在群聊、公开文档、截图或邮件中明文展示 API Key。
常见问题（FAQ）
Q：可以连接多个 Omnisend 账号吗？
A： 不可以，目前 StoreClaw 只支持连接一个 Omnisend 账号。
Q：提示 Invalid API Key 或 Authentication Failed 怎么办？
A： 请检查 API Key 是否完整复制，首尾是否包含空格或多余字符；确认该 API Key 是否仍然有效，是否已被删除或撤销。如果问题持续，请在 Omnisend 中重新生成 API Key 后再连接。
Q：提示 Connection timeout 或页面无响应怎么办？
A： 请检查网络连接是否正常，并稍后重试。您也可以查看 Omnisend 服务状态，确认 Omnisend 当前是否存在服务异常。
Q：提示 Insufficient Permissions 或 Access Denied 怎么办？
A： 这通常表示 API Key 的权限不足。请检查创建 API Key 时选择的权限范围是否覆盖 StoreClaw 需要读取的数据。如需调整权限，请在 Omnisend 中重新创建具备相应权限的 API Key。
Q：StoreClaw 是否会存储我的 Omnisend API Key？
A： StoreClaw 会以安全方式保存 API Key，用于后续访问 Omnisend API。请妥善保管您的 API Key，不要在公开渠道分享。如需完全撤销访问，请在 StoreClaw 中断开连接，并在 Omnisend 中删除对应的 API Key。
Q：连接 Omnisend 时一定要使用读写权限吗？
A： 不一定。如果您只需要读取营销数据、分析活动效果和客户行为，建议仅授予读取相关权限。只有在确实需要执行写入操作时，才授予更高权限。
Q：如何断开 Omnisend 连接？
A： 在 StoreClaw 的 连接器 页面找到已连接的 Omnisend，点击卡片并选择 断开连接。如果您希望完全切断访问，也建议在 Omnisend 的 API keys 页面删除对应的 API Key。
Q：断开连接后，历史数据会被删除吗？
A： 不会。断开连接只会停止 StoreClaw 后续读取 Omnisend 数据，不会删除 Omnisend 平台上的数据，也不会影响 StoreClaw 中已生成的历史分析结果。