钉钉应用如何搭建？

钉钉应用的搭建过程涉及多个步骤，包括创建应用、配置权限、发布应用等。以下是详细的搭建流程：

1. 创建钉钉应用

1.1 登录钉钉开放平台

• 访问钉钉开放平台，使用具有开发者权限的账号登录。
• 在页面顶部导航栏，点击应用开发，进入钉钉应用列表。

1.2 创建企业内部应用

• 点击创建应用按钮，填写以下信息：
  • 应用名称：为应用命名（如“智能问答机器人”）。
  • 应用描述：简要说明应用的功能。
  • 应用图标：上传一个符合要求的应用图标。
• 完成后点击保存，系统会自动生成应用并跳转至应用详情页面。

2. 配置应用基本信息

2.1 获取应用凭证

• 在应用详情页面中，记录以下关键信息：
  • corpId：企业标识，用于后续集成。
  • appId：应用唯一标识，用于调用API或配置渠道。
  • Client ID 和 Client Secret：在凭证与基础信息页面获取，用于授权和API调用。

2.2 配置重定向URL

• 如果需要支持用户通过钉钉扫码登录或其他单点登录功能，需配置重定向URL。
• 在应用详情页面的开发配置中，找到OAuth2.0重定向地址，填入回调地址。

3. 配置权限管理

3.1 开启所需权限

• 在应用详情页面的左侧导航栏，选择开发配置 > 权限管理。
• 根据需求开启以下权限：
  • 通讯录个人信息读权限：允许应用读取用户的个人信息。
  • 通讯录管理全部权限：允许应用管理企业的通讯录数据。
• 勾选完成后，点击批量申请以提交权限请求。

3.2 授予发送卡片消息权限

• 如果应用需要发送卡片消息（如流式返回结果），需授予以下权限：
  • Card.Streaming.Write：写入流式卡片消息。
  • Card.Instance.Write：写入卡片实例。
• 在权限管理页面搜索上述权限，并点击申请权限。

4. 配置网页应用

4.1 添加网页应用能力

• 在钉钉应用详情页面，点击添加应用能力 -> 网页应用。
• 配置以下内容：
  • 应用首页地址：填写独立页面部署地址，并在地址末尾拼接&corpId=$CORPID$。
  • 示例：https://chatbot.aliyuncs.com/intl/index.htm?locale=zh-CN&from=xxxx&corpId=$CORPID$。
  • PC首页地址（可选）：如果需要支持PC端访问，填写对应的PC端地址。

4.2 配置服务端

• 下载服务端源码并根据README文档完成配置和部署。
• 确保服务端能够处理来自钉钉的请求，并正确返回响应。

5. 发布应用

5.1 创建新版本

• 在应用详情页面的左侧导航栏，选择应用发布 > 版本管理与发布。
• 点击创建新版本，填写以下信息：
  • 应用版本号：如1.0.0。
  • 版本描述：简要说明版本更新内容。
  • 应用可用范围：选择应用的适用范围（如全部员工或部分员工）。
• 点击保存后，选择直接发布完成发布。

5.2 设置权限范围

• 在发布完成后，设置应用的权限范围：
  • 全部员工：所有企业成员均可使用。
  • 部分员工：仅授权特定用户、组织或角色。
• 完成授权后，管理员可以在钉钉工作台中为员工添加应用入口。

6. 测试与上线

• 在钉钉工作台中打开应用，测试其功能是否正常。
• 如果应用涉及AI能力（如智能问答机器人），确保已正确配置API-KEY和模型参数。
• 测试无误后，正式上线应用。

重要提醒

• 开发者权限：创建和配置钉钉应用需要具备企业内部开发者权限。如果未获得权限，请联系企业管理员开通。
• 权限管理：务必根据实际需求申请权限，避免过度授权导致安全风险。
• 独立页面部署：如果应用需要嵌入智能对话机器人，需确保独立页面部署地址正确配置。

通过以上步骤，您可以成功搭建一个钉钉应用，并将其集成到企业的工作流程中。