需通过钉钉开放平台创建自建应用、配置权限与事件订阅、部署通义千问服务并对接钉钉网关、实现免登与用户身份映射、发布应用并完成企业授权，共五步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将通义千问企业版能力集成至钉钉工作台，实现AI助手、智能客服或自动化审批等场景，需通过钉钉开放平台完成应用创建、权限配置与模型服务对接。以下是完成该配置的具体步骤：
一、在钉钉开放平台创建自建应用
该步骤用于获取应用唯一标识（AppKey/AppSecret）及配置回调地址，是后续调用通义千问API的前提。钉钉要求所有企业自建应用必须通过开发者后台注册并完成企业授权。
1、访问钉钉开放平台，使用企业管理员账号登录。
2、进入「应用开发」→「企业内部应用」→ 点击「创建应用」。
3、填写应用名称（如“通义千问智能助手”）、应用描述、上传图标，并选择应用可见范围为本企业。
4、提交后记录页面显示的AppKey与AppSecret，二者后续用于获取access_token。
二、配置应用权限与事件订阅
为使通义千问能响应用户消息、读取会话上下文或调用业务系统接口，需为应用授予对应权限并启用消息接收能力。
1、在应用详情页点击「权限管理」，勾选以下必要权限：通讯录-读取企业全部员工信息（不可写）、消息-发送消息到群/单聊、会话-读取当前会话消息（仅限已加入会话）。
2、进入「事件订阅」，开启消息事件（text、image、event），设置服务器URL为您的通义千问服务网关地址（如https://ai.yourcompany.com/dingtalk/callback）。
3、生成并配置AES加密密钥（encodingAesKey）与Token，用于校验钉钉回调请求合法性。
三、部署通义千问企业版服务并对接钉钉网关
此步骤将通义千问推理服务封装为符合钉钉消息协议的Web API，负责接收解析后的用户文本、调用模型生成响应、格式化为钉钉支持的消息卡片或文本返回。
1、在内网或私有云环境部署通义千问2.5-7B-Instruct服务，推荐使用vLLM框架以支持高并发低延迟推理。
2、编写中间层服务（如Python Flask/FastAPI），实现钉钉消息解密、用户身份识别、会话上下文缓存（建议使用Redis存储session_id → history映射）。
3、在服务中集成钉钉SDK，调用/v1.0/im/chat/scenes/message/send接口回传响应；若需结构化展示，构造符合钉钉会话卡片规范的JSON payload。
四、配置免登与用户身份映射
确保通义千问服务能准确识别钉钉用户身份，避免会话混淆或权限越界，需通过钉钉免登机制完成OpenId与企业内部账号的绑定。
1、在钉钉前端JSAPI中调用dd.runtime.permission.requestAuthCode获取临时授权码code。
2、将code发送至您的后端服务，调用钉钉/sns/getuserinfo_bycode接口换取user_id与access_token。
3、依据user_id查询或创建本地会话ID（session_id），将其与通义千问服务中的对话历史关联，保障多轮交互连贯性。
五、发布应用并完成企业授权
配置完成后需经企业管理员审批并安装，方可对全员生效。未完成授权的应用无法接收任何消息事件。
1、返回应用详情页，点击「上线应用」，填写应用介绍、截图等信息后提交审核。
2、管理员登录钉钉管理后台（https://oa.dingtalk.com），进入「工作台管理」→「应用管理」→「待审批应用」，批准该自建应用。
3、审批通过后，在「应用管理」中点击「安装」，选择可见部门与人员范围，完成最终部署。
