如何创建可在代码内指定头像与用户名的Discord Webhook?
Discord Webhook 自定义用户名/头像 完整实现流程
前置准备:获取专属Webhook地址
- 进入目标服务器的对应频道,打开频道设置中的「整合」板块,选择「Webhook」入口创建新的Webhook,复制得到形如
https://discord.com/api/webhooks/[id]/[token]的专属请求地址 - 该请求地址等同于访问密钥,不要对外泄露,避免被他人滥用发送消息
修正你已有的JSON请求片段
你写的这段JSON本身就是符合规范的请求体核心结构,不需要在前后额外包裹任何嵌套字段,仅存在一处语法问题:最后一个content字段末尾的尾随逗号,会被部分严格的JSON解析器判定为格式错误,修正后的可用格式为:
{ "username": "Webhook", "avatar_url": "https://i.imgur.com/4M34hi2.png", "content": "Text message. Up to 2000 characters." }
字段生效逻辑说明:请求体中携带的username和avatar_url优先级高于Webhook创建时在后台预设的固定名称和头像,会临时覆盖展示效果,不会修改Webhook本身的永久配置,完全匹配你在代码内部自定义参数的需求
发送请求完成消息推送
将修正后的JSON作为请求体,向Webhook地址发送带Content-Type: application/json请求头的POST请求即可,以下是两种常用实现方式:
方式1:curl快速测试
直接在命令行执行,适合快速验证配置是否生效:
curl -H "Content-Type: application/json" -X POST -d @修正后的json文件路径 "你的Webhook完整地址"
方式2:Python代码集成
适合嵌入到自身业务代码中,所有自定义参数都可以直接在代码内修改,不需要依赖外部JSON文件:
import requests # 直接在代码内自定义所有参数 WEBHOOK_URL = "你的Webhook完整地址" custom_config = { "username": "Webhook", "avatar_url": "https://i.imgur.com/4M34hi2.png", "content": "Text message. Up to 2000 characters." } # 发送请求 resp = requests.post(WEBHOOK_URL, json=custom_config) # 发送成功将返回状态码204 print(resp.status_code)
常见注意事项
- 头像地址必须是可公网直接访问的图片直链,不能是需要登录跳转的页面链接,否则会加载失败、展示默认头像
- 单次请求的消息文本长度不能超过2000字符,总请求体大小不能超过25MB
- 如果需要发送嵌入卡片、富文本格式的消息,只需要在现有请求JSON中追加
embeds数组字段即可,不需要改动已有的用户名、头像配置
内容的提问来源于stack exchange,提问作者Luserrr
相关产品推荐
相关产品推荐

