低代码开发平台
准备工作
编排节点应用
编排节点示例
富文本消息
新富文本消息
消息打开页面
消息打开应用

# 发送服务号消息

对接聆客服务发送服务号消息，需要提前申请服务号并授权给使用的 oauth2 客户端。

# 准备工作

  • 申请服务号，获取服务号ID；
  • 服务号授权 oauth2 客户端；
  • 引入lcdp-services-message-link插件依赖包，平台模板镜像一般默认引入，可忽略该步骤：
<dependency>
  <groupId>net.bingosoft.fuse.oss</groupId>
  <artifactId>lcdp-services-message-link</artifactId>
  <version>${lcdp.version}</version>
</dependency>
  • 配置application.yml：
services:
  link:
    service-no-id: 服务号ID
    im:
      url: 聆客消息服务地址
    client-id: 授权的客户端ID
    client-secret: 授权的客户端密钥

在线平台可考虑使用项目环境的环境变量设置：

services_link_servicenoid=服务号ID
services_link_im_url=聆客消息服务地址
services_link_clientid=授权的客户端ID
services_link_clientsecret=授权的客户端密钥

可通过注入 bean 或在 IDE 编排中的 Link 分组下找到【发送服务号消息】操作节点使用。

# 编排节点应用

在 IDE 编排中的 Link 分组下找到【发送服务号消息】操作节点，拖拽至画布中，节点参数示例如下：

节点参数解释

  • 消息类型

消息类型会影响消息的显示样式等。

  • 消息内容

富文本类型：消息只显示消息内容的文本。 新富文本类型：消息显示标题+消息内容。

  • 操作参数

值为字符串类型，用于定义点击消息后触发的动作，如打开指定地址的页面，或打开聆客内应用： 打开页面示例：https://... 打开应用示例：[OpenApp]...

  • 接收人

参数格式为 map 类型，需要点击右侧的<...>打开 jq 表达式编辑页计算返回对应类型的值。map 的 key 为用户ID，value 为用户名，数据可从 SecUser 实体或当前用户信息获取。

# 编排节点示例

根据消息样式内容、点击消息效果等场景列出常用的示例如下。

# 富文本消息

服务号消息效果参考：

# 新富文本消息

服务号消息效果参考：

# 消息打开页面

基于新富文本消息实例，增加点击消息打开指定地址窗口，设置操作参数：http://...或https://...。

服务号消息效果参考：

# 消息打开应用

基于新富文本消息实力，增加点击消息打开聆客应用，设置操作参数：[OpenApp]...。

假设聆客应用的编码为demo，其他参数有（聆客版本不同，可用参数可能不同）：

action: goto # 打开操作类型
path: /go # 打开应用的路径
query: # 拼接到打开应用地址的 query 查询参数
  entityId: id

参数用\n分割，即最终操作参数为：[OpenApp]\nappCode=demo\naction=goto\npath=/go\nquery={"entityId":"id"}

服务号消息效果参考：

顶部