AppFlow:无代码部署Dify并集成到企业微信

简介: 本文介绍如何通过计算巢AppFlow完成Dify的无代码部署,并将Dify应用集成到企业微信中使用。具体步骤包括:创建企业微信应用,获取AgentID和Secret;使用计算巢AppFlow模板创建连接流,配置Dify和企业微信的鉴权凭证;配置企业微信API接收消息和可信IP;最后测试应用确保正常运行。文中还提供了常见问题的解决方案,如域名主体校验未通过和配置企业可信IP报错等。

本文将介绍如何通过计算巢AppFlow完成Dify的无代码部署并将您的Dify应用集成到企业微信中使用。

使用步骤

创建企业微信应用

  1. 访问企业微信开发者中心,扫码登录,点击立即创建。根据指引选择以企业身份创建企业内部应用
  2. 在顶部导航栏中,选择应用管理,在应用页面下半部分点击创建应用
  3. 创建应用页面,填写应用名称应用介绍,上传应用 logo,选择可见范围,完成后点击创建应用

  1. 在应用详情页面,复制 AgentID和 Secret,用于下一步创建连接流。

  1. 在顶部导航栏中,选择我的企业,在企业信息页面,复制企业 ID,用于下一步创建连接流。

使用AppFlow模版创建连接流

创建连接流

  1. 访问计算巢AppFlow模版中心,选择计算巢Dify实例系列模版或直接点击链接,选择企业微信。点击立即使用。

配置Dify鉴权凭证

  1. 点击Dify鉴权凭证并选择新建。
  2. 下拉选择计算巢实例。如果您还没有部署Dify,点击右侧按钮前往计算巢部署。

  • 在弹出框中选择您必要的参数,下单开始部署Dify实例。在弹出框中等待部署完成后,点击Dify链接进入Dify应用。

  • 设置您的管理员账号并登录进入Dify应用。
  • 创建聊天助手应用或Agent应用,并根据您的需要配置必要选项。

  • 配置完成后,按照下述步骤获取您的API访问密钥:
  • 点击左侧菜单栏“访问API”
  • 点击右上角“API密钥”
  • 点击“创建密钥”
  • 复制并保存您的API密钥,填写到AppFlow的连接凭证中

  1. 完成上述操作后,一个您私有的Dify实例就部署完成了。接下来将介绍如何创建和配置企业微信应用。

配置企业微信鉴权凭证

  1. 点击选择或添加新凭证。创建凭证对话框中,设置一个自定义凭证名称,填入之前获取的企业微信的企业ID、应用 AgentId 和 Secret。保存AppFlow生成的 Token 和 EncodingAESKey到本地、保存IP白名单到本地。点击下一步
  2. 点击保存,完成配置。
  3. 基本信息配置向导页,填写连接流名称连接流描述,完成后点击下一步
  4. 界面提示流程配置成功,复制并保存 WebhookUrl,点击发布

配置企业微信应用

有了 Webhook 地址后,接下来您可以在企业微信应用中配置接收消息来回答用户问题了。

配置API接收消息

  1. 访问企业微信应用列表。找到刚刚创建的应用,点击应用名称进入详情页面。
  2. 在应用详情页面,找到接收消息卡片,点击设置API接收

  1. API接收消息页面,您可以参考下图完成配置,然后点击保存

  • URL填入上一步复制的 WebhookUrl

如果之前未保存WebhookUrl,可访问AppFlow连接流页面,在操作列点击webhookUrl进行查看。

  • Token EncodingAESKey 填入上一步复制的值。

如果之前未保存,可访问AppFlow连接凭证页面,在公共连接器 > 企业微信中,找到刚刚配置的凭证,点击操作列的编辑从凭证中获取。

此处配置如果遇到主体域名校验未通过,请参考文末“常见问题”

配置企业可信IP

  1. 在应用详情页面,在页面下方开发者接口找到企业可信IP卡片,点击配置

  1. 在企业可信IP对话框,粘贴复制的 IP 地址,然后点击确定

测试应用

你可以在企业微信中搜索应用并发送消息,查看效果。

  1. 在企业微信顶部搜索框搜索应用名称,点击应用进入聊天。

  1. 与应用对话,进行交流互动。

常见问题

域名主体校验未通过怎么办?

当您在企业微信后台配置 API 接收消息时,报错提示“域名主体校验未通过,需配置备案主体与当前企业主体相同或有关联关系的域名”。这通常是由于企业微信的相关限制所引起的。为解决此问题,您需要配置一个企业自有域名。

  • 如果您的域名已在阿里云备案,您可以参考如下步骤创建一个二级域名作为企业自有域名。
  1. 访问AppFlow域名管理页面,单击添加域名按钮,进入添加域名页面,填入可用的二级域名,如airobot.example.com

  1. 参考CNAME 记录,将该二级域名解析到上一步的记录值
  2. 解析配置完成后,返回创建域名页面,点击提交
  3. 使用该二级域名替换API接收消息URL(即已经填写的WebhookUrl)中的主机名。
  • 如果您的域名没有在阿里云备案,您可以参考如下步骤,将API接收消息中的URL配置为您的企业自有域名,并在企业自有域名对外提供服务的Nginx上配置转发规则,将请求转发到连接流的WebhookUrl。
  1. AppFlow连接凭证页面编辑企业微信的连接凭证。

  1. 点击下一步,勾选内网代理

  1. 首次勾选内网代理时,会弹出AppFlow服务关联角色授权创建页面,请您确认并授权。

  • 如果您没有在阿里云备案的可信主体域名,同时也没有Nginx代理,可以通过点击部署Nginx代理实例一键自动为您部署并配置Nginx代理。按控制台提示直接确认订单或更改您期望的配置下单,等待部署完成即可。部署过程通常耗时1-3分钟,请刷新列表并耐心等待。
  • 部署完成后,点击下拉框选择计算巢实例,用计算巢实例Host替换API接收消息的URL(即已经填写的WebhookUrl)中的主机名,复制IP白名单并添加到企业可信IP中,点击保存,完成配置。

