【PHP Telegram Bot】Day03 - 向 @BotFather 申请一只机器人吧！

讲了两天的赣话，今天终於要来实作啦！

The BotFather

The Botfather 这个名字是致敬 1972 年的美国电影《教父》

它是机器人，也是机器人的管理者
几乎所有机器人的设定、建立都要透过他
用机器人设定机器人听起来就很有趣，对吧？

@BotFather 的功能

私讯 @BotFather，按「开始」後就会显示出一大堆指令，真是令人眼花撩乱

官方网页版说明：https://core.telegram.org/bots#botfather-commands

简单介绍几个比较常用的功能：

建立你的机器人吧

1. 按下/newbot指令

   

2. 帮机器人取名字

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

   这边它会要你帮你的机器人取一个名字，这个以後能修改，所以随便取没差
   

3. 设定 username

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

   ⚠️ 注意：设定後就不能修改了，请谨慎思考之後设定，避免反悔时需要请使用者迁移

   需要帮你的机器人设定一个 username，必须符合以下规则：

   • 不需要打 @
   • 以 a~z 开头
   • 以 bot 结尾
   • 只能使用 a~z、0~9 和底线
   • 最小长度为 5 个字元

   显示时会区分大小写，使用时不区分大小写（例如设定成 @TetrisBot，用 @tETrISbOt 一样会指到同一个机器人）

   ---

   常见问题：

   • 不能以数字开头

     

     Sorry, this username is invalid.
     

   • 不能用 bot 以外的字结尾

     

     Sorry, the username must end in 'bot'. E.g. 'Tetris_bot' or 'Tetrisbot'
     

   • username 已经被别人先用走了

     

     Sorry, this username is already taken. Please try something different.
     

   ---

   出现 Done 表示你设定成功了
   

使用你的机器人吧

现在你已经可以使用机器人了

按下说明里的连结(t.me/ironman2021_by_miku3920_bot 点你自己的)，并且点击「开始」

然後你就会发现什麽事情都没发生，因为我们还没写机器人的程序嘛

不过就算不写程序也可以让它说话，利用昨天文章说的 HTTP GET 方法，与 sendMessage 这个 API

https://api.telegram.org/bot{Token}/{Method}?{Parameter1}={Value1}&{Parameter2}={Value2}

• Token：1985044907:AAEdySrbzTc8tVdBjfymlfyaBUJGeu7r-v4（你的 bot token）
• Method：sendMessage
• Parameter1：chat_id
• Value1：127355800（你的 uid，可以透过 @userinfobot 取得）
• Parameter2：text
• Value2：Hello,+World!+你好，世界！（空白要用「+」替换）

组合完会像这个样子，直接贴到浏览器的网址列就能使用罗：

https://api.telegram.org/bot1985044907:AAEdySrbzTc8tVdBjfymlfyaBUJGeu7r-v4/sendMessage?chat_id=127355800&text=Hello,+World!+你好，世界！

常见问题：

• Token 打错

  {"ok":false,"error_code":401,"description":"Unauthorized"}
  

• Method 打错

  {"ok":false,"error_code":404,"description":"Not Found"}
  

• chat_id 的值不能为空

  {"ok":false,"error_code":400,"description":"Bad Request: chat_id is empty"}
  

• chat_id 的值打错

  {"ok":false,"error_code":400,"description":"Bad Request: chat not found"}
  

• 没私讯过机器人

  {"ok":false,"error_code":403,"description":"Forbidden: bot can't initiate conversation with a user"}
  

• text 的值不能为空

  {"ok":false,"error_code":400,"description":"Bad Request: message text is empty"}
  

成功的话会返回机器人发送的讯息（json 格式）到网页上：

{"ok":true,"result":{"message_id":5,"from":{"id":1985044907,"is_bot":true,"first_name":"2021 iThome\u9435\u4eba\u8cfd","username":"ironman2021_by_miku3920_bot"},"chat":{"id":127355800,"first_name":"\u521d\u97f3","last_name":"\u30df\u30af","username":"miku3920","type":"private"},"date":1631440402,"text":"Hello, World! \u4f60\u597d\uff0c\u4e16\u754c\uff01"}}

结尾

不知不觉就写了这麽多，还有好多想讲的没讲到，今天就先讲到这里，明天继续设定机器人！