开发者文档中心

OpenAPI进入控制台

产品与快速入门 · 2026-10-31

自建渠道接入指南

选择自己的客户端,下载接入包,按准备、安装、功能接入和上线检查完成接待。

下载接入包

接入流程一览

  1. 选择方案

    按网站、小程序或 App,选择对应教程与接入包。

  2. 准备入口

    发布智能体,配置接待组,取得专用入口参数。

  3. 接入客户端

    配置域名与页面,用户点击后才打开客服。

  4. 验证收发

    验证 AI 回复、人工接管、账号切换,再发布。

选择接入平台

网站可直接嵌入现有聊天界面,也可使用同源消息 SDK。小程序提供原生聊天源码组件;App 提供网页容器源码示例。下载文件的交付形式与支持范围在各教程中说明。

1. 接入准备

  1. 准备已部署的公网 HTTPS 主机;确认企业账号、模型资源、接待权限和可用余额。
  2. 配置并发布智能体,在「渠道 → 自建渠道」创建专用渠道和服务入口,绑定智能体或工作流、人工组及服务时段。
  3. 从入口复制公开 key 与 entryId,记录自己的 baseUrl。公开入口标识用于访客接入;管理 API Key 和 AppSecret 只放服务端。

2. 安装与初始化

  1. 下载本页或具体教程提供的接入包,按对应目录集成到现有工程;保留宿主自己的签名、路由与权限配置。
  2. 按平台配置 HTTPS 来源或合法域名,替换示例中的占位值。小程序需要配置 request、uploadFile、downloadFile 域名。
  3. 用户点击“聊一聊”后再打开界面、建立会话;退出登录或切换账号前清理旧会话与回调。

3. 按需接入功能

先完成文字收发与人工接管,再按实际交付范围启用附件、客户资料、评价和业务操作。消息 SDK、网页容器和平台原生客服入口分别使用各自的协议。

4. 联调与上线

  1. 在测试入口实际发送业务问题,核对 AI 回复、人工接管和人工回复在客户界面与接待台一致。
  2. 检查手机键盘、展开收起、断网恢复、重复消息、账号切换及已启用的附件功能;App 和小程序需要真机测试。
  3. 逐项记录环境、入口、包摘要和结果。保存配置或 HTTP 成功不等于业务完成,订单、退款和工单以实际业务回执与确认结果为准。

相关文档

实现依据 · 仓库内路径
  • lib/channels/channel-products.ts
  • sdk/client-kit/README.md
  • sdk/wechat-miniapp/README.md

文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。