网站项目通过钉钉机器人向钉钉群发送信息

项目使用场景描述

PC网站内填好的数据发送至钉钉群，以钉钉机器人卡片形式发送
样例如图：

开发思路

首先我使用的是vue前端和egg.js后端(基于node.js)
开发思路流程：

网页内填写数据（表单或者其他都可以）
将数据整理到一个data里
将钉钉API相关信息与data一起通过钉钉API接口传过去
实现功能，钉钉机器人会发送消息

钉钉API简述

要将数据传到钉钉里有一个重要的参数就是access_token
这个参数的获取方法如下：
1. 首先需要有钉钉企业的开发者权限，如果没有需要跟自己企业的钉钉管理员进行申请，没有这个，后续的功能寸步难行。但是可以自己在钉钉建立一个企业组织就权限了，至少测试功能什么的够用了
2. 登录钉钉的开发者后台钉钉开发者后台，登陆后选择有开发者权限的企业，进入页面后在右上角会看到 CorpId 和 API Token ，有权限的是直接可以看到的，没权限的看到的是 ******
无权限如下图

有权限的如下图：

3. 获取appkey和 appsecret
在企业内部开发-钉钉应用里找到应用的appkey和 appsecret，没有应用的话建立一个

4. 通过 appkey和 appsecret 获取 access_token
进入钉钉开发文档，找到获取企业内部应用的access_token的方法介绍，里面有HTTP请求和JAVA SDK的两种方法，其他后端语言在API调试工具里面有方法，我用的是HTTP的方法
将 appkey和 appsecret 两个参数通过GET请求发送过去，会得到一个含有access_token的json

GET https://oapi.dingtalk.com/gettoken?appkey=appkey&appsecret=appsecret

因为某种不知名的原因，我实在后端进行请求的，不过我在后端是发送的HTTP请求
代码如下：

const appkey = '';
const appsecret = '';
const requestPromise = require("request-promise");// 获取钉钉access_token
const getAccessToken = async (corpid, corpsecret) => {const result = await requestPromise({ uri: 'https://oapi.dingtalk.com/gettoken', qs: { appkey, appsecret } });
};console.log(result);

后续涉及到钉钉的API基本都需要access_token作为参数传过去
如果使用后端进行调用access_token的话，可以使用钉钉的API在线调试工具
如果是用后端调用需要先下载安装后端对应的钉钉SDK
基本上常用的后端语言都有对应的SDK包

钉钉机器人消息发送

首先，要在企业内有一个钉钉机器人，在这里设置钉钉开放平台-企业内部应用
右侧有机器人选项，设置好之后能够看到钉钉机器人的AppKey 这个是一会要用到的

之后需要有钉钉群的群会话openConversationId，相当于群的唯一ID，通过钉钉API文档 - 中的方法获取openConversationId

还需要有一个钉钉机器人的卡片消息模板（因为我用的是卡片消息）进入到卡面模板页面创建一个卡片，拿到卡片模板的ID
准备工作做完了，下面就可以发消息了
首先先看下钉钉机器人发消息的API文档
同样有HTTP请求和后端语言的请求方法
我还是在后端用的HTTP请求，后端语言的需要自行下载SDK，并根据API调试工具生成的代码自行调整

async sendCard() {const { ctx } = this;const { Data, out_track_id, robot_code, card_template_id, open_conversation_id } = ctx.request.body; // 接收前端传来的数据let access_token = eval("(" + await getAccessToken() + ")").access_token  // 通过刚才的getAccessToken()获取access_token  // 需要将所有的参数一起打包发出去let sendval = {cardData: JSON.stringify(Data), // 前面说过的，整理好的发送的信息，别忘了用JSON.stringify()转换下格式cardBizId: out_track_id,  //  卡片的唯一ID，这个自己编写就行，就是发出来的卡片，后续可以通过这个ID对卡片进行更新等操作cardTemplateId: card_template_id,  //  卡片模板的IDrobotCode: robot_code,  //  机器人的AppKeyopenConversationId: open_conversation_id, // 群会话openConversationId}try {//  将数据通过POST请求发出去，注意access_token要在headers里面const result = await requestPromise({uri: 'https://api.dingtalk.com/v1.0/im/v1.0/robot/interactiveCards/send',method: "POST",json: true,headers: {"x-acs-dingtalk-access-token": access_token,"content-type": "application/json",},body: sendval,});// console.log(result, 'processQueryKey:');ctx.body = { errCode: 0, result };} catch (error) {console.log(error);}}

全部完整代码

'use strict';const Controller = require('egg').Controller;const appkey = '';
const appsecret = '';
const requestPromise = require("request-promise");// 获取钉钉access_token
const getAccessToken = async (corpid, corpsecret) => {const result = await requestPromise({ uri: 'https://oapi.dingtalk.com/gettoken', qs: { appkey, appsecret } });// console.log(result);return result
};class DingtalkController extends Controller {async accessToken() {const { ctx } = this;const { Data, out_track_id, robot_code, card_template_id, open_conversation_id } = ctx.request.body;let access_token = eval("(" + await getAccessToken() + ")").access_tokenlet sendval = {cardData: JSON.stringify(Data),cardBizId: out_track_id,cardTemplateId: card_template_id,robotCode: robot_code,openConversationId: open_conversation_id,}try {const result = await requestPromise({uri: 'https://api.dingtalk.com/v1.0/im/v1.0/robot/interactiveCards/send',method: "POST",json: true,headers: {"x-acs-dingtalk-access-token": access_token,"content-type": "application/json",},body: sendval,});// console.log(result, 'processQueryKey:');ctx.body = { errCode: 0, result };} catch (error) {console.log(error);}}}module.exports = DingtalkController;

钉钉开发常用网址

钉钉开发者后台 https://open-dev.dingtalk.com/#/
钉钉API在线调试工具 https://open-dev.dingtalk.com/apiExplorer#/
钉钉API开发文档 https://open.dingtalk.com/document/orgapp-server/how-to-call-apis
钉钉开放平台-企业内部应用https://open-dev.dingtalk.com/fe/app#/corp/app