在日常的群组管理中，头像不仅是群组的门面，也可能承载着品牌或活动信息。当需要更换群组头像时，作为管理员，你或许会手动操作，但如果你在维护一个机器人，能否让机器人自动完成“删除旧头像”和“设置新照片”这个过程呢？答案是肯定的。Telegram Bot API 提供了 deleteChatPhoto 和 setChatPhoto 两个方法，本文将带你从零开始，掌握用机器人管理群组头像的完整技能。
一、机器人操作群组头像的权限要求
在开始调用 API 之前，你必须在 Telegram 中为机器人配置好权限，否则会收到 403 Forbidden 错误。具体要求如下：
- 机器人必须是目标群组的成员（且未被封禁）。
- 机器人必须被提升为群组管理员，并且授予“更改群组信息”权限（对应 BotFather 中的
can_change_info权限，或群组管理员设置中的“更换群组信息”）。 - 对于普通群组和超级群组（supergroup），两者都适用，但建议将群组升级为超级群组以使用更完整的管理功能。
二、删除群组头像：deleteChatPhoto 方法详解
这是不少开发者容易忽略的一个方法，因为 Telegram 官方文档中它独立存在。调用格式非常简单：
POST https://api.telegram.org/bot<token>/deleteChatPhoto
Content-Type: application/json
请求参数只有 chat_id，即群组的唯一标识（可以是 ID 或 @用户名）。成功调用后，群组头像会被移除，Telegram 将显示默认的头像占位图（通常是一个灰色的圆形图标）。
需要注意的是，如果群组本身没有头像，该方法会返回 400 Bad Request 错误，错误描述为 CHAT_NOT_MODIFIED。因此在代码中应当先判断群组是否有头像，或者捕获异常。
三、设置新头像：setChatPhoto 方法完整指南
与删除头像不同，设置头像需要使用 multipart/form-data 上传图片文件。方法名称为 setChatPhoto，请求方式为 POST，参数如下：
chat_id：群组的唯一标识（字符串）。photo：新头像图片文件，必须通过 multipart 上传。支持 JPEG、PNG 等常见格式，文件大小不超过 5 MB。
Telegram 会自动将图片裁剪为圆形并调整尺寸，因此你无需预处理图片，但建议使用正方形图片以获得最佳显示效果。上传后，群组头像立即生效，所有成员都会看到更新。
四、Python 实战：完整代码示例
下面我们使用 Python 与 requests 库，编写一个完整的脚本，先删除旧头像，再上传新照片。请先安装依赖：
pip install requests
然后，将以下代码保存为 group_avatar.py，将 BOT_TOKEN 和 CHAT_ID 替换为实际值：
import requests
BOT_TOKEN = "你的机器人Token"
CHAT_ID = "@your_group" # 或群组数字ID
API_URL = f"https://api.telegram.org/bot"
# 删除现有头像
def delete_group_photo(chat_id):
url = f"/deleteChatPhoto"
payload = {"chat_id": chat_id}
response = requests.post(url, json=payload)
data = response.json()
if data.get("ok"):
print("旧头像删除成功")
else:
print(f"删除失败: ")
# 如果是 CHAT_NOT_MODIFIED 说明本来就没有头像，可忽略
return data
# 设置新头像
def set_group_photo(chat_id, photo_path):
url = f"/setChatPhoto"
with open(photo_path, "rb") as photo:
files = {"photo": photo}
payload = {"chat_id": chat_id}
response = requests.post(url, data=payload, files=files)
data = response.json()
if data.get("ok"):
print("新头像设置成功")
else:
print(f"设置失败: ")
return data
if __name__ == "__main__":
# 先删除旧头像（若不存在则跳过）
delete_group_photo(CHAT_ID)
# 设置新头像
set_group_photo(CHAT_ID, "new_avatar.jpg")
执行脚本：
python group_avatar.py
如果一切顺利，控制台会输出成功信息，你可以在 Telegram 中查看群组头像的变化。
五、常见问题与避坑指南
1. 机器人没有权限怎么办？
请检查群组管理员设置，确保机器人已经获得“更改群组信息”权限。如果机器人是通过 BotFather 创建的，也可以使用 setMyCommands 等方法来预设命令，但权限仍需在群组中手动调整。
2. 调用 setChatPhoto 时返回 400 Bad Request
常见原因：图片格式不支持、图片太大（超过 5MB）、或者 chat_id 不正确。另外，Telegram 要求图片必须为正尺寸（非零宽高），请避免使用空文件。
3. deleteChatPhoto 删除后能否恢复？
一旦删除，Telegram 不会保留旧头像，除非你提前备份。建议在删除前下载旧头像以备万一。
4. 普通群组和超级群组有区别吗？
在头像管理方面无区别，但超级群组支持更多管理功能，并且 chat_id 可能与普通群组不同（通常为负数）。如果群组处于“普通模式”，建议先升级为超级群组。
总结
通过本文的讲解，你已经掌握了如何利用 Telegram 机器人删除群组头像并设置新照片。关键在于正确配置机器人权限，熟练调用 deleteChatPhoto 与 setChatPhoto 方法，并用 Python 代码实现自动化。这不仅能帮助你高效管理群组，也为开发更智能的群管机器人打下了基础。如果你在实践过程中遇到问题，欢迎参考官方 API 文档或留言交流。