/node-dingtalk-robot

node封装,钉钉机器人robot

Primary LanguageJavaScript

nodejs-dingtalk-robot

使用前必读

关于传入值和返回值的数据类型

关于错误

关于返回值

安装

初始化

var config = {
	appid: 'robot access_token'
}
const robot = new dingtalkrobot(config, false)

config说明:

  • appid - robot access_token , 每个讨论组不一样(必填)

API 使用说明

  • 初始化时已传入的参数无需调用时重复传入, 如appid

API 列表

sendText: 发送text消息

let params = {
        content: 'hello cnn!',
        at: {
            "atMobiles": [
                "159xxxx9490",
                "189xxxx8325"
            ],
            "isAtAll": false
        }
    }
robot.sendText(params, callback)

sendLink: 发送Link消息

const params = {
        "text": "这个即将发布的新版本,创始人陈航(花名“无招”)称它为“红树林”。而在此之前,每当面临重大升级,产品经理们都会取一个应景的代号,这一次,为什么是“红树林”?",
        "title": "时代的火车向前开",
        "picUrl": "",
        "messageUrl": "https://mp.weixin.qq.com/s?__biz=MzA4NjMwMTA2Ng==&mid=2650316842&idx=1&sn=60da3ea2b29f1dcc43a7c8e4a7c97a16&scene=2&srcid=09189AnRJEdIiWVaKltFzNTw&from=timeline&isappinstalled=0&key=&ascene=2&uin=&devicetype=android-23&version=26031933&nettype=WIFI"
    }
robot.sendLink(params, callback);

sendMarkdown: 发送Markdown消息

const params = {
        "title": "杭州天气",
        "text": "#### 杭州天气 @156xxxx8827\n" +
        "> 9度,西北风1级,空气良89,相对温度73%\n\n" +
        "> ![screenshot](http://image.jpg)\n" +
        "> ###### 10点20分发布 [天气](http://www.thinkpage.cn/) \n",
        "at": {
            "atMobiles": [
                "156xxxx8827",
                "189xxxx8325"
            ],
            "isAtAll": false
        }
    }
robot.sendMarkdown(params,callback)

sendActionCard: 发送ActionCard消息

const params = {
        "title": "乔布斯 20 年前想打造一间苹果咖啡厅,而它正是 Apple Store 的前身",
        "text": "![screenshot](@lADOpwk3K80C0M0FoA)         ### 乔布斯 20 年前想打造的苹果咖啡厅    Apple Store 的设计正从原来满满的科技感走向生活化,而其生活化的走向其实可以追溯到 20 年前苹果一个建立咖啡馆的计划",
        "hideAvatar": "0",
        "btnOrientation": "0",
        "singleTitle": "阅读全文",
        "singleURL": "https://www.dingtalk.com/"
    }
robot.sendActionCard(params)

sendFreeCard: 发送FreeCard消息

const params = {
        links: [
            {
                "title": "时代的火车向前开",
                "messageURL": "https://mp.weixin.qq.com/s?__biz=MzA4NjMwMTA2Ng==&mid=2650316842&idx=1&sn=60da3ea2b29f1dcc43a7c8e4a7c97a16&scene=2&srcid=09189AnRJEdIiWVaKltFzNTw&from=timeline&isappinstalled=0&key=&ascene=2&uin=&devicetype=android-23&version=26031933&nettype=WIFI",
                "picURL": "https://www.dingtalk.com/"
            },
            {
                "title": "时代的火车向前开2",
                "messageURL": "https://mp.weixin.qq.com/s?__biz=MzA4NjMwMTA2Ng==&mid=2650316842&idx=1&sn=60da3ea2b29f1dcc43a7c8e4a7c97a16&scene=2&srcid=09189AnRJEdIiWVaKltFzNTw&from=timeline&isappinstalled=0&key=&ascene=2&uin=&devicetype=android-23&version=26031933&nettype=WIFI",
                "picURL": "https://www.dingtalk.com/"
            }
        ]
    }

robot.sendFreeCard(params).then(rs=> {
    if (rs.errorCode != 0) {
        console.log('rs', rs)
    } else {
        console.log('success')
    }
})
相关默认值:
  • test - 暂未使用