You need to enable JavaScript to run this app. 如何创建可在代码内指定头像与用户名的Discord Webhook?
优惠活动
大模型
产品
解决方案
定价
更多

如何创建可在代码内指定头像与用户名的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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.02 16:15:07