You need to enable JavaScript to run this app. 开发starboard命令时如何在Discord Bot单条消息中同时发送文本与embed?
优惠活动
大模型
产品
解决方案
定价
更多

开发starboard命令时如何在Discord Bot单条消息中同时发送文本与embed?

单条消息同时发送普通文本与Embed的实现方案

可行性说明

该需求完全具备可行性,你之前遇到的发送无效、消息拆分问题,本质是没有适配Discord开发库的消息发送参数格式导致的,不需要拆分两次发送调用。

原有方案问题原因

  • 直接拼接字符串和Embed对象的写法无效:Embed不是字符串类型,直接拼接会被转换成[object Object]这类无意义的标识,不符合Discord接口的传参要求。
  • 两次调用send方法的写法必然拆分消息:每次单独调用消息发送接口都会生成一条独立消息,自然无法合并为单条。

正确实现方式

不同版本的主流Discord开发库(如Discord.JS)都支持在同一次发送请求中同时传入普通文本和Embed,写法如下:

Discord.JS v13 / v14(官方当前推荐版本)

所有发送参数统一放在配置对象中传入:

// 替换为你的实际业务内容
const starboardText = `⭐ ${starCount}星 | #${originChannelName} 频道`;
// 初始化你需要的Embed实例
const originMessageEmbed = new EmbedBuilder()
  .setDescription(originMessage.content)
  .setAuthor({ name: originMessage.author.username, iconURL: originMessage.author.avatarURL() })
  .setFooter({ text: `原消息来自 #${originChannelName}` })
  .setTimestamp(originMessage.createdAt);

// 单条调用send方法同时传入文本和Embed
targetChannel.send({
  content: starboardText, // 普通文本放在content字段
  embeds: [originMessageEmbed] // Embed统一放在embeds数组中,即使只有一个也需要包成数组
});

兼容Discord.JS v12旧版本写法

旧版支持将普通文本作为第一个参数传入,Embed放在配置对象中:

targetChannel.send(starboardText, {
  embed: originMessageEmbed
});

注意事项

  • 普通文本长度不能超过2000字上限,Embed各字段也有独立长度限制,开发时注意控制内容大小。
  • 即使只发送1个Embed,也必须用数组包裹后传入embeds字段,否则会触发参数报错。
  • 其他语言的Discord开发库(如discord.py)逻辑完全一致:消息发送接口均支持同一次请求传入文本内容和嵌入列表,不需要拆分两次调用。

内容的提问来源于stack exchange,提问作者Wide

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 16:54:07