创建机器人-机器人token-机器人如何接收消息

创建机器人

在Potato客户端中搜索@BotFather，然后完成下面的步骤:

打开BotFather聊天框，输入 /newbot 命令。
输入机器人的昵称。
输入机器人唯一的用户名。
收到创建成功消息及token时表示创建完成

机器人token

每个机器人在创建时都会获得一个唯一的token来标志身份。 例如 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11， 机器人所有的接口调用都必须带上token， 请妥善保管。 参考创建机器人获取token。

所有机器人接口调用必须通过HTTPS，格式如下所示: https://api.rct2008.com:8443/<bot_token>/METHOD_NAME 例如机器人获取自身信息: https://api.rct2008.com:8443/123456909:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getMe

我们支持GET和POST HTTP方法。API请求中传递参数的三种方式:

URL query string
Application/json (最常用的json格式传递请求参数)
Multipart/form-data (表单仅在上传文件时使用)

响应返回一个JSON对象，该对象始终有一个布尔字段“ok”和可能携带一个关于结果描述String字段“result”。 如果“ok”等于true，则请求成功，返回的数据在“result”字段中。 如果请求失败，则“ok”等于false，返回一个整数“error_code”字段，表示请求的错误码和返回一个“result”字段，包含错误描述。

API中的所有接口名都区分大小写
所有请求必须使用UTF-8编码

机器人如何接收消息

• 有新消息发送到bot时， 机器人有两种方式获取消息:
  主动模式: 机器人需要不停的的主动去调用getUpdates接口来获取消息，成功请求后，将收到一个包含消息更新列表的json对象。
  被动模式: 机器人需要调用一次setWebhook接口，设置好回调地址。当有新消息时，Potato服务器会向机器人设置的地址POST消息，机器人同样收到一个包含消息更新列表的json对象
  发给机器人的消息会在服务器上缓存一段时间，当机器人处理了消息立即删除，超过1个小时未处理也将清除。