TravelMind 文档

常见问题解答、API 对接说明、飞书机器人集成教程。所有文档基于真实业务场景持续更新。

FAQ 常见问题

产品功能 / 部署 / 收费 / 数据安全

API 对接

MCP 协议 / REST / 多租户鉴权

飞书机器人

应用申请 / 部署 / 多租户配置

常见问题

TravelMind 适合什么规模的企业?

从 5 人小团队到 500 人集团, 一套差旅 + 报销 SaaS 全功能开箱即用。最常见的客户是 30-200 人的中小企业, 尤其是物业服务、连锁服务业、制造业。

大型企业 (500 人+) 可走定制版, 支持私有化部署 + 网络隔离 + 数据本地化。

需要多久可以上线使用?

标准 SaaS 版: 注册后 5 分钟即可开始使用。配置企业差标规则 + 飞书/钉钉集成大约需要 1-2 小时。

私有化版: 部署需要 1-3 天, 包括 Docker 镜像、数据库初始化、网络配置。

可以中途升级套餐吗?

可以。从基础版升级到高级版, 我们会按剩余天数等比例计算差价。联系商务或控制台一键升级。

数据安全吗? 你们能拿到我们的数据吗?

数据隔离: 每企业独立数据库 schema + 行级权限, API 鉴权必传 tenantId。我作为开发者, 只能登录 admin 租户看 metadata, 看不了你的业务数据。

大客户可以私有化部署: 数据存在你的服务器, 我们无法访问。

支持哪些差旅出行方式?

火车 (12306 实时)、航班 (实时+降级估算)、酒店 (高德 POI 多关键词)、出租车/网约车、本地交通 (公交/地铁/打车)、长途汽车。

发票原件如何保存? 满足税务合规要求吗?

所有上传的 PDF / 图片发票原件通过 SHA-256 校验后保存, 10 年合规存档期。支持原件下载查阅, 满足大陆增值税发票法定保存要求。

飞书 / 钉钉 / 企业微信 都支持吗?

都支持。 飞书深度集成 (机器人 + 审批 + 多维表格), 钉钉 / 企微支持基础审批对接。 客户可选择任一平台或全部接入。

有 PoC 免费试用吗?

有。 提供 14 天免费试用, 所有高级功能开放。试用结束后可选择付费继续或停用, 数据不丢失。

API 对接

POST/api/agent/plan/upgrade

创建套餐升级订单, 返回支付链接 (支付宝/对公转账)。

请求参数: targetPlan (trial/basic/pro/custom), tenantId, actorUserId, returnUrl

鉴权: Bearer Token + tenantId 必须匹配用户绑定租户

GET/api/agent/trip/list

查询当前用户的差旅行程列表, 支持状态/时间筛选。

参数: userId, status (planned/ongoing/completed/cancelled), limit, offset

POST/api/agent/expense/create

创建报销单, 自动按差标规则校验, 触发审批流。

参数: tripId, segments (费用明细数组), totalAmount, reason

GET/api/agent/policy/check-now

差标实时校验: 给定行程数据返回合规状态, 不保存结果。

参数: tenantId, originCity, destCity, amount, category (flight/train/hotel)

MCP 协议接入 (推荐)

TravelMind 支持 Model Context Protocol (MCP), Claude Desktop / Cursor / 其他 AI 客户端可直接调用差旅数据、规则引擎、审批流。

服务端点: https://www.trvaelmind.online/api/v1/mcp/data

鉴权: Authorization: Bearer tm_<tenant_token> (在控制台申请)

飞书机器人应用集成

1

申请企业飞书应用

登录 飞书开放平台, 创建企业自建应用。 需管理员权限。 名称建议: 「TravelMind 差旅助手」或自定义。

2

配置应用权限

在「权限管理」中开启以下 scope (审核通常 1-2 天):

im:message · im:message:send_as_bot · approval:approval · contact:user.id:readonly

3

配置事件订阅 / Webhook

在「事件订阅」中, 请求 URL 填写 https://www.trvaelmind.online/webhook/feishu, 启用加密校验。

订阅事件: im.message.receive_v1 · approval.instance

4

获取 App ID / Secret

在「凭证与基础信息」中复制 App ID 和 App Secret。登录 TravelMind 控制台 → 飞书集成 → 填入凭证并保存。

5

发布版本 + 启用机器人

在「版本管理与发布」中创建版本并提交审核。审核通过后, 在企业内搜索机器人名称即可使用。

机器人命令: /出差 · /报销 · /我的行程 · /差标查询

多租户部署 (推荐)

每企业单独申请飞书应用 (而非共享), 数据完全隔离。 TravelMind 提供一键部署脚本 deploy-feishu-tenant.sh, 5 分钟完成企业绑定、权限校验、webhook 配置。