配置企业微信频道连接(使用webhook回调)

1. 简介

1.1 功能简介

频道是指外部 IM 渠道接入(飞书、钉钉、企业微信),绑定后用户可在 IM 中与 AI 员工对话。本文将以使用 we bhook 回调连接企业微信为例,为大家进行连接讲解。

1.2 预期效果

以连接自建应用 Jarvis 并进行对话为例,效果如下所示:

2. 连接步骤

2.1 在企业微信中创建应用

2.1.1 创建自建应用

登录 企业微信管理后台,在「应用管理 >> 自建应用」处,点击「创建应用」,输入应用 logo、应用名称、应用介绍并选择好可见范围后,点击「创建应用」即可。如下所示:

2.1.2 获取 AgentId 和 Secret

应用创建完成后,在应用详情页中查看并保存 AgentId 和 Secret。如下图所示:

2.1.3 获取企业 ID

在「我的企业 >> 企业 ID」处,查看并保存企业 ID。

2.2 在悟帆中创建频道

2.2.1 选择AI员工并添加频道

进入悟帆平台中,选择需要进行连接的 AI 员工,进入 AI 员工管理页面,在左侧能力中选择「频道」,进入频道设置页面。

2.2.2 设置频道

进入频道详情页后,点击「添加频道」,进行如下设置:

  • 选择平台:选择「企业微信」;
  • 频道名称:用户可根据业务需求自定义名称,如 Jarvis;
  • 选择模式:设置为「Webhook 回调」;
  • 企业 ID :将【2.1.3 获取企业 ID】中获取到的企业 ID 填写进去;
  • 应用 ID:将【2.1.2 获取 AgentId 和 Secret】中获取到的 AgentId 填写进去;
  • 应用密钥:将【2.1.2 获取 AgentId 和 Secret】中获取到的 Secret 填写进去。

全部设置完成后,点击「创建频道」。

2.2.3 获取回调地址

频道创建完成后,点击频道右上角的「设置」按钮,进入频道配置页面中。在「回调地址」处,复制并保存系统自动生成的回调地址。

2.3 在企业微信中配置 API

1)登录 企业微信管理后台,在「应用管理 >> 功能 >> 接收消息」处,点击「设置 API 接收」。

2)进入接收消息服务器配置页面,进行如下设置:

  • URL:将【2.2.3 获取回调地址】中获取到的回调地址填写进去;
  • Token:点击「随机获取」,复制并保存生成的随机 Token;
  • EncodingAESKey:点击「随机获取」,复制并保存生成的随机 EncodingAESKey;

注:Token 和 EncodingAESKey 生成后,先不点击「保存」,需根据【2.4 在悟帆中配置 Token 和 EncodingAESKey】在悟帆中配置并保存后,才可保存企业微信中接收消息配置,否则将导致回调地址请求不通过。

2.4 在悟帆中配置 Token 和 EncodingAESKey

进入悟帆中,在频道配置处,进行如下设置:

  • 回调 Token:将【2.3 在企业微信中配置 API 】中随机生成的 Token 填写进去;
  • EncodingAESKey:将【2.3 在企业微信中配置 API 】中随机生成的 EncodingAESKey 填写进去.

全部设置完成后,点击「保存配置」。

2.5 保存 API 接收消息配置

悟帆频道保存成功后,回到「企业微信 >> 接收消息 >> API 接收消息」页面中,点击「保存」按钮,保存 API 配置。如下所示:

2.6 设置企业可信 IP

在「应用管理 >> 开发者接口 >> 企业可信 IP」中点击「配置」,添加企业可信 IP 为 47.96.111.235,设置完成后点击「确定」。

注:若不配置企业可信 IP,可能会导致如下两种情况:

  • 和应用对话无法得到回复;
  • 出现「企业微信接口 API 连接凭证未配置」的报错提示。

文档内容是否对您有帮助?
有帮助
没帮助没帮助
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验