Telegram API是否支持在同一条消息中发送附带文本的照片相册？

这个在同一条消息内发送带配套文本的照片相册的需求，完全可以通过Telegram Bot API实现。你之前了解的两类场景是常见的基础用法，不代表接口能力的上限——早期的接口版本确实不支持相册附带独立文本，后续版本迭代补上了这个能力，很多开发误区其实来自参数配置的错误。

正确实现方式 #

• 调用sendMediaGroup接口构造相册消息时，不要在请求外层寻找独立的caption入参：接口本身没有这个外层字段，需要把配套的文本内容写入媒体组列表中第一个媒体项的caption参数，系统会自动将这段文本作为整个相册的统一说明，渲染在所有照片的下方。
• 挂载的配套文本能力和单张照片的caption完全一致：
  • 字符长度上限为1024，超出限制会被接口截断
  • 支持通过对应媒体项的parse_mode字段，配置Markdown或HTML语法的格式解析
  • 支持传入自定义的caption_entities参数，实现加粗、超链接、用户提及等自定义文字样式效果

常见配置误区 #

• 在sendMediaGroup的最外层传caption参数会被接口直接忽略，很多人因此误以为接口不支持相册带文本
• 不要给媒体组里除第一个之外的其他照片单独传caption字段，否则会触发接口校验错误，导致整个消息发送失败
• 按照规则配置后，消息始终保持相册的整体形态，配套文本和所有照片属于同一个消息单元，不会被拆成多条独立消息发送

内容的提问来源于stack exchange，提问作者Eugene