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

2026-04-03   访问量:0



本文档介绍了如何将基于智能体开发平台开发的 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 配置正确








热门文章
更多>