> ## Documentation Index > Fetch the complete documentation index at: https://docs.coze.cn/llms.txt > Use this file to discover all available pages before exploring further. 本文介绍入驻扣子公共渠道的操作步骤。企业的超级管理员或管理员可以将企业的自定义渠道升级为公共渠道，以便智能体开发者将低代码智能体发布至公共渠道。 :::tip 说明 * **套餐限制**：扣子**企业旗舰版、原企业版**支持入驻公共渠道，单击[此处提交申请。](https://bytedance.sg.larkoffice.com/share/base/form/shrlgcE3ieqZw9kjpWoF5bcllih) * **公共渠道数量限制**：单个企业最多支持 **1** 个公共渠道。 ::: ## 功能简介 {#ae5ec0a5} 扣子编程提供标准的生态对接方式，支持网站、App、应用市场、硬件设备等厂商作为公共渠道入驻。低代码智能体开发者在扣子编程中搭建并发布低代码智能体到公共渠道之后，用户即可在对应渠道中与智能体对话。 自定义渠道支持三种授权模式，渠道管理员可以根据业务场景和安全要求选择合适的方案。具体说明如下表所示。 | | | | | \ |**方案** |**无需授权** |**设备绑定授权** |**OAuth 账号互通授权** | |---|---|---|---| | | | | | \ |**对接复杂度** |低 |中 |高 | | | | | | \ |**应用场景** |渠道仅作为内容分发平台，渠道侧不关心智能体的创建者是谁。 |* 适用于拥有实体设备的渠道，如智能玩具、智能穿戴设备等。 |\ | | |* 渠道需将设备信息同步至扣子编程。 |\ | | |* 智能体开发者在发布时将其智能体与特定设备绑定。 |* 实现渠道用户与扣子用户的账号打通。 |\ | | | |* 智能体开发者必须是渠道内的用户。 |\ | | | |* 渠道和扣子的智能体开发者权限进行联动管理。 | | | | | | \ |**渠道示例** |穿山甲、小米应用 |FoloToy、机智云物联网、显眼包 |豆包、飞书 | 渠道入驻的实现流程如下图所示。 ![Image=600x315](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c4555467a33e4452a2d37c12610f7528~tplv-goo7wpa0wc-image.image) ## 渠道管理员配置渠道入驻 {#3a7b9fe5} ### 步骤一：创建渠道 OAuth JWT 应用 {#fe840a43} 组织超级管理员或管理员在扣子编程的 [Playground](https://code.coze.cn/playground) 页面选择**授权** > **OAuth 应用**，创建一个**渠道**类型的 OAuth 应用，以便渠道侧调用扣子的 Open API 与智能体进行聊天等操作，具体请参见[OAuth JWT 授权（渠道场景）](/developer_guides/oauth_jwt_channel)。 ::::cols @col 50 ![Image=400x298](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9711606252984c668435d5d6261f9aa5~tplv-goo7wpa0wc-image.image) @col 50 ![Image=400x407](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2a6942725ef547ffb05176f7cbd3d2dd~tplv-goo7wpa0wc-image.image) :::: ### 步骤二：创建自定义渠道 {#e162ee64} 在扣子编程的**账号设置** > **发布渠道** > **企业自定义渠道管理**页签中单击**添加平台**，设置自定义渠道的头像、渠道名称和描述，并绑定步骤一中创建的渠道 OAuth 应用，详细说明请参见[步骤二：渠道管理员添加发布渠道](/vg08lpq5/configure_custom_channel1#0c6cdc91)。 ![Image=500x252](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f2c6011c7f824aeebffadfa6bd548e5e~tplv-goo7wpa0wc-image.image) ### 步骤三：配置 OAuth 授权 {#eb42d240} 在设备绑定授权和 OAuth 账号互通授权场景中，渠道侧需要获取设备信息或智能体开发者信息，需要根据对应的场景分别执行如下操作。 #### 场景一：无需授权 {#29f719d3} 在本场景中，无需进行额外的 OAuth 配置。 #### 场景二：设备绑定授权 {#8ccff534} 在设备绑定授权场景中，渠道侧需要获取设备信息，需要执行如下操作： 1. 联系扣子商务经理开通渠道设备绑定能力。 创建自定义渠道后，你需要将自定义渠道的渠道 ID 提供给扣子商务经理，申请开通渠道设备绑定的能力，并由商务经理配置设备绑定的 key。 2. 获取终端用户的 Access Token。 渠道侧通过[OAuth 授权码授权](/developer_guides/oauth_code)、[OAuth PKCE](/developer_guides/oauth_pkce)或[OAuth 设备授权](/developer_guides/oauth_device_code)获取终端用户的 Access Token。 以 OAuth PKCE 授权为例，操作方法如下，实现 PKCE 授权的详细示例代码请参见 [device_bind_connector/app.py](https://github.com/coze-dev/coze-cookbook/blob/main/examples/custom_connector/device_bind_connector/app.py)。 ::::cols @col 33 ![Image=400x202](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a6712d0282e241c7896de7caafd512c9~tplv-goo7wpa0wc-image.image) @col 33 ![Image=400x521](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c2a6654032174c1d8871c2d6930e653e~tplv-goo7wpa0wc-image.image) @col 33 ![Image=400x232](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5a6ec1f1f83642a0bf599d3aab3571d5~tplv-goo7wpa0wc-image.image) :::: 3. 绑定设备。 调用[绑定设备](/developer_guides/bind_connector_config) Open API，将设备与自定义渠道绑定，示例代码请参见 [device_bind_connector/app.py](https://github.com/coze-dev/coze-cookbook/blob/main/examples/custom_connector/device_bind_connector/app.py)。 后续开发者发布智能体到自定义渠道时，在发布配置页面的设备列表中选择对应的设备，即可快速发布到对应设备。 ![Image=500x233](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/995c98c60a9a428c9a10b482c7ac03cc~tplv-goo7wpa0wc-image.image) #### **场景三：OAuth 账号互通授权配置** {#5c100848} 在账号互通场景中，渠道侧需要获取智能体开发者信息，需要执行如下操作： 1. 渠道侧实现 OAuth Server 授权服务。 渠道侧应具备 OAuth Server 的能力，向扣子服务端提供授权服务，需实现下表中的 3 个接口，详细说明请参见[步骤三：渠道管理员配置渠道授权](/dev_how_to_guides/configure_custom_channel2#144eb84a)。实现 OAuth 授权的示例代码请参见 [OAuth 账号互通授权示例代码](https://github.com/coze-dev/coze-cookbook/blob/main/examples/custom_connector/oauth_connector/app.py)。 | | | | \ |**接口** |**示例路径** |**使用场景** | |---|---|---| | | | | \ |授权页 |`/oauth/authorize` |用户在扣子发布页面单击**授权**后，扣子自动重定向到该授权页。 | | | | | \ |获取 Token API |`/oauth/token` |授权完成后，扣子使用渠道 OAuth Server 生成的 Code，调用此接口获取 Access Token。 | | | | | \ |获取智能体开发者的用户信息 API |`/oauth/user` |获取 Access Token 后，调用此接口获取用户的 ID 和 Name，用于账号打通。 | 2. 在扣子编程配置渠道鉴权。 在扣子编程的**账号设置** > **发布渠道** > **企业自定义渠道管理**页签中，找到步骤二中添加的自定义渠道，配置 OAuth。 配置完成后，触发授权时，扣子编程会向渠道侧申请授权。 ::::cols @col 50 ![Image=500x270](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2d384967ddc447289d0fe147616ec4e9~tplv-goo7wpa0wc-image.image) @col 50 ![Image=242x283](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/687746447d54486a9ef9e709dc35a769~tplv-goo7wpa0wc-image.image) :::: ### 步骤四：订阅渠道回调 {#d06828d2} 企业超级管理员或管理员订阅渠道回调，获取对应自定义渠道中的回调信息，例如智能体发布至对应渠道、智能体从对应渠道下架、该渠道中产生的账单等。 1. 在[回调管理](https://www.coze.cn/open/callback/normal)的**渠道回调管理**页面会展示已添加的自定义渠道，单击对应渠道卡片中的**配置**，配置回调地址。参数说明请参见前文[步骤一：创建回调应用](/dev_how_to_guides/add_callback#716c8182)。 ![Image=600x357](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7e43477752204bbdb3782e889ccbe385~tplv-goo7wpa0wc-image.image) 2. 配置完成后单击**确认**，扣子服务器会向该回调地址发送一个用于校验地址有效性的 `application/json` 格式的 POST 请求。 回调的结构体示例如下： ```JSON { "header": { "event_type": "url_verification", "event_id": "bee31258-469c-48a6-ae48-648161d89c79", "created_at": 1749116452112 }, "event": { "challenge": "988df7dc-2179-4dba-95a6-af9f40b91486" } } ``` 开发者服务器接收该请求后，需要在 3s 内将`challenge`值（JSON格式）原样返回给扣子编程，否则请求地址验证将失败。 响应回调的结构体示例如下： ```JSON {"challenge":"988df7dc-2179-4dba-95a6-af9f40b91486"} ``` 3. 单击对应渠道卡片中的**订阅事件**，在弹出的对话框中开启需要订阅的事件，可订阅的回调事件列表及其说明请参见[回调事件](/dev_how_to_guides/add_callback#e63c85cc)。 ![Image=500x226](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d1c90216251b48f0a649d0453647744c~tplv-goo7wpa0wc-image.image) ### 步骤五：上线公共渠道 {#e98204a4} 联系扣子商务经理，签署渠道入驻协议，并上线公共渠道。渠道管理员需要提供渠道 ID、渠道简要介绍，以便在公共渠道页面展示对应信息。 ::::cols @col 50 获取渠道 ID ![Image=400x114](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7c5d33872e3f48a993320edb521fcde8~tplv-goo7wpa0wc-image.image) @col 50 渠道简要介绍展示示例 ![Image=400x106](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2802fa818a404d6ea827ea39a172329c~tplv-goo7wpa0wc-image.image) :::: ## 跑通渠道入驻示例代码 {#f2e4ff04} 为方便渠道管理员快速完成渠道入驻，扣子提供了详细的示例代码，可以参考示例代码完成渠道入驻。 1. 下载[渠道入驻示例代码](https://github.com/coze-dev/coze-cookbook/tree/main/examples/custom_connector)。 2. 根据选择的授权模式，修改 `.env` 配置文件。 ::::cols @col 33 无需授权 ```Bash CONNECTOR_CLIENT_ID=client_id_for_coze # 渠道分配给扣子的 client_id CONNECTOR_CLIENT_SECRET=client_secret_for_coze # 渠道分配给扣子的 client_secret CONNECTOR_USER_ID=connector_uid # 渠道的用户 uid CONNECTOR_USER_NAME=connector_name # 渠道的用户 name COZE_CALLBACK_TOKEN=3JZ9JrHhXMihsrFuCLqbPaxfqnN2JUVCIjpuarFsNxsI2aK1k9uVq6vYi4uBwKp6 # 扣子回调 token ``` @col 33 设备授权 ```Bash CONNECTOR_ID=7470849514748805170 # 渠道 id CONNECTOR_PKCE_CLIENT_ID=30367348905137699749500653976611.app.coze # pkce client id CONNECTOR_CLIENT_ID=client_id_for_coze # 渠道分配给扣子的 client_id CONNECTOR_CLIENT_SECRET=client_secret_for_coze # 渠道分配给扣子的 client_secret CONNECTOR_USER_ID=connector_uid # 渠道的用户 uid CONNECTOR_USER_NAME=connector_name # 渠道的用户 name COZE_CALLBACK_TOKEN=3JZ9JrHhXMihsrFuCLqbPaxfqnN2JUVCIjpuarFsNxsI2aK1k9uVq6vYi4uBwKp6 # 扣子回调 token ``` @col 33 OAuth 账号互通授权 ```Bash cd examples/custom_connector/device_bind_connector python -m venv ./.venv # 创建虚拟环境 source .venv/bin/activate # 激活虚拟环境 pip install -r requirements.txt # 安装依赖 python app.py # 启动程序 ``` :::: 3. 安装所需的依赖包。 1. 前往[扣子授权页面](https://www.coze.cn/open/oauth/apps)，单击渠道应用后面的**下载**按钮，将 `coze_ oauth_config.json` 下载到当前目录。 2. 运行 `app.py` 文件。 ```Bash cd examples/custom_connector/device_bind_connector #进入对应目录，请根据实际修改 python -m venv ./.venv # 创建虚拟环境 source .venv/bin/activate # 激活虚拟环境 pip install -r requirements.txt # 安装依赖 python app.py # 启动程序 ``` 程序会启动一个 127.0.0.1:5000 的 HTTP 服务器，将该服务部署到公网环境，以便接收来自扣子编程的回调。 ![Image=700x216](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0314156840fe4057921a99eeed6a8611~tplv-goo7wpa0wc-image.image) ## 相关操作 {#ad03f165} ### 渠道侧审核智能体发布 {#9c7feb5b} 开发者将智能体发布到对应的渠道后，扣子服务端会向渠道侧发送[智能体发布回调事件](/developer_guides/agent_callback_messages)。渠道侧收到回调事件后，应校验签名、从回调消息中提取信息，在渠道侧进行业务处理后，在响应中返回智能体的审核结果给扣子服务端，否则智能体发布失败。 :::tip 说明 如果审核流程无法在 10 秒内完成，自定义渠道可以先发送一条审核中的响应消息，审核结束后，再通过 API [更新审核结果](/developer_guides/update_review_result)通知扣子此智能体的最终审核结果。 ::: ![Image=454x416](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5884a6e3346e4a6cba5bbea3beafd63a~tplv-goo7wpa0wc-image.image) ```Python # 在扣子发布智能体到渠道的时候，扣子会给本接口推送一条 json 数据，包含 bot 相关信息 @app.route("/coze/callback", methods=["POST"]) @log_request_response def coze_callback(): # 获取签名和时间戳 signature = request.headers.get("X-Coze-Signature") timestamp = request.headers.get("X-Coze-Timestamp") nonce = request.headers.get("X-Coze-Nonce") if not signature or not timestamp or not nonce: return jsonify({"code": 400, "message": "缺少签名或时间戳"}), 400 # 获取请求体 body = request.get_data().decode("utf-8") if not body: return jsonify({"code": 400, "message": "请求体为空"}), 400 expected_signature = gen_coze_callback_signature( nonce, timestamp, body, COZE_CALLBACK_TOKEN ) if signature != expected_signature: return jsonify({"code": 401, "message": "签名验证失败"}), 401 event = json.loads(body) event_type = event.get("header", {}).get("event_type", "") # user_id = event.get("event", {}).get("user_id", "") # connector_user_id = event.get("event", {}).get("connector_user_id", "") bot_id = str(event.get("event", {}).get("bot_id", "")) bot_name = event.get("event", {}).get("bot_name", "") if event_type != "bot.published": return jsonify({"code": 400, "message": f"不支持处理事件 {event_type}"}), 400 # audit_status: 1: 审核中；2: 通过；3: 拒绝 if "非法" in bot_name or "违禁" in bot_name or "敏感" in bot_name: return jsonify({"audit": {"audit_status": 3, "reason": "bot 名称非法"}}), 200 if "审核中" in bot_name: return jsonify({"audit": {"audit_status": 1, "reason": ""}}), 200 save_bot(bot_id, bot_name) return jsonify({"audit": {"audit_status": 2, "reason": ""}}), 200 ``` ### 管理智能体下架 {#569569c8} 智能体下架包括开发者主动下架和渠道侧下架智能体两种场景，具体如下： * 开发者下架智能体 企业超级管理员或管理员订阅渠道回调中的**智能体下架事件**后，开发者下架智能体时，渠道侧会收到[智能体下架回调事件](/developer_guides/agent_unpublished_callback_messages)，按需执行渠道侧的下架清理逻辑，例如删除智能体展示入口。 * 渠道侧下架智能体 渠道侧在审核智能体过程中如果发现智能体不符合规范，可以调用[下架智能体](/developer_guides/unpublish_agent) API，输入下架原因，扣子会将该原因展示给开发者。 ![Image=400x385](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a6f846fc44184e02a2e2c579ec27e10c~tplv-goo7wpa0wc-image.image) ### 查看智能体配置 {#44d5f4c0} 渠道管理员可以通过如下步骤查看智能体配置： 1. 开发者发布智能体后，渠道侧从**智能体发布回调事件**中获取智能体的 ID 等信息。 2. 调用[查看智能体配置](/developer_guides/get_metadata_draft_published) API，传入获取的智能体 ID，获取智能体的详细配置信息。