开发者社区 问答 正文

钉钉往企业内部(H5微应用)推送一些消息通知。一般看哪个接口呢?

钉钉往企业内部(H5微应用)推送一些消息通知。一般看哪个接口呢?

展开
收起
三分钟热度的鱼 2023-08-22 20:19:15 477 分享 版权
3 条回答
写回答
取消 提交回答
  • 要向钉钉企业内部推送消息通知,可以使用钉钉开放平台提供的工作通知接口。其中,/topapi/message/corpconversation/asyncsend_v2 接口常用于发送企业内部消息通知。

    以下是调用该接口的一般步骤:

    1. 获取访问令牌(Access Token):在钉钉开发者后台创建一个自建应用,并获取到访问令牌(Access Token)。您可以参考钉钉开发者文档中的相关说明来完成这一步骤。

    2. 构建请求参数:准备发送消息通知的请求参数。根据您的需求,构建合适的 JSON 数据。例如,可以设置 touser 字段指定接收通知的用户列表,msgtype 指定消息类型为 "text" 或 "markdown",并设置相应的内容。

    3. 调用接口:使用获取到的访问令牌,调用 /topapi/message/corpconversation/asyncsend_v2 接口,向企业内部发送消息通知。

      • 请求URL: https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2
      • 请求方法: POST
      • 请求参数:
        • access_token: 通过开发者后台获取到的访问令牌。
        • agent_id: 自建应用的 AgentId。
        • userid_list: 接收通知的用户列表。
        • msg: 消息内容,可以设置为文本或 Markdown 格式。
      • 示例代码:

        import requests
        import json
        
        url = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2"
        
        params = {
            "access_token": "YOUR_ACCESS_TOKEN",
            "agent_id": "YOUR_AGENT_ID",
            "userid_list": "USERID1,USERID2",
            "msg": {
                "msgtype": "text",
                "text": {
                    "content": "Hello, this is a message notification!"
                }
            }
        }
        
        headers = {'Content-Type': 'application/json'}
        response = requests.post(url, data=json.dumps(params), headers=headers)
        result = response.json()
        print(result)
        

        在示例代码中,您需要将 YOUR_ACCESS_TOKEN 替换为您获取到的访问令牌,以及 YOUR_AGENT_IDUSERID1,USERID2 替换为相应的自建应用 AgentId 和接收通知的用户列表。

    2023-08-24 22:03:31
    赞同 展开评论
  • 在钉钉中,你可以通过OAuth2.0 Token认证获取AccessToken,然后调用钉钉开放平台的消息推送接口来实现向企业内部推送消息通知的功能。

    以下是一般的过程:

    1. 获取AccessToken:首先,你需要获取一个AccessToken。你可以参考钉钉开放平台的文档来获取AccessToken。

    2. 消息推送:有了AccessToken之后,你可以调用钉钉开放平台的消息推送接口来实现消息推送的功能。具体的接口调用方式和参数设置,你可以参考钉钉开放平台的文档。

    需要注意的是,钉钉的消息推送接口只对企业内部开放,也就是说只有企业的成员才能接收消息通知。如果你是在开发一个面向外部用户的产品,你可能需要考虑其他的消息通知方案。

    2023-08-23 09:05:50
    赞同 展开评论
  • 北京阿里云ACE会长

    我已经认真阅读了 你的问题:

    【 钉钉往企业内部(H5微应用)推送一些消息通知。一般看哪个接口呢?

    并思考了

    建议如下:


    发送工作通知消息:使用 dingtalk.corp.message.corpconversation.asyncsend_v2 接口,可以向企业内指定用户或部门发送工作通知消息,包括文本、链接、附件等内容。

    发送普通消息:使用 dingtalk.im.message.send_to_conversation 接口,可以向指定会话(包括个人、群聊等)发送普通消息,支持文本、链接、图片等多种消息类型。

    发送群消息:使用 dingtalk.chat.send 接口,可以向指定的群聊发送消息,支持文本、链接、图片等多种消息类型。

    发送工作通知消息模板:使用 dingtalk.smartwork.bpms.processinstance.create 接口,可以创建工作通知消息模板,并通过模板发送消息给指定用户或部门。

    2023-08-22 22:54:24
    赞同 展开评论