# 配置渠道入驻(账号隔离)
对于个人自建网站等业务需求较为简单的场景,通常由渠道侧提供智能体对话能力、统一管理智能体的使用与维护方式。该场景下不支持渠道用户以个人身份管理或维护扣子智能体,智能体无需绑定渠道侧的用户账号体系,且无需智能体开发者手动授权渠道,配置与发布流程更加简便快捷。
该方案通常可以按需配置消息回调,且不需要在渠道服务端实现 OAuth Server 的授权能力,只需要配置 JWT 的授权流程、添加发布渠道,就可以在渠道服务端调用扣子 OpenAPI,在渠道平台中以平台身份管理和维护智能体,向渠智能体对话服务。
该方案通常适用于业务架构较为简单的应用服务,例如个人自建网站、应用程序等。
## 对接流程

## 步骤一:渠道管理员配置 JWT 授权流程
创建一个渠道类型的 OAuth 应用,并在渠道侧实现 JWT 的授权流程、具备获取 OAuth Access Token 的能力。
授权流程可参考[OAuth JWT 授权(渠道场景)](https://docs.coze.cn/api/open/docs/developer_guides/oauth_jwt_channel)。
## 步骤二:渠道管理员添加发布渠道
渠道管理员应在扣子编程中添加一个发布渠道。发布渠道是智能体发布到的目标平台,完成渠道入驻的所有配置之后,平台用户可以在平台中和智能体对话。添加发布渠道的本质是在扣子中填写平台相关的配置及权限。
1. 登录扣子编程。
2. 在页面左下角单击用户头像,并选择**账号设置**。
3. 在**设置**页面的左侧导航栏选择**发布渠道** 。
在**企业自定义渠道管理**页面单击**添加平台。**

在**我的渠道管理**页面单击**添加平台**。

4. 填写目标渠道的配置。
| **配置** | **说明** |
| --- | --- |
| 图标 | 自定义渠道提供一个默认图标,单击渠道图标可更换一个图标。 |
| 平台名称 | 自定义渠道的名称,将显示在智能体的发布页面。 |
| 描述 | 渠道的描述信息,在智能体的发布页面中 hover 展示。 |
| 绑定 OAuth 应用 | 为自定义渠道绑定一个 OAuth 应用。
自定义渠道通过扣子 OpenAPI 接入扣子并使用智能体,调用 OpenAPI 时通过 OAuth 鉴权方式获取 OAuth Access Token。为渠道绑定 OAuth 应用后,这个 OAuth 应用生成的 OAuth Access Token 将拥有所有发布到此渠道的智能体的操作权限。具体的操作权限可参考此 OAuth 应用中选择的权限列表。 |
配置示例:

配置效果:

5. 单击**确认**。
## 步骤三:开发者发布智能体到渠道
成功创建自定义渠道后,指定工作空间中的开发者可以在发布页中选中该渠道,并将智能体发布到渠道中。
发布智能体时,开发者无需配置鉴权,直接选择步骤二中创建的渠道,并单击**发布**即可。

## 步骤四:(可选)渠道服务端处理消息回调
渠道管理员订阅渠道回调,具体请参见[订阅渠道回调](https://docs.coze.cn/api/open/docs/dev_how_to_guides/add_callback#72098317)。
当有智能体发布到此渠道时,扣子服务端会发送一条 `application/json` 格式的 POST 请求。渠道侧收到消息回调后,应校验签名、从回调消息中提取信息,在渠道侧进行业务处理后,返回处理结果给扣子服务端。
目前支持的回调事件类型、渠道侧的处理方式及回调事件的详细定义可参考[接收并处理回调](https://docs.coze.cn/api/open/docs/dev_how_to_guides/receive_handle_callbacks)。

## 步骤五:渠道服务端调用扣子 API
自定义渠道通过服务端调用扣子 OpenAPI 来使用智能体,例如查看智能体详情、和智能体对话等。您的自建网站等渠道中可以定义通过 OpenAPI 与智能体对话的相关业务流程,将智能体提供给渠道用户使用。
渠道服务端调用扣子 OpenAPI 前,必须通过渠道类型的 OAuth 应用授权,且通过此应用生成 JWT 类型的 OAuth Access Token,而开发者应用程序则可以使用 PAT 等多种类型的 OAuth Access Token。默认情况下,为渠道绑定 OAuth 应用后,这个 Oauth 应用生成的 OAuth Access Token 将拥有所有发布到此渠道的智能体的操作权限。具体的操作权限可参考此 OAuth 应用中选择的权限列表。如果渠道侧希望限制 OAuth Access Token 的操作权限,可以在申请的 OAuth Access Token 时,通过 scope 参数指定令牌的操作权限,例如此令牌只能和智能体 A 对话,不能执行其他操作。详细说明可参考[通过 JWT 获取 Oauth Access Token](https://docs.coze.cn/api/open/docs/developer_guides/oauth_jwt#a458f4b1)。
