1.安装服务程序
由于钉钉接口的限制,每个钉钉企业组织只能由企业内部服务器进行发起api调用,需要在安装云表的服务器上进行钉钉api转发请求
高于3.3.47.40云表服务器版本以上则不需要安装配置转发服务
低于以上版本,需要跟云表官方客服索要一个压缩包:钉钉api访问跳转nginx-20231213.zip,将此压缩包放置在云表服务程序所在的服务器上。解压后,双击start_nginx.bat启动服务,该nginx服务会默认开启888端口。
如果有自行搭建的nginx转发服务,可以自行配置即可,配置参考如下
server {
listen 888;
#server_name localhost 127.0.0.1 ;
location ^~/oapi-dingtalk-com/ {
proxy_pass https://oapi.dingtalk.com/;
proxy_redirect off;
}
location ^~/api-dingtalk-com/ {
proxy_pass https://api.dingtalk.com/;
proxy_redirect off;
}
location / {
proxy_pass https://oapi.dingtalk.com/;
proxy_redirect off;
}
}
2.对接钉钉配置方法
2.1开通钉钉授权功能
①登录云表官网,找到需要对接钉钉的应用空间,点击应用空间管理,在钉钉授权(微应用),点击开通。
②这里需要输入企业名称、企业ID和AppId等信息,这些信息在后面的操作中获取。
2.2在钉钉工作台添加微应用
①用网页登录钉钉https://open-dev.dingtalk.com/fe/app#/corp/app,点击应用开发,在“钉钉应用”中创建应用。
②填写应用名称、描述、上传应用图标,创建应用
③添加应用能力,选择“网页应用”添加
应用首页地址:访问云表应用空间的地址,如http://xxx.xxx.xxx/10001
PC端首页地址:访问云表应用空间的地址,如http://xxx.xxx.xxx/10001
④点击“安全设置”,填写出口云表服务器出口IP及重定向URL
服务器出口IP的填写方式为:在百度中输入“ip地址”,将查询到的外网出口IP写入到服务器出口IP处。
重定向URL:填写云表应用的外网访问地址,如http://xxx.xxx.xxx/10001
⑤点击“权限管理”,申请以下截图的权限。
2.3把企业信息写入管理控制台
点击“凭证与基础信息”,这里可以查询到对接所需要的AgentId、AppKey和AppSecret等信息
将获取到的企业名称、企业ID、Agentld、AppKey、AppSecret、钉钉API地址写入到云表的应用设置中即可完成对接。
钉钉接口版本:新创建的钉钉应用,一律只能选择新版V2版本
钉钉API转发地址:云表服务器版本在3.3.47.40以上版本,可以留空,系统自动根据当前云表服务器的外网地址进行补充填写;低于该版本,需要按文章前面部分,部署nginx开启888端口,V2版转发地址填写http://外网访问地址:888/api-dingtalk-com/
重启云表服务器,使用手机打开钉钉,会看到一个云表的应用。
点击进入应用,输入手机号进行绑定,然后输入验证码即可登录进云表应用空间。