企业微信应用对接

最近更新时间:2025-06-25 10:52:02

我的收藏

整体概述

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

操作指引

配置方式一

创建企微应用

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



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




设置企微应用主页

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



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



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




进入企微访问

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



2. 体验效果如下:




配置方式二

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

准备工作

由于企业微信对于企业对接有域名限制,所以需要您准备一个已经备案好的域名作为代理服务器,将企微请求转发到智能体平台,否则无法完成消息收发功能,如下为 Nginx 代理转发配置示例:
server {
listen 80;
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 信息填入企微后台。



2. 进入企微后台应用详情,单击设置API接收



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




设置企微应用可信 IP

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




进入企微应用聊天

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