创建机器人
在telegram中我们可以通过和一个名为
BotFather的机器人交互来申请我们自己的机器人，具体步骤如下- 添加BotFather为好友
点击这里添加BotFather
- 打开和BotFather的对话框发送
/newbot
这一步过后BotFather会提示你输入你要创建的机器人的名字，这个名字可以随意，是我们称呼它的名字
- 设置自定义机器人的名字（这个名字不同于上一步的名字，这个名字是唯一的）结尾必须是
_bot或者Bot，不能包含中文, 标点符号
- 如果上一步执行成功那么BotFather会返回该机器人的token，大概长这样
123456789:ABCDEfghiJK4314daDSadSa7
记住这个token,到这里机器人就创建好了
获取群组chat\_id
通常来说我们都需要让机器人在一个群组里工作，所以首先我们需要将机器人添加到我们指定的群组，在群组里发送随意消息并@这个机器人，比如
hello @your_bot
然后浏览器打开这个链接，注意替换为你的token
<https://api.telegram.org/bot><token>/getUpdates
你看到的是一个json，格式如下
{ "ok": true, "result": [ { "update_id": 414941268, "message": { ... }, "chat": { "id": -465512321, ... }, ... } ] }
从中找到chat.id这就是当前群组的id,以后发消息都是发到这个id.
telegram对象
telegram机器人的几乎所有操作都是一个一个对象的操作。
telegram定义了许多场景下的对象，详见，这里举例一些常见的
Message
该对象代表一个消息
Field
Type
Description
True
可选的。 服务消息：超组已创建。 在通过更新发送的消息中无法接收到该字段，因为bot在创建时不能成为超组的成员。 仅当有人回复直接创建的超组中的第一条消息时，才可以在reply\_to\_message中找到该消息。
True
可选的。 服务信息：频道已创建。 在通过更新发送的消息中无法接收到该字段，因为bot在创建时不能成为频道的成员。 如果有人回复频道中的第一条消息，则只能在reply\_to\_message中找到它。
Integer
可选的。 该组已迁移到具有指定标识符的超组。 此数字可能大于32位，并且某些编程语言在解释它时可能会有困难/无声的缺陷。 但是它小于52位，因此带符号的64位整数或双精度浮点类型对于存储此标识符是安全的。
Integer
可选的。 超级组已从具有指定标识的组中迁移。 此数字可能大于32位，并且某些编程语言在解释它时可能会有困难/无声的缺陷。 但是它小于52位，因此带符号的64位整数或双精度浮点类型对于存储此标识符是安全的。
ReplyKeyboardMarkup
该对象表示带有回复选项的自定义键盘
Field
Type
Description
Boolean
可选的。请求客户垂直调整键盘大小以达到最佳适合度（例如，如果只有两行按钮，则使键盘变小）。默认为false，在这种情况下，自定义键盘的高度始终与应用程序的标准键盘相同。
Boolean
可选的。要求客户在使用键盘后立即隐藏它。键盘仍然可用，但是客户端将在聊天中自动显示常用的字母键盘-用户可以在输入字段中按特殊按钮以再次查看自定义键盘。默认为false。
Boolean
可选的。如果只想向特定用户显示键盘，请使用此参数。目标：1）在Message对象的文本中@提及的用户； 2）如果机器人的消息是回复（具有reply\_to\_message\_id），则为原始消息的发送者。 示例：用户请求更改机器人的语言，机器人用键盘答复选择新语言的请求。群组中的其他用户看不到键盘。
ReplyKeyboardRemove
收到带有此对象的消息后，Telegram客户端将删除当前的自定义键盘并显示默认的字母键盘。默认情况下，将显示自定义键盘，直到机器人发送新键盘为止。一次性键盘的例外情况是用户按下按钮后立即隐藏的一次性键盘
Field
Type
Description
True
请求客户端删除自定义键盘（用户将无法召唤此键盘；如果要隐藏键盘，但保持其可访问性，请在ReplyKeyboardMarkup中使用one\_time\_keyboard）
Boolean
可选的。如果仅要为特定用户卸下键盘，请使用此参数。目标：1）在Message对象的文本中@提及的用户； 2）如果漫游器的消息是回复（具有reply\_to\_message\_id），则为原始消息的发送者。 示例：用户在投票中投票，机器人返回确认消息以回应投票，并删除该用户的键盘，同时仍向尚未投票的用户显示带有投票选项的键盘。
InlineKeyboardButton
此对象表示嵌入式键盘的一个按钮。您必须完全使用可选字段之一。
Field
Type
Description
text
String
在按钮上标记文本
url
String
可选的。按下按钮时将打开HTTP或tg:// URL
callback\_data
String
可选的。按下按钮时要在回调查询中发送到bot的数据，1-64个字节
switch\_inline\_query
String
可选的。如果已设置，则按下按钮将提示用户选择其聊天之一，打开该聊天并将bot的用户名和指定的内联查询插入输入字段。可以为空，在这种情况下，只会插入机器人的用户名。
注意：这为用户提供了一种简便的方法，使他们在当前与它进行私聊时以内联模式开始使用您的机器人。与switch\_pm…操作结合使用时特别有用–在这种情况下，用户将自动返回到其切换到的聊天中，而跳过聊天选择屏幕。
switch\_inline\_query\_current\_chat
String
可选的。如果已设置，则按下按钮会将bot的用户名和指定的嵌入式查询插入当前聊天的输入字段中。可以为空，在这种情况下，只会插入机器人的用户名。
pay
Boolean
可选的。指定True，发送付款按钮。 注意：此类型的按钮必须始终是第一行中的第一个按钮。
telegram方法
telegram方法就是拼接在api后面的那串字符串，不区分大小写。详见，这里只列举一些常用的，下面我所指的返回是指返回json中的result部分，其他章节提到的所有方法均可以在这一章节查阅
setWebhook
- 描述
使用此方法可以指定URL并通过传出的Webhook接收传入的更新。只要机器人有更新，telegram就会向指定的URL发送HTTPS POST请求，请求数据为json序列化后的
update对象- 参数
Parameter
Type
Required
Description
Integer
Optional
与Webhook进行更新交付的同时HTTPS连接的最大允许数量为1-100。默认值为40。使用较低的值可以限制bot服务器的负载，使用较高的值可以增加bot的吞吐量。
Array of String
Optional
您希望机器人接收的更新类型的JSON序列化列表。 例如，指定\[“ message”，“ edited\_channel\_post”，“ callback\_query”\]仅接收这些类型的更新。 请参阅更新以获取可用更新类型的完整列表。 指定一个空列表以接收所有更新，无论类型如何（默认）。 如果未指定，将使用以前的设置。 请注意，此参数不会影响调用setWebhook之前创建的更新，因此可能会在短时间内收到不需要的更新。
- 返回
成功返回
True格式化选项
格式化选项就是让我们的机器人以某种格式发送消息（比如markdown，或者html）
Bot API支持消息的基本格式。您可以在机器人的消息中使用粗体，斜体，下划线和删除线文本，以及内联链接和预格式化的代码。电报客户端将相应地呈现它们。您可以使用markdown样式或HTML样式格式。
请注意，Telegram客户端将在打开内联链接（“打开此链接？”以及完整的URL）之前向用户显示警报。
如果满足以下限制，则可以嵌套消息实体：
- 如果两个实体具有公共字符，则其中一个完全包含在另一个内部。
- 粗体，斜体，下划线和删除线实体可以包含并且要包含在任何其他实体中，但pre和code除外。
- 所有其他实体不能互相包含。
链接
tg://user?id=<user_id>可以用于通过用户ID提及用户，而无需使用用户名。请注意：- 这些链接仅在内联链接中使用时才有效。例如，当用于嵌入式键盘按钮或消息文本中时，它们将不起作用。
- 仅当用户过去联系过该机器人，通过内联按钮向该机器人发送了回调查询或成为提及该用户的组的成员时，才能保证这些提及有效。
MarkdownV2 style
要使用此模式，请在parse\_mode字段中传递MarkdownV2。在您的消息中使用以下语法：
*bold \\*text* _italic \\*text_ __underline__ ~strikethrough~ *bold _italic bold ~italic bold strikethrough~ __underline italic bold___ bold* [inline URL](<http://www.example.com/>) [inline mention of a user](tg://user?id=123456789) `inline fixed-width code`
pre-formatted fixed-width code block
```python pre-formatted fixed-width code block written in the Python programming language
请注意： * 任何代码在1到126之间（含1和126）的字符都可以在任何带有''字符的位置转义，在这种情况下，它将被视为普通字符，而不是标记的一部分。 * 在pre和code实体内部，所有'\\`'和''字符必须以前面的''字符转义。 * 内联链接定义的内部(...)部分，所有')'和''必须以前面的''字符转义 * 在其他所有地方这些字符 '\\_', '\\*', '\\[', '\\]', '(', ')', '~', '\\`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!' 必须用前置''转义 * 如果`斜体`和`下划线`之间存在歧义，`__`始终从左到右被视为`下划线`实体的开始或结尾，所以使用`___italic underline_\\r__`代替`___italic underline___` ### [](#html-style)HTML style 要使用此模式，请在parse\\_mode字段中传递HTML。当前支持以下标签： ```html <b>bold</b>, <strong>bold</strong> <i>italic</i>, <em>italic</em> <u>underline</u>, <ins>underline</ins> <s>strikethrough</s>, <strike>strikethrough</strike>, <del>strikethrough</del> <b>bold <i>italic bold <s>italic bold strikethrough</s> <u>underline italic bold</u></i> bold</b> <a href="<http://www.example.com/>">inline URL</a> <a href="tg://user?id=123456789">inline mention of a user</a> <code>inline fixed-width code</code> <pre>pre-formatted fixed-width code block</pre> <pre><code class="language-python">pre-formatted fixed-width code block written in the Python programming language</code></pre>
请注意：
- 当前仅支持上述标签。
- 所有不属于标记或HTML实体的
<，>和&符号必须替换为相应的HTML实体(<用<，>用>，&用&)。
- 支持所有数字HTML实体。
- 该API当前仅支持以下命名的HTML实体：
<,>,&and"。
- 使用嵌套的pre和code标签，为pre实体定义编程语言。
- 不能为独立code标签指定编程语言。
Markdown style
这是旧版模式，保留下来是为了向后兼容。要使用此模式，请在parse\_mode字段中传递Markdown。在您的消息中使用以下语法：
*bold text* _italic text_ [inline URL](<http://www.example.com/>) [inline mention of a user](tg://user?id=123456789) `inline fixed-width code`
pre-formatted fixed-width code block
```python pre-formatted fixed-width code block written in the Python programming language
请注意： * 实体不得嵌套，而应使用解析模式`MarkdownV2`。 * 无法指定下划线和删除线实体，请改用解析模式`MarkdownV2`。 * 要在实体外部转义字符`_`，`*`，`，`\\[`，请在字符之前加上`\\`。 * 不允许在实体内部转义，因此必须先关闭实体再重新打开：对于斜体使用`_snake_\\__case_`，对于粗体`2*2=4`使用 `snake_case` 和 `*2*\\**2=4*`。 [](#telegram更新)telegram更新 ------------------------- telegram中更新指的是机器人是否有收到新的消息，具体有哪些消息可以查看`telegram对象`部分中的`Update`，获取更新的方式有两种1. 轮询，2.webhook ### [](#轮询)轮询 这是一种主动询问的方式，这种方式比较简单但是效率欠佳，具体操作是，开发者每个一段时间请求一次`getUpdates`方法，从获取结果中判断update有无更新，有关`update`对象的描述可看`telegram对象`章节 ### [](#webhook)webhook webhook可以理解为客户端给服务端的api,只要服务端一有更新就会主动将内容发送到客户端设置的一个api中，然后客户端收到消息后可做相应处理。 **给我们的机器人设置webhook** 通过`setWebhook`方法设置（前面有介绍），需要注意的是，telegram只支持`https`协议，所以我们的api服务器必须要有TLS证书，必须注意一但我们设置了webhook那么通过`getUpdates`方法将不起作用！ [](#telegram中的命令)telegram中的命令 ----------------------------- 通过命令来和机器人交互是电报机器人的一大特色，在telegram中命令由实体`BotCommand`表示（telegram对象那节已经介绍过）。 其实任何以`/`开头的连续英文消息都被视作命令(可以理解为这是一种具有格式的普通消息)，私聊或者在群里@机器人时发送`/`开头的信息可以查看实体类型为`bot_command` 。要想让机器人收到某条命令后执行响应动作只需要判断发送的消息是否匹配我们约定的内容即刻，（从某种意义上讲无论发送的消息是否是命令格式我们都可以将其视为命令只要我们愿意），开发具有命令响应的过程总结如下： 1. 起一个死循环监听`update`的`message`消息，可以是轮询或者webhook方式 2. 拿到`update.id`检查其是否更新，如有更新则取`message.Text`匹配已经定义好的`路由`（这是我定义的叫法，也就是我们约定的命令，事实上他的确和路由很像） 3. 如果匹配成功，执行我们定义的方法，如果匹配失败则当做普通信息无视，或者返回对应信息 从上面过程可以看出命令是否是`/`开头其实已经不那么重要了，那么为什么官方要定义`BotCommand`类呢，理由（优点）如下 1. 用以和普通消息区分 2. 在聊天消息中命令会高亮显示 3. 已经注册的命令在对话框中只需要输入`/`就会有提示列表 ### [](#给机器人注册指令)给机器人注册指令 **手动注册** 1. 和`BotFather`对话，输入`/mybot` 2. 选择要注册指令的机器人 3. 选择`Edit Bot`选项 4. 选择`Edit Commands` 5. 输入你想定义的命令，格式为 ``` command1 - 描述 command2 - Description ``` 注意：注册时命令开头没有斜杠，使用命令时需要带上斜杠，中间用 `-` 分割；每一次的命令编辑都会覆盖之前的命令而不是追加，所以必须一次发送全部命令（在对话框中按`shift + enter`换行） **通过`setMyCommands`方法注册** * 详见（telegram方法 setMyCommands） ### [](#查看已注册的指令)查看已注册的指令 * 详见（telegram方法 getMyCommands） ### [](#基本指令)基本指令 telegram建议我们的机器人都带上三条基本指令分别是 * `/start` * `/help` * `/settings` 当设置了上面三个命令，用户首次打开与你的机器人的对话时，将看到`Start`按钮。机器人的个人资料页面上的菜单中将提供`Help`和`Settings`链接。 [](#键盘)键盘 --------- telegram中键盘也是机器人的一大特色，开发者可以自定义自己的键盘，一个键盘相当于机器人的菜单可以理解为一个答复界面，可以更加方便的和机器人交互。 telegram中的键盘有四种`ReplyKeyboardMarkup`，`InlineKeyboardMarkup`，`ReplyKeyboardRemove`和`ForceReply`，这四个对象可参考前面的介绍 ### [](#创建键盘)创建键盘 只需要在`sendMessage`时指定`reply_markup`即可，详见`sendMessage`方法
