助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈

智能体下架回调事件

更新于: 2026-06-25 19:29:14

当开发者订阅了智能体下架回调事件后,开发者下架低代码智能体时,扣子编程会向指定的回调地址推送回调消息,消息中包含智能体的基本信息。订阅回调的具体操作请参见订阅回调

触发条件

智能体下架回调事件的触发条件如下:

回调类型

个人版

企业版(企业标准版、企业旗舰版)

普通回调

空间所有者可订阅,当工作空间中任意低代码智能体被下架时,对应的回调地址会收到智能体下架回调事件。

超级管理员和管理员可订阅,当企业内任意低代码智能体被下架时,对应的回调地址会收到智能体下架回调事件。

渠道回调

自定义渠道创建者可订阅,当该渠道中的低代码智能体被下架时,对应的回调地址会收到智能体下架回调事件。

超级管理员和管理员可订阅,当自定义渠道中的低代码智能体被下架时,对应的回调地址会收到智能体下架回调事件。

回调结构体

回调消息的结构体 Body 中包含两个主要字段:headerevent

  • header参数的参数说明请参见回调事件
  • event 参数中包括以下参数:

    字段

    类型

    说明

    bot_id

    String

    智能体 ID。

    space_id

    String

    智能体所属的空间 ID。
    订阅普通回调时会返回该参数,订阅渠道回调时不返回该参数。

    connector_id

    String

    智能体下架的渠道 ID。扣子编程官方渠道对应的渠道 ID 如下:

    • 1024:API 渠道。
    • 999:Chat SDK。
    • 10000122:扣子商店。
    • 10000113:微信客服。
    • 10000120:微信服务号。
    • 10000121:微信订阅号。
    • 10000126:抖音小程序。
    • 10000127:微信小程序。
    • 10000011:飞书。
    • 10000128:飞书多维表格。
    • 10000117:掘金。

    bot_name

    String

    智能体名称。

    description

    String

    智能体的描述信息。

回调结构体示例:

{
    "header": {
        "event_type": "bot.unpublished", //智能体下架回调事件
        "event_id": "76464a1a-eda7-48e9-b207-2db50392e60a-7509745929591717899", // 此次触发的唯一 id,用户应该用这个 id 做去重
        "created_at": 1749038258245,
        "coze_account_id": "4189602994****", // 被下架的智能体所属的空间的 owner id
        "api_app_id": "75097459295917****", // 回调应用的 id
        "connector_id": "74239893676742***" // 如果为渠道回调,这个字段会填充自定义渠道 id
    },
    "event": {
        "bot_id": "7512041635401****", // 智能体 id
        "space_id": "7309693825197****", // 智能体所属的 space_id, 仅普通回调有这个字段,渠道回调没有
        "connector_id": "10000122", //渠道 ID
        "bot_name": "智能体名称",
        "description": "智能体简介"
    }
}

响应回调

开发者服务器收到智能体下架回调后,应在 3 秒内响应,并返回 HTTP 状态码 200。

相关文档

订阅回调
接收并处理回调