Teambition 集成
Teambition 集成用于把 Teambition 里的项目和任务接入 HiFox：可以先导入已有条目，再按连接上的同步设置保持更新。
入口在「设置 → 导入与导出」的平台列表，以及「外部应用集成」的 Teambition 页。菜单名称以线上为准。Teambition 正在逐步开放：账号暂未开放时，平台列表里会显示「即将推出」占位。
两层凭据
Teambition 接入分两层，各自独立：
应用凭据怎么拿
由 Teambition 企业管理员在开放平台完成（需要 Teambition 企业版）：
- 在 Teambition 开放平台创建企业内部应用，并在企业内发布；
- 在应用的「应用权限」中开通本集成用到的权限：读取项目、任务、任务分组、项目成员与状态，以及任务更新与评论写入；提交后由企业管理员审核，权限变更需要重新发布；
- 打开「应用凭证和基本信息」，复制 App ID 与 App Secret；
- 在「安全域名」中加入本站地址（域名或 IP，可带端口，不带
http://或https://）；未加入时跳转会报「不匹配的应用安全域名」。
企业 ID 是登录 Teambition 网页版后，地址栏 https://www.teambition.com/organization/ 之后的一串字符。页面上的「如何获取凭据」会带着这些步骤和链接，照着做即可。
个人授权
保存应用配置后，到「第三方账号绑定」绑定你自己的 Teambition 账号。没有个人授权时，项目发现会明确提示需要你本人授权，并给出绑定入口。个人授权失效（例如修改了 Teambition 密码）后需要重新完成，恢复后项目发现和远端写入才会继续。
导入 Teambition 数据
导入助手分步进行：连接 → 发现与预览 → 状态映射 → 用户映射 → 导入选项 → 确认 → 结果。Teambition 侧的数据不会发生变化，最后一步之前随时退出都不会导入任何内容。
- 连接：填写应用凭据（App ID、App Secret、企业 ID）。也可以选择上传 Teambition 导出的任务信息表（CSV）：在 Teambition 网页版任务列表的导出菜单中选择「自定义表头字段导出所有任务」，下载的 CSV 可直接上传，不依赖 API 凭据；
- 发现与预览：系统读取你在 Teambition 加入的组织和项目，展示只读预览——数量、迭代、工作类型等。先确认范围符合预期，再继续；
- 状态映射：把 Teambition 状态映射到 HiFox 任务状态，或新建状态；
- 用户映射：把 Teambition 成员映射到本组织成员，或导入为外部账号；不映射则跳过。Teambition 成员不带邮箱，不支持按邮箱邀请；
- 导入选项：按页面提示选择，例如导入后与 Teambition 建立关联、为导入的任务添加标签等；
- 确认：核对摘要后开始导入。导入开始后可以取消；已导入的内容可以在「导入与导出」设置里回滚。
双向同步还需要任务类型映射：从 HiFox 创建任务到 Teambition 时，本地任务类型按映射对应到 Teambition 的任务类型；未命中精确对应的类型会使用映射里标记为默认的那一行。
配置 Teambition 同步
Teambition 同步支持两种方向：
在 Teambition 页的同步区创建同步链接，选择组织和项目、目标 Space 和同步方向。验证通过 Teambition 的远端写入能力之前，双向写入保持禁用，只能先使用 Teambition → HiFox 方向。
入站 Webhook
实时入站同步依赖 Webhook。Teambition 没有提供自动注册 Webhook 的公开接口，需要在 Teambition 应用的 Webhook 设置中手动添加页面给出的接收地址；未登记前，同步按轮询兜底进行。任务与评论事件会触发已关联项目的数据回读和入站同步；删除事件不会直接删除本地任务。
同步配置详情页
打开某条同步的配置后，详情分为 同步设置（持续同步开关、方向、历史数据补导）、用户映射 和 状态映射 三个页签；改动需要保存才生效，带着未保存的更改离开时会先确认。同步链接行上可以启用、暂停、立即同步，或调整方向；行上会显示最近同步时间。
外部账号
导入或同步遇到 Teambition 上无法对应到组织成员的用户时，HiFox 会自动创建外部账号承接：保留「平台 + 实例 + 姓名」的来源身份，作为任务处理人显示，但不是组织成员、不占名额、不能登录。
外部账号在 人员 → 外部账号 页签统一管理：可以按平台、实例和关联状态筛选搜索，把外部账号关联到组织成员（邮箱唯一匹配或本人验证过绑定会自动关联，手动关联优先）。关联后自动补全该账号名下历史任务的处理人（人工修改过的不覆盖），解除关联后恢复外部身份。详见 Jira 集成中的「外部账号」说明——各平台行为一致。
常见问题
发现不到我的项目？
项目发现读取的是你在 Teambition 加入的项目。先确认个人授权已完成且未失效，再确认你确实加入了该项目；组织级应用凭据不会替你看到你没加入的项目。
双向同步什么时候可以用？
双向写入需要在 Teambition 侧验证远端写入能力后才会开放；验证通过前，同步方向里双向保持禁用。先用 Teambition → HiFox 方向不影响导入和入站同步。
为什么要在 Teambition 后台手动配置 Webhook？
Teambition 没有提供自动注册 Webhook 的开放接口，所以接收地址需要在应用的 Webhook 设置中手动添加一次。配置后任务与评论事件会实时回读；没配置时轮询仍然兜底，只是实时性差一些。