开发者社区 问答 正文

钉钉如何点击卡片跳转到指定的流程,对应的链接如何获取构造?

钉钉如何点击卡片跳转到指定的流程,对应的链接如何获取构造?

展开
收起
真的很搞笑 2024-03-27 17:55:58 121 分享 版权
阿里云 AI 助理回答

在钉钉中实现点击卡片跳转到指定流程,需要通过构造特定的链接并将其嵌入到卡片消息中。以下是详细的步骤和操作说明:


1. 创建目标流程的跳转链接

要实现点击卡片跳转到指定流程,首先需要获取目标流程的URL。根据知识库中的信息,可以通过以下方式构造链接:

1.1 获取目标流程的URL

  • 如果目标流程是某个云效项目或Quick BI报表等阿里云服务页面,您需要先登录对应的服务平台(如云效、Quick BI等),找到目标流程或页面,并复制其访问链接。
  • 如果目标流程是自定义开发的应用页面,则需要确保该页面已部署并可通过公网访问,同时记录下其访问地址。

1.2 构造带参数的跳转链接

  • 在某些场景下,您可能需要向目标流程传递参数(如用户ID、任务ID等)。可以通过在URL后附加查询参数的方式实现。例如:
    https://example.com/target-process?userId=12345&taskId=67890
    

    其中,userIdtaskId 是传递给目标流程的动态参数。


2. 配置钉钉卡片消息

钉钉支持通过卡片消息实现跳转功能。以下是配置卡片消息的具体步骤:

2.1 创建卡片模板

  • 登录钉钉开发者后台,进入卡片平台,选择新建模板
  • 在模板编辑页面,设计卡片内容,并在需要跳转的部分添加超链接。例如:
    {
    "actionURL": "https://example.com/target-process?userId=12345&taskId=67890",
    "title": "点击查看详细流程",
    "text": "点击按钮跳转到指定流程"
    }
    

    其中,actionURL 是目标流程的跳转链接。

2.2 发布卡片模板

  • 完成卡片设计后,保存并发布模板,记录下生成的模板ID,用于后续创建连接流时使用。

3. 创建钉钉连接流

通过AppFlow将大模型应用与钉钉机器人连接起来,并配置卡片消息发送逻辑。

3.1 使用AppFlow模板创建连接流

  • 登录AppFlow控制台,选择模板中心,找到适合的模板并点击立即使用
  • 在连接流配置向导中,完成以下步骤:
    1. 账户授权:添加钉钉应用的Client IDClient Secret,以及API-KEY。
    2. 执行动作:填写应用ID模板ID(即上一步获取的卡片模板ID)以及目标流程的跳转链接。
    3. 基本信息:设置连接流名称和描述,完成后点击发布,并复制生成的WebhookUrl

4. 配置钉钉机器人

将连接流与钉钉机器人绑定,确保机器人能够发送包含跳转链接的卡片消息。

4.1 添加机器人能力

  • 登录钉钉开发者后台,进入应用列表,找到目标应用并进入详情页面。
  • 添加应用能力页面,找到机器人卡片,点击添加

4.2 配置机器人

  • 打开机器人配置开关,设置以下参数:
    • 消息接收模式:选择HTTP模式(重要:目前AppFlow仅支持HTTP模式,选择Stream模式会导致无法返回消息)。
    • 消息接收地址:填写上一步获取的WebhookUrl
  • 点击发布完成配置。

5. 测试跳转功能

  • 在钉钉群聊中,@机器人并发送消息触发卡片消息。
  • 点击卡片中的链接,验证是否能够成功跳转到目标流程页面。

重要提醒

  • 安全性:为防止Webhook地址泄露带来的风险,建议在钉钉自定义机器人中启用安全设置(如加签或IP白名单)。
  • 权限管理:确保应用已申请Card.Streaming.WriteCard.Instance.Write权限,否则无法发送卡片消息。
  • 链接有效性:确保目标流程的URL有效且可通过公网访问,避免因链接失效导致跳转失败。

通过以上步骤,您可以实现钉钉卡片消息点击跳转到指定流程的功能。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答