Telegram 创建 bot 获取 token 和 chatId 以及发送消息简明教程

2024-07-04 06:38| 来源: 网络整理| 查看: 265

打开 BotFather

url: https:///BotFather 打开与它的聊天界面，不论是 Windows mac 还是 Android iOS 的 telegram 客户端。

创建 bot 以及获取 token

输入 /newbot 后回车

它会回你以下内容

Alright, a new bot. How are we going to call it? Please choose a name for your bot.

这个名字是显示名称（display name）,不是唯一识别码，现在随便设置一下，之后可以通过 /setname 修改

比如设置成 Zhang san's sweety bot

接着会让你设置唯一名称。字符串必须 endsWith bot，比如 abc_bot 或 HelloWorldbot 都是合法的。如果你设置的名字已经被占用需要重新设置。比如你设置成了 test_bot

Good. Now let's choose a username for your bot. It must end in bot. Like this, for example: TetrisBot or tetris_bot.

恭喜！设置成功。会返回给你重要的 API token，务必要保存好它。另外你的 bot 的唯一 url 就已经生成: https:///test_bot

Done! Congratulations on your new bot. You will find it at /test_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.

Use this token to access the HTTP API: 12345678:sdfsfadsfasdfasdfasdfgdfhdfghfgh Keep your token secure and store it safely, it can be used by anyone to control your bot.

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

一些其他必要的命令

/setdescription 帮助你设置 bot 的描述 /setuserpic 设置 bot 的头像。上传的图片 size 需要大于等于 150x150。而且上传图片需要选择压缩，不能上传文件！

此时你的 bot 很快就可以使用了。

获取 chatId

观察这个 url https://api.telegram.org/bot{token}/getUpdates

使用第二步获得的 token 替换上述 url 中的 {token} 然后得到新的 url，复制粘贴到浏览器地址栏，回车请求。不出意外你会得到如下 response

{ "ok": true, "result": [] }

很好。这时你打开你的 bot，随便和它说一句话，比如给它发一句 "Hello World"，然后重新请求一遍上述的 url（替换过 token 的），不出意外你收到的 response 是这样了

{ "ok": true, "result": [ { "update_id": 123456, "message": { "message_id": 56, "from": { "id": 72384234234, "is_bot": false, "first_name": "sdfsdf", "last_name": "sdfsdf", "username": "sdfsdf", "language_code": "en" }, "chat": { "id": 123456789, "first_name": "sdfsdf", "last_name": "sdfsdf", "username": "sdfsdf", "type": "private" }, "date": 1212121212, "text": "/start", "entities": [ { "offset": 0, "length": 6, "type": "bot_command" } ] } }, { "update_id": 123456, "message": { "message_id": 6, "from": { "id": 23232323, "is_bot": false, "first_name": "sdfsdfsdf", "last_name": "sdfsdfsdf", "username": "sdfsdfsdf", "language_code": "en" }, "chat": { "id": 123456, "first_name": "sdfsdfsdf", "last_name": "sdfsfdsdf", "username": "sdfsdfsdf", "type": "private" }, "date": 1234567, "text": "Hello World" } } ] }

如果浏览器没有安装一些 json 美化插件，会得到 json string 原文，那么复制它们到任何一个在线 json 解析格式化网站，比如 https://www.sojson.com/ 选择对应的格式化功能格式化文本。

其中的 result[0].message.chat.id 的值就是 chatId 也就是 123456789

知道了 token 和 chatId 就可以使用 bot 了。

curl 测试 curl -s -X POST https://api.telegram.org/bot{token}/sendMessage -d chat_id={chatId} -d text="Hello World"

这是发送 post 请求。使用实际的 token 和 chatId 替换 shell command 中的 {token} 和 {chatId}

不出意外，你的 bot 会收到 "Hello World"，恭喜，这已经成功了！

Java 测试

引入 hutool-http，maven based project

cn.hutool hutool-http 5.7.10 import cn.hutool.http.HttpRequest; import java.util.HashMap; import java.util.Map; /** * @author hellodk * @date 2021-09-18 23:08 */ public class HttpPostTest { public static void main(String[] args) { String apiUrl = "https://api.telegram.org/bot%s/sendMessage"; String token = "12345:abcsdfsdf"; apiUrl = String.format(apiUrl, token); Map map = new HashMap(); String chatId = "123456"; map.put("chat_id", chatId); map.put("parse_mode", "Markdown"); map.put("disable_web_page_preview", true); map.put("text", "Hello World"); HttpRequest.post(apiUrl) .form(map) .timeout(20000) // 设置请求超时: 20s .execute() .body(); } }

end.

【本文地址】

公司简介

联系我们