Userflow 用户流

它解决什么问题

在 Userflow 里维护用户、分组和行为事件时，团队往往只能在网页后台手工点选。一旦想把它接进自动化流程——比如注册后的引导分群、漏掉的埋点补录——就得自己处理 API Key、过期刷新和 scope 授权这些基础设施。凭据散落在脚本和环境变量里，轮换一次要改一遍代码，权限配置不对时报错还很难定位。

技能如何工作

这个技能把 Userflow 包装成 OOMOL 连接器，所有调用都通过 oo CLI 发起，凭据由 OOMOL 服务端注入，脚本里不会出现原始 token。它暴露 8 个 action，分成三组：

• 读取类：get_user、get_group、list_users，其中 list_users 支持游标分页和过滤条件
• 写入类：upsert_user、upsert_group 用于创建或更新单个对象，track_event 给某个用户记录一条事件
• 破坏类：delete_user、delete_group，按 ID 删除

推荐的顺序是先看契约再传参：用 oo connector schema 拉取目标 action 的权威输入输出结构，确认字段名和必填项后再构造 payload。--data 可以传 JSON 字符串，也可以写成 @path/to/file.json 从文件读取；不传则默认发送 {}。返回值统一是 {"data": ..., "meta": {"executionId": "..."}}，执行 ID 位于 meta.executionId，便于事后对账。

边界与注意点

读取类操作可以直接执行；创建、更新、发送类动作会改变 Userflow 中的状态，必须先和用户确认确切的 payload 以及实际影响。删除操作具有破坏性，必须明确指出目标对象并取得显式授权，不能因为「用户大概率同意」就跳过。

认证和连接错误只在命令真正失败时才需要处理：oo auth login 以及重新连接 Userflow（API Key 方式）都是一次性步骤，不要每次调用都重复执行。遇到 HTTP 402 或 OOMOL_INSUFFICIENT_CREDIT 说明额度耗尽，需要到 OOMOL 控制台充值后再重试。另外，它只能操作当前已连接的那个 Userflow 账户，多个工作区需要分别建立连接。