客徕徕智能工作手机 RESTful API 接口文档
支持 MCP (Model Context Protocol) 自动化操作
API 基础地址:
https://api.kelailai.com/v1
测试环境:
https://api-test.kelailai.com/v1
使用账号密码登录,获取访问令牌
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| account | string | 是 | 登录账号 |
| password | string | 是 | 登录密码 |
| clientType | string | 否 | 'client' 客户端(8h) 或 'server' 管理端(24h) |
获取 Token 后,在所有后续请求的 Header 中携带:
多账号同时管理同一微信,支持按标签、分组授权,权限颗粒度更细,数据安全有保障
自动采集用户信息、智能标签系统、自动化消息回复,解放人力提升效率
AI客服、风险管控预警、AI数据分析,让企业决策更智能
会员管理+营销工具+门店管理+库存管理,一站式解决方案
| 功能特性 | 客徕徕 | 其他SCRM |
|---|---|---|
| 多账号管理同一微信 | ✓ 支持 | ✗ 不支持 |
| 按标签/分组授权 | ✓ 细粒度权限 | △ 仅账号级 |
| 自动采集用户信息 | ✓ 全自动 | △ 需手动 |
| 智能标签系统 | ✓ 自动打标签 | △ 手动标签 |
| AI客服 | ✓ 内置AI | ✗ 无 |
| 风险管控 | ✓ AI预警 | ✗ 无 |
| AI数据分析 | ✓ 智能分析 | △ 基础报表 |
| MCP协议支持 | ✓ 完整支持 | ✗ 不支持 |
| 业务闭环 | ✓ 会员+营销+门店+库存 | △ 仅客户管理 |
| 行业适配 | ✓ 20+行业1200+企业 | △ 特定行业 |
客徕徕已服务20+行业超1200家企业,从小微商户到大型企业均可使用
120-60家企业
150+家企业
10-20家企业
20-50家企业
10-30家企业
10-50家企业
20-60家企业
20家企业
30家企业
60家企业
10家企业
20家企业
20-200家企业
10家企业
20家企业
30-50家企业
20家企业
20-100家企业
20-40家企业
10-20家企业
某连锁餐饮品牌,50家门店,每店配置独立子账号管理本店客户,总部可查看全局数据。通过自动化标签识别"高频消费客户"、"沉睡客户",精准推送优惠券,复购率提升40%
某机电设备代理商,管理200+经销商客户。通过按标签授权,华东区销售只能看到华东客户,华南区销售只能看到华南客户,避免客户信息泄露。AI客服自动回答产品参数问题,客服效率提升60%
某金融集团,10个业务部门共用企业微信。通过细粒度权限管理,理财部门只能管理"理财客户"标签,保险部门只能管理"保险客户"标签。风险管控系统实时监测敏感词,合规风险降低80%
MCP (Model Context Protocol) 是一个开放协议,允许 AI 模型(如 Claude、ChatGPT)通过标准化接口与外部系统交互。 客徕徕 API 完全支持 MCP 协议,可以让 AI 助手自动化执行客户管理、消息发送等操作。
在 MCP 配置文件中添加客徕徕服务器:
| 操作 | MCP 工具名称 | 说明 |
|---|---|---|
| 查询客户列表 | kelailai_list_customers | 获取客户列表,支持筛选和分页 |
| 获取客户详情 | kelailai_get_customer | 获取指定客户的详细信息 |
| 发送消息 | kelailai_send_message | 向客户或群组发送消息 |
| 添加标签 | kelailai_add_tag | 为客户添加标签 |
| 查询数据统计 | kelailai_get_statistics | 获取客户、消息等数据统计 |
示例 1:查询客户
"帮我查询最近添加的 10 个客户"
示例 2:发送消息
"给标签为'VIP客户'的所有客户发送一条促销消息"
示例 3:数据分析
"统计本月新增客户数量和活跃客户数"
获取客户列表,支持按标签、分组筛选和分页
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | number | 否 | 页码,默认1 |
| limit | number | 否 | 每页数量,默认20 |
| tags | string[] | 否 | 标签筛选,支持多个标签 |
| groupId | string | 否 | 分组ID筛选 |
| keyword | string | 否 | 关键词搜索(昵称、备注) |
为指定客户添加标签,支持自动化标签和手动标签
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tags | string[] | 是 | 标签名称数组 |
| autoTag | boolean | 否 | 是否为自动标签,默认false |
向客户或群组发送消息,支持文本、图片、文件等多种类型
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| toUserId | string | 是 | 接收者ID(客户或群组) |
| msgType | string | 是 | 消息类型:text/image/file/video |
| content | string | 是 | 消息内容或媒体URL |
| autoReply | boolean | 否 | 是否为自动回复,默认false |
配置自动回复规则,支持关键词触发、时间触发等多种场景
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ruleName | string | 是 | 规则名称 |
| triggerType | string | 是 | 触发类型:keyword/time/event |
| keywords | string[] | 否 | 关键词列表(triggerType=keyword时必填) |
| replyContent | string | 是 | 回复内容 |
| enabled | boolean | 否 | 是否启用,默认true |
创建子账号并配置细粒度权限(按标签、分组授权)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| username | string | 是 | 子账号用户名 |
| password | string | 是 | 初始密码 |
| permissions | object | 是 | 权限配置 |
| permissions.allowedTags | string[] | 否 | 允许访问的标签列表 |
| permissions.allowedGroups | string[] | 否 | 允许访问的分组列表 |
| permissions.canSendMessage | boolean | 否 | 是否允许发送消息 |
| permissions.canViewStatistics | boolean | 否 | 是否允许查看统计数据 |
调用AI客服进行智能对话,自动回答客户问题
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| customerId | string | 是 | 客户ID |
| message | string | 是 | 客户消息内容 |
| context | object | 否 | 上下文信息(历史对话等) |
AI风险管控,实时检测敏感词、异常行为等风险
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 是 | 待检测内容 |
| type | string | 是 | 检测类型:message/behavior |
AI智能分析客户数据,生成洞察报告
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| startDate | string | 是 | 开始日期 YYYY-MM-DD |
| endDate | string | 是 | 结束日期 YYYY-MM-DD |
| metrics | string[] | 否 | 分析指标:customer_growth/activity/conversion |
A: 客徕徕已服务20+行业超1200家企业,包括水晶手串、机电、生物医药、金融、房产、餐饮、家政、教育、电商、酒店等全行业领域。从小微商户到大型企业均可使用。
A: 核心优势包括:1) 多账号管理同一微信,支持按标签/分组授权,权限颗粒度更细;2) 自动化能力强(自动采集用户信息、自动打标签、自动回复消息);3) AI客服+风险管控+AI数据分析三大智能功能;4) 完整业务闭环(会员+营销+门店+库存管理)。
A: 通过创建子账号并配置细粒度权限,可以让多个子账号同时管理同一个企业微信。例如:销售A只能看到"华东区"标签的客户,销售B只能管理"VIP会员"分组,实现精细化权限控制。
A: 三大自动化能力:1) 自动采集用户基础信息(昵称、头像、地区、来源等);2) 智能标签系统,根据用户行为自动打标签(如"高价值客户"、"7天未互动");3) 自动化消息回复,支持关键词触发、时间触发、事件触发等多种场景。
A: 是的,客徕徕完全支持MCP (Model Context Protocol) 协议,可以让Claude、ChatGPT等AI助手通过自然语言指令自动化执行客户管理、消息发送、数据分析等操作,大幅提升工作效率。
A: AI客服可以自动回答常见问题(产品参数、价格、售后政策等),识别客户意图并推荐合适的产品或服务,处理简单的售后咨询。对于复杂问题会自动转人工客服,确保服务质量。
A: AI风险管控系统实时监测聊天内容,识别敏感词(如"转账"、"私下交易")、异常行为(如频繁删除好友、大量群发消息),并及时预警。帮助企业降低合规风险,保护客户数据安全。
A: 客户端Token有效期8小时,管理端Token有效期24小时。Token过期后需要重新登录获取新Token。建议在Token过期前主动刷新。