SuperAPI AI 工具集

discord-send-message

编程与开发

查看项目

更新于 10-16 01:37

技能介绍

用途:通过 Discord API v10 的创建消息接口向指定 Discord 频道发送消息,适用于发送文本消息、通知、公告、Markdown 格式化内容、嵌入(embed)富内容,以及以编程方式回复或与 Discord 互动。

必要前提:需设置 DISCORD_BOT_TOKEN 环境变量;机器人必须是目标服务器成员;在目标频道拥有“Send Messages”权限;需提供有效的频道 ID(18-19 位 snowflake 数字)。

使用方式:先校验令牌、频道 ID 和消息内容非空,再从用户请求提取内容并按需格式化 Markdown 或构造 embed JSON,随后发起请求: curl -X POST "https://discord.com/api/v10/channels/{CHANNEL_ID}/messages"
-H "Authorization: Bot ${DISCORD_BOT_TOKEN}"
-H "Content-Type: application/json"
-d '{"content": "Your message here"}' 其中 {CHANNEL_ID} 替换为实际频道 ID,content 替换为实际消息内容。

消息格式:支持纯文本、Markdown(加粗、斜体、行内代码、链接)、embed(可含 title、description、color、fields 等),以及文本加 embed 组合。

校验规则:消息内容不超过 2000 字符;embed 描述不超过 4096 字符;embed 标题不超过 256 字符;embed 总大小不超过 6000 字符;频道 ID 必须为数字 snowflake 格式。

响应处理:200 表示发送成功并返回消息 ID;401 表示机器人令牌无效;403 表示缺少权限或机器人不在服务器;404 表示频道不存在或机器人不可见;400 表示消息内容无效。

限制与注意事项:不要在消息或日志中暴露机器人令牌;发送前校验所有用户输入;非私密频道不要发送敏感信息;遵守 Discord 速率限制(每频道每 5 秒 5 条消息)。官方接口文档为 https://discord.com/developers/docs/resources/channel#create-message。