将应用发布到企业微信应用

最近更新时间:2025-08-21 22:55:41

我的收藏

整体概述

本文档介绍了如何将基于智能体开发平台开发的 Agent 应用,发布至企业微信。

操作指引

配置方式一

创建企微应用

1. 登录 企业微信平台,进入应用管理 > 应用,单击创建应用



2. 填写应用名称等相关信息。




设置企微应用主页

1. 进入智能体开发平台 > 应用发布 > 调用信息 > 体验链接。



2. 进入企微应用详情 > 应用主页,单击设置后填入该链接即可。



3. 配置企微应用主页地址为智能体应用体验链接。




进入企微访问

1. 在企业微信工作台中,点击腾讯云智能体应用后可以开始对话。
注意:使用手机号登录即可。



2. 体验效果如下:




配置方式二

更适合企业定制化开发,但需要一定的开发成本。

准备工作

由于企业微信对于企业对接有域名限制,所以需要您准备一个已经备案好的域名作为代理服务器,将企微请求转发到智能体平台,否则无法完成消息收发功能,如下为 Nginx 代理转发配置示例:
server {
listen 443; # 为安全起见,要求您的域名为https协议
server_name www.example.com; # 备案好的域名
location ~ ^/cgi-bin/ { # 请求企微代理
proxy_pass https://qyapi.weixin.qq.com;
proxy_http_version 1.1;
proxy_set_header Connection "close";
proxy_buffering off;
proxy_read_timeout 600s;
proxy_send_timeout 600s;
}
location ~ ^/online/channel/callback/ {
proxy_pass https://chan.lke.cloud.tencent.com;
proxy_http_version 1.1;
proxy_set_header Connection "close";
proxy_buffering off;
proxy_read_timeout 600s;
proxy_send_timeout 600s;
}
}

创建企微应用

登录 企业微信平台,进入应用管理 > 创建应用(同配置方式一 操作指引)。

获取企微应用信息

创建完成后获取 AgentId 和 Secret。




获取企业ID

在右上角点击我的企业,可查看到企业 ID。




创建智能开发平台应用

创建企微应用成功后进入智能开发平台发布页面,单击企业微信应用进行创建。




设置企微应用回调

1. 填写企业 ID 和企微应用信息后,单击创建
注意:
1. URL 需替换为您已经配置好的域名。
2. 需要先点击创建按钮成功后,再将服务器地址(URL)、Token、EncodingAESKey 信息填入企微后台。



说明:
{您的域名} 中仅填写域名,不需要填写 IP 地址。
2. 进入企微后台应用详情,单击设置API接收



3. 将开发平台企微应用渠道详情中的信息填入企微后台。




设置企微应用可信 IP

进入应用详情页面找到 企业可信IP配置。
可信 IP 是您代理服务器的 IP(准备工作中请求 cgi / bin 接口机器的出口 IP),否则企微会拦截。




发布应用

发布应用时勾选“企业微信应用”渠道,发布成功后可在“服务状态”中查看渠道的发布状态。




进入企微应用聊天

发布成功后,进入企业微信并打开工作台,找到创建的应用,进入聊天窗口。




常见问题

如何确认我的 nginx 配置正常?

命令:curl https://{您的域名}/cgi-bin/gettoken
如下收到微信回包,则证明 nginx 配置正确