SuperAPI AI 工具集

migrating-from-customer-io

营销与增长

查看项目

更新于 10-29 20:10

技能介绍

用途 该技能用于把 Customer.io 中的自动化流程迁移到 PostHog,并以草稿工作流的形式导入。草稿不会发送任何消息,需要由人工逐条检查、补全导入无法携带的设置后再启用。

主要能力

  • 通过 Customer.io 的 MCP(或在 CLI 上使用 cio api)分页读取自动化列表与详情,保留 campaign 对象及其顶层 actions 数组。
  • 读取发件人身份(id、email、name)和分群(仅 id、name、type),供 PostHog 匹配同地址的发件人并在备注中标注分群名称。
  • 调用 workflows-import-customerio 进行预览(dry_run: true)和正式导入(dry_run: false),单次最多 50 个自动化。
  • 按需读取模板、snippet 和 layout:仅当备注提示消息内容未导入或 PostHog 无法读取时,才逐个读取模板并再次预览。
  • 输出预览报告,按 needs_input、approximated、unsupported 三个级别汇总每条自动化的状态与备注。

使用方式

  1. 确认要迁移的 Customer.io 工作区,其 id 即路径中的 environment_id。
  2. 列出自动化并展示各自状态,询问用户要迁移哪些(通常为运行中的,归档的除非要求否则跳过)。
  3. 逐条读取自动化、发件人和分群。
  4. 不带模板先做 dry_run 预览。
  5. 根据备注决定是否需要读取模板、snippet、layout,并再次预览。
  6. 汇报预览结果;对 status 为 failed 的条目,先说明 validation_errors 再询问是否导入。
  7. 正式导入,分享每个草稿的 /workflows/{workflow_id} 链接,并再次列出 needs_input 备注。
  8. 不确定端点参数时,只查询该端点的 schema,避免拉取整个资源的 schema。

备注级别

  • needs_input:草稿缺少只有团队能提供的设置(如邮件发件人、触发 cohort、分支条件),会阻止启用。
  • approximated:步骤在 PostHog 中行为不同(例如等待上限为 30 天),启用前值得核查。
  • unsupported:设置无对应项而被省略(例如 SMS 步骤),需决定是否另行重建。

数据与隐私限制 只传递自动化、模板、发件人身份和分群名称,绝不获取或传递客户档案、分群成员、投递记录或事件数据。邮件模板体积大,应优先传自动化图,仅在 PostHog 要求时读取模板,避免消息内容进入上下文。

其它限制

  • Customer.io 分群不会导入;按分群触发的自动化会以空触发器导入并附 needs_input 备注。若已有匹配的 PostHog cohort,可通过 segment_cohorts 映射;cohort 触发器需要实时 cohort;静态分群需用户改用条件重建。
  • 推送步骤导入为 unsupported,设备 token 不会随导入迁移,需用户自行通过 SDK 注册或单独导入 token。
  • 同一自动化再次导入会替换其草稿,团队此前的修改会丢失,重新导入前需询问;已启用或用户无权编辑的工作流不会被改动,结果为 skipped。
  • 导入完成后不要启用草稿,应引导用户处理 needs_input 备注,再交由 building-workflows 技能进行测试与启用,且需用户明确确认。