Support
如何设置将 Twitch 剪辑自动发布到 Discord

通过 EventSub 将新的 Twitch 剪辑自动发布到 Discord

谁适合使用将 Twitch 剪辑自动发布到 Discord 的功能

Twitch 与 Discord 的内置集成可以帮助显示直播状态、发放身份组以及通知开播。它通常不会自动将新的剪辑发布到文字频道。为此需要现成的机器人、自动化服务,或者自行搭建 Twitch EventSub 与 Discord webhook 的组合。

如果不需要开发,现成的解决方案是合适的:你连接 Twitch 和 Discord,选择频道并设置模板。在启动之前,请确认该服务响应的是剪辑的创建,而不仅仅是直播的开始。现成解决方案的缺点在于依赖套餐、可用的筛选条件以及消息的样式。

在设置 Twitch 之前先选择发布方案

为了快速验证,请创建一个私密的 Discord 频道并手动测试几个剪辑。这有助于观察延迟、检查链接卡片,并了解是否会收到那些不应进入社区的消息。

  • 现成的机器人连接更快,但可能不支持所需的发布条件以及自定义的 embed 格式。
  • 自动化构建器允许添加分支和筛选条件,但部分触发器和操作可能受服务套餐的限制。
  • 自建的 EventSub 处理器可以控制队列、模板、日志和防重复保护,但需要服务器、OAuth 以及代码维护。

请提前确定规则:发布所有剪辑、仅发布频道所有者的剪辑、发布版主的剪辑,还是仅在人工审核后发布链接。严格筛选的缺点在于——观众捕捉到的精彩瞬间可能无法发布。

为剪辑频道创建 Discord webhook

Webhook 在所需的 Discord 文字频道设置中创建。为此需要拥有管理 webhook 的权限。它以指定的名称和选定的头像发送消息,因此基础发布不需要单独的 Discord 账号。

  1. 打开剪辑将要发送到的文字频道的设置。
  2. 进入集成部分并找到 webhook。
  3. 创建一个新的 webhook,设置清晰的名称,必要时上传头像。
  4. 复制 URL 并将其保存在环境变量或安全存储中。
  5. 向私密频道发送一条测试消息。

Webhook URL 是机密。 获得此链接的人将能够以 webhook 的名义向频道发送消息。请勿将地址添加到公开仓库、面板截图或客户端代码中。一旦泄露,请删除 webhook 并创建一个新的:仅更改旧地址的 URL 是不够的。

通过 Twitch EventSub 订阅剪辑创建事件

在自建方案中,Twitch 会将 channel.clip.created 事件发送到你的处理器的 HTTPS 地址。处理器验证请求、保存剪辑数据、生成消息并将其传递给 Discord webhook。Twitch 账号在此过程中不会获得对 Discord 服务器的访问权限。

订阅需要 Twitch 应用、频道 ID、回调 URL 以及适合所选事件类型的授权。令牌和权限要求应参照 EventSub 的最新文档进行核对:它们可能会发生变化。请勿在未经验证的情况下使用旧示例中的授权参数。

频道所有者的用户令牌可能会过期或被撤销。这种方案的缺点在于——refresh token 需要安全存储并及时刷新访问权限。如果刷新失效,订阅或创建新订阅可能会在 Discord 中无明显错误的情况下停止工作。

为 Twitch 通知准备 HTTPS 地址

回调 URL 必须能够通过 HTTPS 从互联网访问。创建订阅时,Twitch 会发送一个类型为 webhook_callback_verification 的验证请求。服务器必须确认请求的真实性,并以纯文本形式返回 challenge 值。在此阶段通过之前,订阅不会变为活动状态。

工作事件以 notification 类型到达。最好快速返回成功的 HTTP 响应,并将发布任务交给队列或单独的处理程序。如果在 EventSub 请求内等待 Discord 的响应,网络延迟会增加通知被重复投递的风险。