配置企业可信 IP 时,报错“以下IP属于第三方服务商,为保证企业数据安全,请配置本企业服务器的IP”?

报错原因:企业微信出于安全考虑,调用通讯录、身份校验接口时需要校验可信域名和可信 IP,其中一个可信 IP 仅能用于企业微信中的一个企业,如果用于多个企业将被认定为服务商,从而导致通讯录、身份校验等接口不可用。

如果您有阿里云的云服务器 ECS,您可以使用阿里云服务器进行请求转发,解决可信 IP 的问题:

  1. 修改 AppFlow 中配置的企业微信的连接凭证

  1. 修改内容:在内网代理配置页面选择使用可信主体域名 > ECS实例使用自有Nginx代理 > ECS实例,选择对应地域和实例, 点击保存。

  1. 将代理机器的 IP 添加到企业微信可信 IP。访问企业微信应用列表,进入应用详情页面,在页面下方开发者接口找到企业可信IP卡片,点击配置

如果您有自己的非阿里云的机器,您可以将自有机器托管到阿里云,并使用托管机器进行请求转发,解决可信 IP 的问题:

  1. 在您的非阿里云服务器中找一台可以访问公网的机器,按照文档安装云助手 。
  2. 修改 AppFlow 中配置的企业微信的连接凭证

  1. 修改内容:在内网代理配置页面选择使用可信主体域名 > ECS实例使用自有Nginx代理 > ECS实例,选择对应托管地域和托管实例, 点击保存

4. 将代理机器的 IP 添加到企业微信可信 IP。访问企业微信应用列表,进入应用详情页面,在页面下方开发者接口找到企业可信IP卡片,点击配置

相关实践学习
2048小游戏
基于计算巢&ECS云服务器快速部署,带您畅玩2048小游戏。
相关文章
|
Java
Springboot集成第三方jar快速实现微信、支付宝等支付场景
Springboot集成第三方jar快速实现微信、支付宝等支付场景
775 0
Springboot集成第三方jar快速实现微信、支付宝等支付场景
|
1天前
|
人工智能 安全 机器人
LangBot:无缝集成到QQ、微信等消息平台的AI聊天机器人平台
LangBot 是一个开源的多模态即时聊天机器人平台,支持多种即时通信平台和大语言模型,具备多模态交互、插件扩展和Web管理面板等功能。
138 14
LangBot:无缝集成到QQ、微信等消息平台的AI聊天机器人平台
|
2天前
|
弹性计算 人工智能 应用服务中间件
一键部署开源DeepSeek并集成到企业微信
DeepSeek近期发布了两款先进AI模型V3和R1,分别适用于通用应用和推理任务。由于官方API流量过大,建议通过阿里云的计算巢进行私有化部署,以确保稳定使用。用户无需编写代码即可完成部署,并可通过AppFlow轻松集成到钉钉、企业微信等渠道。具体步骤包括选择适合的机器资源、配置安全组、创建企业微信应用及连接流,最后完成API接收消息配置和测试应用。整个过程简单快捷,帮助用户快速搭建专属AI服务。
一键部署开源DeepSeek并集成到企业微信
|
4月前
|
人工智能 自然语言处理 关系型数据库
阿里云云原生数据仓库 AnalyticDB PostgreSQL 版已完成和开源LLMOps平台Dify官方集成
近日,阿里云云原生数据仓库 AnalyticDB PostgreSQL 版已完成和开源LLMOps平台Dify官方集成。
|
7月前
|
自然语言处理 安全 API
AppFlow:让大模型当您的微信公众号客服
使用阿里云AppFlow和通义百炼,无需编码即可将大模型如通义千问接入微信公众号。首先确保公众号已认证,然后在通义百炼导入文档创建知识库。在AppFlow中选择“微信公众号大模型自动回复”模板,添加微信凭证和百炼API密钥。配置微信公众平台的服务器地址、Token和EncodingAESKey,并设置IP白名单。完成这些步骤后,用户在公众号的提问将由大模型自动回答。AppFlow简化了集成过程,助力高效智能客服建设。
|
6月前
|
存储 人工智能 API
阿里云百炼应用实践系列-10分钟在企业微信中集成一个 AI 助手
在阿里云平台上,您只需十分钟,无需任何编码,即可在企业微信上为您的组织集成一个具备大模型能力的AI助手。此助手可24小时响应用户咨询,解答各类问题,尤其擅长处理私域问题,从而成为您企业的专属助手,有效提升用户体验及业务竞争力。
|
9月前
|
小程序 前端开发 安全
Ruoyi-vue前后端不分离集成微信小程序授权登录思路
Ruoyi-vue前后端不分离集成微信小程序授权登录思路
541 0
|
移动开发 安全 前端开发
SpringBoot集成微信支付JSAPIV3保姆教程
SpringBoot集成微信支付JSAPIV3保姆教程
440 0
SpringBoot集成微信支付JSAPIV3保姆教程
|
JSON 小程序 前端开发
java springboot集成微信小程序【详细教程】
java springboot集成微信小程序【详细教程】
|
Java Maven
集成一个以官网(微信,QQ,微博)为标准的登录分享功能
今天要分享的是一个老生常谈的一个功能,也是网上一搜一大片的技术点,没什么技术含量,就是整合一下,提供一下方便,相对于友盟,ShareSdk中夹杂着一些别的功能,此文封装的绝对纯净,除了官网所提供的,不夹杂任何的代码逻辑,登录就是登录,分享就是分享,实实在在的以官网为标准。
143 0