成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Discord Interactions HTTP 接收与响应简报

按 Interactions Endpoint、3 秒内初始回调、interaction token 十五分钟后续与回调类型,整理 Slash/组件交互接入简报;不代持 Bot token、不代改生产端点。

场景说明

面向独立开发者:把「HTTP 收交互并按时 ACK」写成可对账步骤,区别于仅网关长连叙事。

案例叙事

01他们做了什么

独立开发者做 Discord 小工具时,常卡在:Slash 一点就「应用无响应」——其实是 HTTP 端点算太久,没在时限内 ACK。

Discord Developer Docs《Receiving and Responding to Interactions》说明:Interaction 是用户使用应用命令或消息组件时应用收到的消息;Slash 含用户提交值,User/Message 命令含解析后的用户或消息,组件含组件标识,并带 guild/channel/member 等元数据。若要通过基于 HTTP 的出站 webhook 接收交互,须为应用配置 Interactions Endpoint URL。接收与响应在底层都是 webhook:响应交互类似发 webhook 请求。可用多种回调类型,例如 PONG(ACK Ping)、CHANNEL_MESSAGE_WITH_SOURCE、DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE(先 ACK 再稍后编辑,用户见加载态)、组件场景的延迟/更新消息、自动完成结果、弹 Modal 等。对已收到的交互,可向 `/interactions/<interaction_id>/<interaction_token>/callback` 发 POST;若交互经 Gateway 收到,仍必须用 HTTP 响应,不能把响应当 Gateway 命令发送。文档写明:interaction token 有效约 15 分钟,可用于后续 followup,但必须在收到事件后 3 秒内发出初始响应,否则 token 失效。本场景据此输出 HTTP 接入与超时治理简报。禁止声称「生产 Endpoint 已验证通过」。

02实际效果

  • 源未披露量化「交互超时率」;公开文只描述 Endpoint、3 秒时限、token 窗口与回调类型。
  • 能把「超时未 ACK / 该 defer 却同步算 / Gateway 误当响应通道」拆开。
  • 为独立 Bot/组件工具提供可落地的响应时序清单。

03值得知道

  • 公钥验签等准备步骤见 Interactions Overview;本条一手源聚焦接收与响应时序与回调。
  • 回调类型对组件/Modal/Ping 有适用限制,选错类型会直接失败。
  • 上面写的是文档行为说明,不是你应用的 Endpoint 实况。

04可复制提示词

Discord Interactions 接入简报

你是 Discord Interactions 助手。只给 HTTP 接收与响应核对简报,不要编造已验证通过。

交互类型:{{interaction_kinds}}
是否已配 Interactions Endpoint:{{has_endpoint}}
超时/报错摘要:{{error}}
处理耗时预估:{{latency_estimate}}

输出 Markdown:
1. Endpoint 是否必需的提问
2. 3 秒初始响应 vs defer 选择
3. callback URL 与 token 窗口
4. 测试应用验收步骤
禁止索要 Bot token 或公钥;禁止代改生产 Endpoint。

应用无响应复盘提纲

用户反馈 Slash/按钮「应用无响应」,请写复盘提纲。

时间线:{{timeline}}
端点日志摘要:{{logs}}
是否尝试 defer:{{tried_defer}}

输出:
1. 是否超过 3 秒未初始回调
2. 回调类型是否用错
3. 是否误走 Gateway 当响应通道
4. 临时缓解与防再发
不要伪造「已全部修复」。

怎么做

  1. 粘贴交互类型(Slash/组件等)、是否已配 Interactions Endpoint、超时或回调报错摘要
  2. Agent 按官方 Receiving and Responding 说明输出:HTTP 收包→3 秒内初始响应→token 后续→回调类型选择提问清单
  3. 人工在测试应用验证;Agent 不代设置生产 Endpoint、不代持 token

实用提示

  • 经 HTTP 出站 webhook 收交互须配置 Interactions Endpoint URL;须在收到事件后 3 秒内发出初始响应,否则 token 作废
  • interaction token 约 15 分钟内可用于 followup;若交互来自 Gateway,响应仍须走 HTTP,不能当 Gateway 命令回传
#Discord#Interactions#Slash Commands#Bot#独立开发者