使用Telegram API通过URL发送文件时如何自定义文件名称

解决方法 #

Telegram Bot API 的 SendDocument 类内置了 setFileName 方法，可直接自定义文件在聊天窗口展示的名称，无需修改原有远程文件URL，在原有代码基础上追加调用该方法即可。

修改后代码示例：

new SendDocument()
                .setChatId(message.getChatId())
                .setDocument("https://www.okbhmao.ru/download.php?file=12021")
                .setFileName("contract.pdf");

注意事项 #

• setFileName 的优先级高于远程文件的原生文件名，会完全覆盖Telegram从URL解析到的默认文件名称
• 需完整指定文件后缀名，若仅填写contract未加.pdf后缀，发送的文件不会自动识别为PDF格式，客户端可能无法直接打开
• 该方法对本地文件上传、字节流上传、远程URL上传三种传文件场景均生效

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