一、整体概述
·长连接（WebSocket）模式（推荐）：由 ADP 服务端主动与企微建立 WebSocket 长连接，无需公网域名/IP、无需配置 Nginx，配置简洁、实时性高、安全性好，是企微推荐的接入方式。
·URL 回调（Webhook）模式：由企微通过 HTTP 回调推送消息，需要你准备已备案域名并自行搭建 Nginx 转发。适合已有完善网关/代理体系、希望沿用 Webhook 接入方式的企业。
二、使用场景
1. 用户群里 @智能机器人 发送消息。
2. 用户单聊智能机器人发送消息。
三、使用限制
1. 一个应用只能发布到一个智能机器人中。
2. 同一机器人同一时间只能保持一种接入方式（长连接 / URL 回调），切换模式会使另一种失效。
3. 长连接模式下，每个机器人同一时间只能保持一个有效长连接。
五、1. 长连接模式（扫码绑定）
1.1 在 智能体开发平台 中，进入应用开发 > 查看应用 > 应用发布 > 发布渠道，单击 新建发布渠道，选择 企微智能机器人。
1.2 在连接方式中选择使用长连接，选择扫码绑定。
1.3 单击扫码绑定，使用手机企业微信扫描二维码。
1.4 扫码后在手机端进行信息确认后即绑定成功。
1.5 单击保存，完成渠道配置。
七、步骤一：创建企微智能机器人
1. 登录 企业微信管理后台，进入安全与管理 > 管理工具 ，单击智能机器人。
2. 单击创建机器人。
3. 填写机器人内的必填信息。
4. 单击创建。
八、步骤二：获取 Bot ID 和 Secret
1. 返回 安全与管理 > 管理工具 > 智能机器人，进入智能机器人 详情 页面，点击右上角编辑图标。
2. 进入编辑页面选择 API 模式创建。
3. 在「连接方式」区域，选择 「使用长连接」。
4. 页面自动生成 Bot ID 和 Secret，复制保存。
5. 在智能体开发平台中，进入 应用开发 > 查看应用 > 应用发布 > 发布渠道，单击新建发布渠道，选择企微智能机器人。
6. 在连接方式中选择 使用长连接，填入上述步骤获取的 企业 ID、Bot ID 和 Secret。
7. 单击保存，完成渠道配置。
九、步骤三：发布应用
1. 完成以上步骤后，进入 智能体开发平台，单击发布后选择企微智能机器人渠道进行发布。
注意：说明：
注意：如果应用刚刚发布过，发布按钮无法点击，可以修改应用配置、知识管理中的内容后发布。
2. 发布成功后，在应用发布 > 服务状态 中可以查看发布渠道的状态。
十一、步骤一：创建企微智能机器人
1. 登录 企业微信管理后台，进入安全与管理 > 管理工具 ，点击智能机器人。
2. 单击创建机器人。
3. 填写机器人内的必填信息。
4. 单击创建。
十二、步骤二：获取企业 ID
单击我的企业，复制企业 ID。
十三、步骤三：获取机器人ID
1. 返回安全与管理 > 管理工具 > 智能机器人，进入智能机器人详情页面，点击右上角“编辑图标”。
2. 进入编辑页面选择API模式创建。
3. 复制 Bot ID（机器人 ID），后续将在智能体开发平台中使用。
注意：复制机器人 ID 后先不要关闭页面，后续需要从智能体开发平台中拿到 URL 等信息填入。
十四、步骤四：在智能体开发平台中创建发布渠道
准备工作，由于企业微信对于企业对接有域名限制，所以需要你准备一个已经备案好的域名作为代理服务器，将企微请求转发到智能体平台，否则无法完成消息收发功能，如下为 Nginx 代理转发配置示例：
server { listen 443; # 为安全起见，要求你的域名为https协议 server_name www.example.com; # 备案好的域名 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; }}
注意：说明：
注意：1. 点击查看如何 注册域名。
注意：2. 如果你想实现自行搭建 URL 转发或指定访问接口，请参见 自建 Nginx，实现 URL 转发和指定访问端口。
1. 登录 智能体开发平台，进入应用开发 > 查看应用 > 应用发布 > 发布渠道，单击新建发布渠道，选择企微智能机器人。
2. 填入上述步骤复制的 企业ID 和 Bot ID，并在服务器地址（URL）中替换为你的域名。
注意：1. 需配置备案主体与当前企业主体相同或有关联关系的域名。
注意：2. {替换为你的域名} 中仅填写域名，不需要填写IP地址。
注意：3. 可以与对接企业微信应用渠道使用相同域名。
3. 单击创建后，收到创建成功通知即完成创建。
十五、步骤五：配置回调地址
1. 在智能体开发平台，进入刚创建的企微智能机器人渠道详情页面，复制对应参数。
2. 在企业微信管理后台智能机器人的编辑页面（参考 步骤三），在 API 模式下填入智能体开发平台中获取的参数信息。
3. 单击保存后自动进入到下图页面，配置成功。
十六、步骤六：在智能体开发平台中发布应用
1. 完成以上步骤后，进入 智能体开发平台，单击发布后选择企微智能机器人渠道进行发布。
注意：说明：
注意：如果应用刚刚发布过，发布按钮无法点击，可以修改应用配置、知识管理中的内容后发布。
2. 发布成功后，在应用发布 > 服务状态 中可以查看发布渠道的状态。
十七、效果体验
1. 用户登录企业微信客户端，进入通讯录找到智能机器人可以发起单聊。
2. 企微智能机器人支持群聊，拉群时选择智能机器人。
@智能机器人 发起提问，对话中有思考过程和流式输出效果。
十八、内置快捷指令
当前支持以下指令，在企业微信机器人对话框中输入即可生效。
| 中文指令 | 英文指令 | 说明 |
| 新建对话 | /new | 开启新的对话 |
| 清除上下文关联 | /clear | 清空当前对话上下文 |
20、超时自动清空上下文
在应用的对话体验设置中，开启超时自动清空上下文后，当超过设定时长用户未发送新消息时，系统自动清空当前对话上下文，后续对话从零开始。该设置对所有发布渠道均适用。
·默认关闭，开启后默认 6 小时，可根据需要修改。
·清空上下文后，工作区文件不受影响。
注意：说明：
注意：超时清空仅清除对话上下文，工作区文件不受影响。建议同时开启长期记忆，避免关键信息随上下文一起清除。
21、在群聊中共享上下文
在发布渠道设置中，开启在群聊中共享上下文后，机器人在企微群中的对话上下文将在群内成员间共享（仅 @机器人的对话上下文，不包括群聊中全部对话）。
在对话中输入 /clear 指令可手动清空当前对话上下文，工作区文件保留不变。
23、1. 为什么企业需要准备提供域名和 Nginx?
企业微信限制：机器人通过 Webhook 发送消息时，需要将消息推送到一个指定的 URL，不同企业需对应不同的域名。
企业需要配置Nginx将企业微信的消息，抄送到腾讯云智能体。
24、2. 如何查看 Nginx 出口 IP？
curl http://ifconfig.me
25、3. 如何确认我的 Nginx 配置正常？
curl -vvv https://{替换为你的域名}/online/channel/callback/wecomrobot/xxx收到http code200 :配置成功404 :Nginx loaction配置有误，请检查该path是否正确配置转发 /online/channel/callback/500 :Nginx 服务内部错误、请企业联系运维人员检查服务是否正常。
26、4. 如何清除上下文以及新建对话？
清除上下文：输入 “清除上下文关联”或 “/clear”。
新建对话：输入 “新建对话”或“/new”，即可切换为一个新的 session ID。
27、5. 如何控制是否显示参考来源？
知识管理 > 文档 > 展示参考来源 。
打开展示参考来源按钮后,当智能体命中知识库文档时，即可展示出参考来源。
28、6. 支持返回的最大字数限制是多少？
企业微信限制：每次最多支持返回2048个字节。
注意：说明：