本地开发可以使用 HTTPS 隧道。其缺点在于——公开地址在重启后可能会改变。隧道便于测试,但不能替代运行中自动化的固定 endpoint。

基于原始请求体验证签名

EventSub 签名由消息 ID、发送时间和 HTTP 请求的原始正文构成。首先获取 body 的字节,原样保存,然后验证 HMAC。不能在验证签名之前解析 JSON 再重新组装。 字段顺序、空格或编码可能会改变,计算出的签名将不匹配。

验证需要 Twitch-Eventsub-Message-Id、Twitch-Eventsub-Message-Timestamp 和 Twitch-Eventsub-Message-Signature 这几个请求头。HMAC SHA-256 的字符串按如下方式构成:messageId + timestamp + rawBody。密钥使用创建订阅时设置的 secret。结果以十六进制形式与以 sha256= 开头的请求头值进行比较。

在 Node.js 中逻辑如下:使用订阅 secret 创建 HMAC SHA-256,传入 messageId + timestamp + rawBody,在哈希前加上 sha256= 前缀,并通过 crypto.timingSafeEqual 与 Twitch-Eventsub-Message-Signature 进行比较。比较前请检查字符串长度是否相同,否则安全比较将报错。

通过 EventSub 将新 Twitch 剪辑通知传递到 Discord 频道的示意图

检查消息类型及其发送时间

每个 EventSub 请求都需要进行 HMAC 验证,包括 callback verification、notification 和 revocation。只有在验证成功后,才能读取 JSON 并根据 Twitch-Eventsub-Message-Type 请求头确定消息类型。对于 callback 验证,返回 challenge;对于 notification,创建发布任务;对于 revocation,将订阅断开的原因记录到日志中。

此外,请将 Twitch-Eventsub-Message-Timestamp 中的时间与服务器当前时间进行比对。有限的接收窗口有助于拦截第三方重复发送的旧请求。此检查不能替代 HMAC:timestamp 可以从请求中读取,但没有 secret 就无法创建正确的签名。

请将订阅 secret 与代码和 Discord webhook URL 分开存储。在没有更新流程的情况下频繁更换 secret 的缺点在于——现有订阅将无法通过验证。请先创建或更新订阅,然后在处理器中切换 secret。

不要重复发布同一个剪辑

如果 endpoint 响应时间过长、连接中断或发生网络错误,EventSub 可能会重复投递同一条通知。请将 Twitch-Eventsub-Message-Id 保存在带有唯一索引的持久化数据库中。如果该 ID 已被处理,则不要创建第二个任务,并返回成功响应。

再添加一个基于事件数据中剪辑 ID 的唯一键。这可以防止在同一个视频通过不同通知到达,或任务在故障后被重新启动时发生重复发布。请先尝试将 clip_id 写入已发布剪辑表,只有在成功写入后才向 Discord 发送消息。

这种方案有一个缺点:在写入 clip_id 和发送 webhook 之间发生故障,可能会导致剪辑被标记为已发布,但 Discord 中没有消息。对于这种情况,请存储任务状态:已创建、发送中、已发布、错误。处于错误状态的任务可以手动重试或按队列规则重试。

为 Discord 构建 embed 消息

在消息中传递剪辑标题、作者名称、频道名称、分类以及直接链接是很有用的。请勿通过字符串拼接手动将 Twitch 文本插入 JSON:引号和特殊字符可能会破坏请求。请使用语言本身的功能构建对象,并将其作为 JSON 发送。

embed 模板可以如下所示:标题「频道新剪辑」,描述「作者:{creator_name}」,URL「{clip_url}」,字段「标题」值为「{clip_title}」,字段「分类」值为「{game_name}」。如果事件中没有分类或作者名称,请将字段留空或不添加该字段。

可以添加身份组提及,但不要无限制地为每个剪辑发送。持续通知的缺点在于——服务器成员会开始关闭该频道或身份组。对于活跃频道,最好发布剪辑时不 ping,或仅按单独规则提及身份组。

