网站模板内容怎么改,有做浏览单的网站,山东省建设监理协会网站,白沟做网站文章目录 前言准备工作1、在钉钉开发者后台创建一个钉钉企业内部应用#xff1b;2、创建并保存好应用的appKey和appSecret#xff0c;后面用于获取调用API的请求token#xff1b;3、了解AI助理主动发送消息API#xff1a;4、应用中配置好所需权限#xff1a;4.1、权限点4.… 文章目录 前言准备工作1、在钉钉开发者后台创建一个钉钉企业内部应用2、创建并保存好应用的appKey和appSecret后面用于获取调用API的请求token3、了解AI助理主动发送消息API4、应用中配置好所需权限4.1、权限点4.2、配置方式 5、配置消息卡片5.1、新建卡片 6、应用中新建AI助理 接口调用流程Maven依赖封装一个工具类查询用户信息查看响应参数调用代码示例 调用AI助理发送消息APIpostman调用效果 前言 本文针对现在钉钉提供的AI助理能力带你学会如何调用钉钉的AI助理主动发送消息API去发送一个自己配置的钉钉消息卡片给指定钉钉用户可以设想一下实现了后台对接钉钉AI助理的能力那对于你公司的行政来说就可以实现更多更灵活的工作场景比如定时给某些员工发送指定的钉钉消息卡片。AI助理API调用场景的文章CSDN目前鲜有介绍看完本文读者会明白钉钉的AI助理怎么对接。
准备工作
1、在钉钉开发者后台创建一个钉钉企业内部应用 2、创建并保存好应用的appKey和appSecret后面用于获取调用API的请求token
3、了解AI助理主动发送消息API
文档地址AI 助理预备发消息主动发送模式
4、应用中配置好所需权限
4.1、权限点 智能交互卡片写权限
4.2、配置方式 在应用管理的权限中搜索添加
5、配置消息卡片 钉钉的消息卡片模板可以配置更丰富的组件和更个性化的布局所以实际场景中一般发送使用消息卡片承载消息内容先带大家把消息卡片配好。
5.1、新建卡片 我们登录开发者后台后从“开放能力”导航栏进入“卡片平台”并且点击新建模板 填写模板创建信息包括模板名称、卡片类型这里以普通的消息卡片举例、模板场景以普通卡片举例、关联应用你创建的企业内部应用创建后就能选到 信息填好后点创建我们就进入了模板编辑页面我们可以从左边选择与拖拽自己想要的组件到卡片模板里比如按钮、文本栏、甚至表格等复杂组件像按钮这些组件还支持配置点击事件与跳转链接 我带大家配置一个包含卡片头、文本栏、点击按钮的简单卡片首先从左边拖一个卡片头过来并设置卡片头展示的内容 再拖一个文本栏过来放消息介绍描述 最后放置个按钮在最下面并且属性中填写按钮文案事件中配置点击后跳转的流程链接比如审批流程 配置完成点右上角保存即可使用注意调试期间不要点发布点发布后模板不可编辑然后在模板列表查看自己新建的模板可以得到模板ID信息后面调接口会用到
6、应用中新建AI助理 消息是通过API控制AI助理发送的需要在应用中创建一个AI助理并绑定到魔法棒应用最后发布就可以调用接口测试了
接口调用流程
Maven依赖
dependencygroupIdcom.aliyun/groupIdartifactIddingtalk/artifactIdversion2.0.14/version
/dependency封装一个工具类
工具类包含流程所需配置的读取以及token生成方法
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.aliyun.dingtalkstorage_1_0.Client;
import com.aliyun.dingtalkstorage_1_0.models.*;
import com.aliyun.teaopenapi.models.Config;
import com.remo.pms.entity.ding.FileInfoEntity;
import lombok.Data;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;
import java.util.HashMap;
import java.util.Map;Component
Data
Slf4j
public class DingDingUtils {Value(${ding-ding.clientId})private String appKey;Value(${ding-ding.clientSecret})private String appSecret;Value(${ding-ding.space-id})private String spaceId;Value(${ding-ding.union-id})private String unionId;public MapString, Object getDingDingAccessToken() {MapString, Object result new HashMap();String url https://oapi.dingtalk.com/gettoken?appkey appKey appsecret appSecret;String resultStr HttpUtils.get(url, null);JSONObject jsonObject JSON.parseObject(resultStr);result.put(access_token, jsonObject.getString(access_token));result.put(expires_in, jsonObject.getLongValue(expires_in));return result;}
}查询用户信息 调用AI助理发送消息接口前我们需要先获得发送用户的unionid我以单聊场景举例。
查看响应参数 我们先看postman调用结果返回值有我们需要的unionid每个钉钉用户有个对应的
调用代码示例
String accessToken dingDingUtils.getDingDingAccessToken().get(access_token).toString();
String url https://oapi.dingtalk.com/topapi/v2/user/get?languagezh_CN;
url url access_token accessToken ;
url url userid 用户ID;String resultStr HttpUtils.get(url, null);
JSONObject jsonObject JSON.parseObject(resultStr);
String unionId jsonObject.getJSONObject(result).getString(unionid);
log.info(unionid{}, unionId);调用AI助理发送消息API
postman调用 我们先看postman调用结果参数就只有三个unionid、content模板ID、contentType给ai_card即可注意header中还需要传入accessToken返回值有conversationToken就成功了
效果 调用完立马能看到钉钉收到消息卡片通知
