手把手教你创建钉钉机器人(一)

940 阅读4分钟

我报名参加金石计划1期挑战——瓜分10万奖池,这是我的第1篇文章,点击查看活动详情

前言

  不知道大家有没有刷小红书的习惯,前一段我在刷小红书的时候总是刷到这样的文章(虽然我知道是我越看这种文章他越推),给npy做一个天气推送公众号,作为开发人员一看便知,全文最主要的只是微信提供的API接口而已;再者经常接触小程序或公众号的开发人员都知道,在没有企业资质的情况下想要做到消息推送,只有通过小程序的公共模板,才勉强能够实现推送。

  个人未认证的公众号是无法推送公众号消息的,所以大部分的文章都是用微信提供的一个测试公众号接口实现推送,这种推送第一不会展示到微信消息列表,其次没有消息提示,其实感觉并没有实现的必要。

  这篇文章我们就来创建钉钉上的推送机器人🛴

开发需求

  通过钉钉机器人向钉钉群推送自定义的模板消息 🛰

创建流程

钉钉APP

  由于钉钉机器人属于企业内部应用,在公司的账号上肯定是不便实现的。所以我们首先需要做的是 在钉钉app上创建自己的企业/团队/组织,这样也方便我们自己调试,一般来说的话创建组织就够用了。

1663057008694.jpg

钉钉开放平台

 完成上面的步骤之后,就可以在我们的组织上创建机器人应用啦。

 我们需要登录到 钉钉开发者后台界面 ,我们选择第一个卡片上的企业应用点击快速创建

1663035964534.jpg

  之后我们会来到企业内部应用开发界面,选择左侧导航栏中的机器人创建应用,并填写机器人的相关信息。

1663036275551.jpg

1663036428905.jpg

到这里就算创建成功啦!

1663036616842.jpg

钉钉PC

这时候你的钉钉上就会出现一个XX-TEST内部测试群,进入该群设置选项,选择智能群助手

为你的组织添加机器人,选择自定义机器人,简单的补充下相关信息就创建完成了。

创建完成后需要获取和配置机器人信息,点击刚刚创建好的小机器人。

获取webhook

我们需要复制 Webhook 这个地址后面用于消息推送使用(确保上方消息推送功能也是开启的哦

image.png

配置安全设置

这里我们可以选择自定义关键词、加签、IP地址(段)的形式保护我们的机器人安全

  1. 自定义关键词

    最多可以设置10个关键词,消息中至少包含其中1个关键词才可以发送成功。

    简单来说就是你推送的消息里面一定要有你设置的词语才能保证推送成功。

  2. 加签

    timestamp+"\n"+密钥当做签名字符串,使用HmacSHA256算法计算签名,然后进行Base64 encode,最后再把签名参数再进行urlEncode,得到最终的签名

    其实就是在推送接口中多拼接上一个签名参数。

  3. IP地址(段)

    只有来自IP地址范围内的请求才会被正常处理

    我理解的就是跨域拦截,配置自己的服务器IP地址段,相比前两种安全性最高。(前提是你的服务器安全性也得保证

因为我的组织只有两个人,不需要很高的安全性,所以我这里用最容易配置的自定义关键字

57572adb4ce689b1dbe6c59d90650c9.jpg

使用体验

接下来就可以通过webhook地址测试推送服务:

注意,调用POST请求数据格式要和下图格式一致,否则会报错。

{
    msgtype: "text", // 这里使用text类型发送普通文本,其他类型见下方文档
    text: {
        content: "这是一条测试数据。",  // 需要推送的文字
    }
}

1663040479908.jpg

1f15dffb63e0c05e405652db4511807.jpg

image.png

image.png

结语

如果文中有描述不对的地方,欢迎及时指正!!

下期更新node定时任务,这样就可以配合机器人API每天定时发送消息了

相关文档

什么是机器人

自定义机器人接入

自定义机器人安全设置