微盛企微管家 SCRM

官方免费 云插件。本文依据插件市场当前上架信息与平台导入目录中的工具定义编写；不提供调用示例。

功能说明

查询和管理企微管家中的客户、标签、客户群、营销素材、活码、群发、跟进记录和商机。

接入与授权

填写企微管家中生成的 APP KEY。

授权字段	页面名称	必填	类型
app_key	APP KEY	是	令牌输入框

授权材料获取入口：https://docs.qq.com/doc/p/7695c3515c714ddc9b1e233c0c0c5c550ac82332?nlc=1

授权信息仅用于当前用户的插件调用。请勿在提示词、工作流变量、日志或文档中填写令牌、密码、访问密钥或私有密钥。

工具目录

工具	说明
check_identity	验证 APP KEY 并返回当前用户在 SCRM 中的身份和角色。
list_apis	按关键词搜索可用的 SCRM API，返回接口名称、描述和文档 URL。
fetch_api_doc	读取 list_apis 返回的 SCRM API 文档和结构化参数定义。
call_api	严格按指定 SCRM API 文档校验参数并调用接口；调用时会重新读取文档，不依赖历史沙箱状态。
upload_image	从公网 URL 下载不超过 20MB 的图片并上传到 SCRM，返回 URL 和文件 ID。
fetch_url	读取公网 HTTP(S) URL 的文本内容；拒绝回环、内网和保留地址。

工具与参数

check_identity

验证 APP KEY 并返回当前用户在 SCRM 中的身份和角色。

输入参数

无输入参数。

返回字段

字段	类型	必返	说明
user_id	string	是	—
user_name	string	否	—
super_user	integer	否	—
limit	integer	否	—
role_description	string	是	—

list_apis

按关键词搜索可用的 SCRM API，返回接口名称、描述和文档 URL。

输入参数

参数	类型	必填	说明
keyword	string	是	搜索关键词，多个关键词用逗号分隔

返回字段

字段	类型	必返	说明
total	integer	是	—
records	array<object>	是	—

fetch_api_doc

读取 list_apis 返回的 SCRM API 文档和结构化参数定义。

输入参数

参数	类型	必填	说明
doc_url	string	是	—

返回字段

字段	类型	必返	说明
content	string	是	—
field_input_spec	object	否	—
warnings	array<object>	是	—

call_api

严格按指定 SCRM API 文档校验参数并调用接口；调用时会重新读取文档，不依赖历史沙箱状态。

输入参数

参数	类型	必填	说明
doc_url	string	是	—
biz_params	object	是	文档定义的路径、查询和请求体参数

返回字段

字段	类型	必返	说明
response	object	否	—
write_operation	boolean	是	—
api_name	string	是	—
warnings	array<object>	否	—

upload_image

从公网 URL 下载不超过 20MB 的图片并上传到 SCRM，返回 URL 和文件 ID。

输入参数

参数	类型	必填	说明
file_url	string	是	公网可下载的图片 URL

返回字段

字段	类型	必返	说明
url	string	是	—
file_id	string	否	—

fetch_url

读取公网 HTTP(S) URL 的文本内容；拒绝回环、内网和保留地址。

输入参数

参数	类型	必填	说明
url	string	是	—

返回字段

字段	类型	必返	说明
url	string	是	—
content	string	是	—
truncated	boolean	是	—

使用约束

• 先在插件市场安装插件，再将其添加到智能体或工作流；插件参数由对应工具节点配置。
• 对会改变外部数据的工具（例如发送邮件、创建生成任务、领取权益或财务操作），应在智能体指令中要求用户明确确认后再执行。
• 调用失败时应检查授权状态、必填字段、提供方配额和网络可达性；不要用编造的数据替代工具结果。