名称： front
描述： Front.app API，用于管理会话、消息、评论及团队协作。
主页： https://front.com
元数据： {"clawdbot":{"emoji":"📬","requires":{"bins":["curl"],"env":["FRONT_API_TOKEN"]},"primaryEnv":"FRONT_API_TOKEN"}}

Front

使用 Front API 管理会话、读取/发送消息，并通过团队评论进行协作。

设置

从 Front → 设置 → 开发者 → API 令牌 获取您的 API 令牌。
将其存储在 ~/.clawdbot/clawdbot.json 中：

{
  "skills": {
    "entries": {
      "front": {
        "apiKey": "YOUR_FRONT_API_TOKEN"
      }
    }
  }
}

或者设置环境变量：FRONT_API_TOKEN=your_token

快速参考

列出收件箱

{baseDir}/scripts/front.sh inboxes

列出会话

{baseDir}/scripts/front.sh conversations [inbox_id]      # 活跃会话（未分配 + 已分配）
{baseDir}/scripts/front.sh conversations --all           # 包含已归档会话
{baseDir}/scripts/front.sh conversations --archived      # 仅已归档会话
{baseDir}/scripts/front.sh conversations --unassigned    # 仅未分配会话
{baseDir}/scripts/front.sh conversations --assigned      # 仅已分配会话
{baseDir}/scripts/front.sh conversations --limit 200     # 增加结果数量限制（默认：100）

获取会话详情

{baseDir}/scripts/front.sh conversation <conversation_id>

列出会话中的消息

{baseDir}/scripts/front.sh messages <conversation_id>

搜索会话

{baseDir}/scripts/front.sh search "查询文本"
{baseDir}/scripts/front.sh search "from:client@example.com"
{baseDir}/scripts/front.sh search "tag:urgent"

读取评论（团队备注）

{baseDir}/scripts/front.sh comments <conversation_id>

添加评论（团队备注）

{baseDir}/scripts/front.sh add-comment <conversation_id> "您的团队备注内容"

回复会话

{baseDir}/scripts/front.sh reply <conversation_id> "您的回复消息"
# 使用 --draft 标志保存为草稿而非直接发送：
{baseDir}/scripts/front.sh reply <conversation_id> "草稿消息" --draft

列出团队成员

{baseDir}/scripts/front.sh teammates

分配会话

{baseDir}/scripts/front.sh assign <conversation_id> <teammate_id>

标记会话

{baseDir}/scripts/front.sh tag <conversation_id> <tag_id>

列出标签

{baseDir}/scripts/front.sh tags

获取联系人信息

{baseDir}/scripts/front.sh contact <contact_id_or_handle>

列出草稿

{baseDir}/scripts/front.sh drafts [inbox_id]    # 在会话中搜索草稿

注意：Front API 没有全局草稿端点。此命令会检查活跃会话中的草稿回复。

常见工作流

每日收件箱检查：

# 列出未分配的开放会话
{baseDir}/scripts/front.sh conversations --unassigned --status open

查找客户会话：

{baseDir}/scripts/front.sh search "from:customer@company.com"

添加团队上下文：

{baseDir}/scripts/front.sh add-comment cnv_abc123 "客户为 VIP - 请谨慎处理"

注意事项

• API 基础地址：自动检测（公司特定，例如 https://company.api.frontapp.com）
• 认证方式：请求头中的 Bearer 令牌
• 速率限制：120 次请求/分钟
• 会话 ID 以 cnv_ 开头
• 收件箱 ID 以 inb_ 开头
• 发送回复前请务必确认

API 限制

• 无全局搜索：/conversations/search 端点可能返回 404，具体取决于 API 套餐
• 无全局草稿：草稿按会话存储，无法全局访问
• 会话与收件箱：默认显示未归档/未删除的会话（开放、未分配、已分配）