Crmkit 智能体 CRM

要解决什么问题

很多 CRM 把操作锁在 Web 界面里，Agent 只能让用户点来点去，或靠截图猜状态。crmkit 把 Agent 当作唯一界面：没有独立 UI，所有读写都走 https://api.crmkit.ai 的 HTTP API。技能正文就是这份操作手册，指导你用 fetch/HTTP 工具按约定发请求、读响应。

技能如何工作

认证：POST /auth/request 发邮箱验证码，POST /auth/verify 换长期 Bearer token；401 时重复流程。Token 绑定一个 workspace，换工作区需 POST /workspaces/{id}/tokens 换 token。

数据模型：联系人、公司、商机及活动日志。POST /contacts、POST /companies 按 email / domain upsert，避免重复；记录用稳定 handle（如 contact/c_ab12...）寻址。查询端点支持 field=[op:]value 过滤、search 模糊、sort、limit/cursor 分页。

约定：JSON body；PATCH 部分更新；DELETE 需两步确认（confirmation_required 后带 ?confirm=）。金额用 amount_cents + 货币代码。敏感操作（升 admin、删 workspace）要 step-up 邮件码。

MCP：POST https://api.crmkit.ai/mcp 可走 OAuth 动态注册；暴露通用工具 request，与 HTTP API 同语义。

跟进：无推送通知；在 contact/deal 上设 follow_up_at，会话开头用 GET /reminders 拉取到期项。

适用边界与注意

• 超 plan 上限会返回 plan_limit_reached（403），应先 GET /whoami 看用量。
• 默认响应为 纯文本（每行一条记录）；要 JSON 请加 Accept: application/json 或 ?format=json。
• 团队与邀请、审计、token 吊销等均在文档列出的 workspace / tokens 端点完成，技能不替代账号安全策略。