本文将介绍如何通过计算巢AppFlow完成Dify的无代码部署并将您的Dify应用集成到企业微信中使用。
使用步骤
创建企业微信应用
- 访问企业微信开发者中心，扫码登录，点击立即创建。根据指引选择以企业身份创建和企业内部应用。
- 在顶部导航栏中，选择应用管理，在应用页面下半部分点击创建应用。
- 在创建应用页面，填写应用名称和应用介绍，上传应用 logo，选择可见范围，完成后点击创建应用。
- 在应用详情页面，复制 AgentID和 Secret，用于下一步创建连接流。
- 在顶部导航栏中，选择我的企业，在企业信息页面，复制企业 ID，用于下一步创建连接流。
使用AppFlow模版创建连接流
创建连接流
配置Dify鉴权凭证
- 点击Dify鉴权凭证并选择新建。
- 下拉选择计算巢实例。如果您还没有部署Dify，点击右侧按钮前往计算巢部署。
- 在弹出框中选择您必要的参数，下单开始部署Dify实例。在弹出框中等待部署完成后，点击Dify链接进入Dify应用。
- 设置您的管理员账号并登录进入Dify应用。
- 创建聊天助手应用或Agent应用，并根据您的需要配置必要选项。
- 配置完成后，按照下述步骤获取您的API访问密钥：
- 点击左侧菜单栏“访问API”
- 点击右上角“API密钥”
- 点击“创建密钥”
- 复制并保存您的API密钥，填写到AppFlow的连接凭证中
- 完成上述操作后，一个您私有的Dify实例就部署完成了。接下来将介绍如何创建和配置企业微信应用。
配置企业微信鉴权凭证
- 点击选择或添加新凭证。在创建凭证对话框中，设置一个自定义凭证名称，填入之前获取的企业微信的企业ID、应用 AgentId 和 Secret。保存AppFlow生成的 Token 和 EncodingAESKey到本地、保存IP白名单到本地。点击下一步。
- 点击保存，完成配置。
- 在基本信息配置向导页，填写连接流名称和连接流描述，完成后点击下一步。
- 界面提示流程配置成功，复制并保存 WebhookUrl，点击发布。
配置企业微信应用
有了 Webhook 地址后，接下来您可以在企业微信应用中配置接收消息来回答用户问题了。
配置API接收消息
- 访问企业微信应用列表。找到刚刚创建的应用，点击应用名称进入详情页面。
- 在应用详情页面，找到接收消息卡片，点击设置API接收。
- 在API接收消息页面，您可以参考下图完成配置，然后点击保存。
- URL填入上一步复制的 WebhookUrl。
如果之前未保存WebhookUrl，可访问AppFlow连接流页面，在操作列点击webhookUrl进行查看。
- Token 和 EncodingAESKey 填入上一步复制的值。
如果之前未保存，可访问AppFlow连接凭证页面，在公共连接器 > 企业微信中，找到刚刚配置的凭证，点击操作列的编辑从凭证中获取。
此处配置如果遇到主体域名校验未通过，请参考文末“常见问题”
配置企业可信IP
- 在应用详情页面，在页面下方开发者接口找到企业可信IP卡片，点击配置。
- 在企业可信IP对话框，粘贴复制的 IP 地址，然后点击确定。
测试应用
你可以在企业微信中搜索应用并发送消息，查看效果。
- 在企业微信顶部搜索框搜索应用名称，点击应用进入聊天。
- 与应用对话，进行交流互动。
常见问题
域名主体校验未通过怎么办？
当您在企业微信后台配置 API 接收消息时，报错提示“域名主体校验未通过，需配置备案主体与当前企业主体相同或有关联关系的域名”。这通常是由于企业微信的相关限制所引起的。为解决此问题，您需要配置一个企业自有域名。
- 如果您的域名已在阿里云备案，您可以参考如下步骤创建一个二级域名作为企业自有域名。
- 访问AppFlow域名管理页面，单击添加域名按钮，进入添加域名页面，填入可用的二级域名，如
airobot.example.com。
- 如果您的域名没有在阿里云备案，您可以参考如下步骤，将API接收消息中的URL配置为您的企业自有域名，并在企业自有域名对外提供服务的Nginx上配置转发规则，将请求转发到连接流的WebhookUrl。
- 在AppFlow的连接凭证页面编辑企业微信的连接凭证。
- 点击下一步，勾选内网代理。
- 首次勾选内网代理时，会弹出AppFlow服务关联角色授权创建页面，请您确认并授权。
- 如果您没有在阿里云备案的可信主体域名，同时也没有Nginx代理，可以通过点击部署Nginx代理实例一键自动为您部署并配置Nginx代理。按控制台提示直接确认订单或更改您期望的配置下单，等待部署完成即可。部署过程通常耗时1-3分钟，请刷新列表并耐心等待。
- 部署完成后，点击下拉框选择计算巢实例，用计算巢实例Host替换API接收消息的URL（即已经填写的WebhookUrl）中的主机名，复制IP白名单并添加到企业可信IP中，点击保存，完成配置。
配置企业可信 IP 时，报错“以下IP属于第三方服务商，为保证企业数据安全，请配置本企业服务器的IP”？
报错原因：企业微信出于安全考虑，调用通讯录、身份校验接口时需要校验可信域名和可信 IP，其中一个可信 IP 仅能用于企业微信中的一个企业，如果用于多个企业将被认定为服务商，从而导致通讯录、身份校验等接口不可用。
如果您有阿里云的云服务器 ECS，您可以使用阿里云服务器进行请求转发，解决可信 IP 的问题：
- 修改 AppFlow 中配置的企业微信的连接凭证
- 修改内容：在内网代理配置页面选择使用可信主体域名 > ECS实例或使用自有Nginx代理 > ECS实例，选择对应地域和实例， 点击保存。
- 将代理机器的 IP 添加到企业微信可信 IP。访问企业微信应用列表，进入应用详情页面，在页面下方开发者接口找到企业可信IP卡片，点击配置。
如果您有自己的非阿里云的机器，您可以将自有机器托管到阿里云，并使用托管机器进行请求转发，解决可信 IP 的问题：
- 在您的非阿里云服务器中找一台可以访问公网的机器，按照文档安装云助手 。
- 修改 AppFlow 中配置的企业微信的连接凭证
- 修改内容：在内网代理配置页面选择使用可信主体域名 > ECS实例或使用自有Nginx代理 > ECS实例，选择对应托管地域和托管实例， 点击保存。
4. 将代理机器的 IP 添加到企业微信可信 IP。访问企业微信应用列表，进入应用详情页面，在页面下方开发者接口找到企业可信IP卡片，点击配置。