在主频道发布前测试场景

首先使用测试 Discord 频道,并创建几个具有不同标题、作者和分类的剪辑。检查 callback verification 是否通过、签名是否在解析 JSON 之前完成验证、每个 clip_id 是否只出现一张卡片,以及 EventSub 重复投递时消息是否不会被发布。

  • 检查服务器是否在 JSON 解析器之前读取 raw body,或保存请求的原始字节。
  • 确保只有在 Twitch-Eventsub-Message-Signature 验证成功后才返回 challenge。
  • 检查 Discord webhook 错误的处理以及任务重试时不会创建第二条消息。
  • 查看按 message ID、clip_id、EventSub 消息类型和发送状态记录的日志。

请勿将订阅 secret、OAuth 令牌和完整的 Discord webhook URL 写入日志。用于诊断,事件 ID、剪辑 ID、Discord 响应码以及不含机密请求头的技术错误文本就足够了。

Last Articles

网站新设计

设计和功能有哪些变化 我们更新了网站,让操作更快捷、更便利。主要变化涉及界面、个人中心和订单管理。 通过优化数据库请求,页面加载速度平均提升了三分之一。导航菜单从页眉移到了左侧边栏,最近订单历史也放到了首页——无需每次都进入个人中心查看状态。 深色主题和自适应 新增了带自动模式的深色主题..

15/08/2026 新功能

News SP

Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..

08/04/2026 更新

我们为您收集了截至 01.01.2026 的所有当前促销和抽奖活动

1. 使用促销代码 "December2025" 可为我们所有观众享受 15% 折扣2. 在 1 月 1 日前,我们将 配置工具 和最 实惠的观众类别 的基础价格降低了 25%3. 我们的 频道 正在举行 3 个抽奖活动! - 如果您进入我们 购买排行榜 前 100 名,我们将赠送 500..

26/12/2025 已结束

与小队及转售商合作

抽搐服务是 工作稳定,所以我们准备与小队,经销商合作, 服务所有者,机器人所有者和许多其他人。个别条款可以在电报@TiKey_K上与管理员讨论..

22/10/2025 合作伙伴

抽搐观众是稳定的,但也有一些细微差别。

我们 已经完全更新了我们的Twitch查看器服务,他们现在是 稳定地工作。 我们只为观众使用高质量的IP地址。细微差别在于多达150名观众的订单。 当总观众数达到200时,它们就会下降.为 例如,如果您订购了140个观众,并且已经拥有100个自己的观众 现场观众,我们的140观众将下..

22/10/2025 更新

Twitch Viewer Configurator

Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..

15/06/2025 新功能

If YouTube is blocked, where to stream now?

Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..

16/03/2022 重要

API SP

We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..

02/09/2021 合作伙伴

合作夥伴與推薦:新條款!

由於合作夥伴服務和推薦計劃非常受歡迎,我們製作了一張合作表。本質很簡單:更多的現場觀眾 - 我們提供更多的廣告。下載或查看計劃條款下載集給合作夥伴(簡介 + 標誌)對於主播來說,有必要在直播上放置徽標+添加網站連結。如果不遵守這些規則,則不會提供支援。如果存在欺詐行為,則終身禁止。有關合作夥伴計劃的..

12/08/2020 合作伙伴

观众控制面板 [Twitch | Kick | YouTube | VK Video Live]

定制你的专属套餐
余额充值、一键下单、折扣和奖励 仅对注册用户开放。 注册.
如果您没有找到合适的服务或找到更便宜的,请联系 我们的 Telegram 客服 或 在线聊天,我们会解决任何问题。
新

Telegram 机器人 @BOT_SP_RU_BOT

一分钟内下单或重复下单,查看余额和订单状态 — 就在 Telegram 中

重复下单订单状态余额充值优惠码