iT邦幫忙

2021 iThome 鐵人賽

DAY 4
0
Software Development

用 PHP 打造專屬於自己的 Telegram 聊天機器人吧!系列 第 4

【PHP Telegram Bot】Day04 - Telegram 機器人的設定

今天要來設定機器人~

按下 /mybots 指令後就會出現機器人列表
https://ithelp.ithome.com.tw/upload/images/20210913/20132916a34F66MEPg.png

Choose a bot from the list below:

選擇一個你要查看或設定的機器人
我之前就有建立過機器人,所以會顯示兩個
https://ithelp.ithome.com.tw/upload/images/20210913/201329167odk17OKiZ.png

Here it is: 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot.
What do you want to do with the bot?

點下去後就會出現六個選項,我一個個來講解:

API Token - 查看 token

https://ithelp.ithome.com.tw/upload/images/20210913/20132916NoJ3Z51pA5.png

Here is the token for bot 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot:

1985044907:AAH1kZaEZFHoA6YqB6IFtvbkyOjvcpPOfbQ

忘記 token 時可以來這裡查看,或是你想要重置 token

  • Revoke current token - 重置 token
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916EWCHDPQS75.png

    Token for the bot 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot has been revoked. New token is:
    
    1985044907:AAG3E05XowN2sqy286aplwr6oBc17q0CByg
    

    按下重置按鈕後,它就會給你一個新的 token,舊的會立即失效


Edit Bot - 修改機器人

https://ithelp.ithome.com.tw/upload/images/20210913/201329165B8YFXrvNQ.png

Edit @ironman2021_by_miku3920_bot info.

Name: 2021 iThome鐵人賽
Description: ?
About: ?
Botpic: ? no botpic
Commands: no commands yet
  • Edit Name - 修改名字

    按下按鈕後會出現以下訊息
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916xf92XTQP9m.png

    OK. Send me the new name for your bot.
    

    直接傳送新的名稱給它就行了
    https://ithelp.ithome.com.tw/upload/images/20210913/201329160RGcvdXnUs.png

    Success! Name updated. /help
    

    看到這個就是修改成功了


  • Edit Description - 修改說明

    這個會顯示在聊天室的最上方,用來說明機器人有能些功能,或是如何使用
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916RQD6maX2nz.png

    OK. Send me the new description for the bot. People will see this description when they open a chat with your bot, in a block titled 'What can this bot do?'.
    

    傳送一段訊息給它,可以是多行的文字
    https://ithelp.ithome.com.tw/upload/images/20210913/201329161aJeqmhrYC.png

    Success! Description updated. /help
    

    看到這個就是修改成功了
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916RwWlZwalJO.png
    原本在聊天室上方啥都沒有,現在多了一個訊息框


  • Edit About - 修改簡介

    這個會顯示在機器人的個人資訊頁面上
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916cmtiFhxWWS.png

    OK. Send me the new 'About' text. People will see this text on the bot's profile page and it will be sent together with a link to your bot when they share it with someone.
    

    傳送一段訊息給它,可以是多行的文字
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916xbuuFg828G.png

    Success! About section updated. /help
    

    看到這個就是修改成功了
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916zkGAHlcLXh.png
    原本是只有顯示 username,現在多了簡介


  • Edit Botpic - 修改大頭貼
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916qCh3V468Hu.png

    OK. Send me the new profile photo for the bot.
    

    建議先裁切成正方形(1:1)
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916VQ2bwEulVw.png

    Please send me the picture as a 'Photo', not as a 'File'.
    

    這邊要傳送照片,不能傳檔案
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916EaQ3LoV7Mu.png

    Success! Profile photo updated. /help
    

    成功的話,機器人的大頭貼就會更新成剛剛上傳的圖片
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916uoyMFnP48K.png


  • Edit Commands - 修改指令選單
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916WpvBFGp62Y.png

    OK. Send me a list of commands for your bot. Please use this format:
    
    command1 - Description
    command2 - Another description
    
    Send /empty to keep the list empty.
    

    要按照它給的格式輸入,不需要打 /
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916IquQRpcBnl.png

    Success! Command list updated. /help
    

    成功的話,選單中就會出現剛剛設定的指令
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916KUjh6J3HW7.png
    如果機器人是在群組使用,建議改成空的,避免誤觸
    群組裡較常使用 ! 開頭的指令,這樣才不會變成藍藍的容易按到
    在剛剛那邊,按 /empty 就行了
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916T7kisuYvXd.png


修改完會變成這樣:
https://ithelp.ithome.com.tw/upload/images/20210913/20132916HCyaUvqUSp.png

Edit @ironman2021_by_miku3920_bot info.

Name: 2021 iThome鐵人賽
Description: 一些說明文字,功能如下:

1. AAA
2. BBB
3. CCC
About: 鐵人賽展示用機器人 by @miku3920
鐵人賽展示用機器人 by @miku3920
鐵人賽展示用機器人 by @miku3920
Botpic: ? has a botpic
Commands: no commands yet

Bot Settings - 設定機器人

https://ithelp.ithome.com.tw/upload/images/20210913/20132916c6WBvcVVBT.png

Settings for @ironman2021_by_miku3920_bot.
  • Inline Mode - 內聯模式(內嵌模式)

    可以讓機器人直接在訊息輸入框使用,不需要將機器人加入群組
    這個功能夠講一整天了,目前還用不到,我們以後專門找一天來講
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916Fb4zg1In8p.png


  • Allow Group? - 是否能被加入群組?
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916MHj9cOwCb6.png

    Groups are currently enabled for bot 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot
    
    Disabling groups will forbid users to add 2021 iThome鐵人賽 to groups.
    

    enabled(預設) - 表示機器人被別人拉進群組
    如果你不想讓別人拉你的機器人,可以按 Turn groups off


    https://ithelp.ithome.com.tw/upload/images/20210913/20132916gkdA9RTOz1.png

    Groups are currently disabled for bot 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot.
    
    Enabling groups will allow users to add 2021 iThome鐵人賽 to groups.
    

    disabled - 表示機器人不能被別人拉進群組
    如果你想讓別人的群組也能使用你的機器人,就按 Turn groups on


  • Group Privacy - 是否能讀取所有聊天室訊息

    官方說明:https://core.telegram.org/bots#privacy-mode
    https://ithelp.ithome.com.tw/upload/images/20210913/201329161u3BZDHDdA.png

    Privacy mode is enabled for 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot.
    

    enabled(預設) - 表示機器人是成員時不能讀取群組裡的所有訊息
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916pzkkVqNv1e.png
    機器人只看的到它的指令和回覆它的訊息
    https://ithelp.ithome.com.tw/upload/images/20210913/201329164v5RZzZ8nZ.png
    但是如果升級成管理員就沒這限制


    https://ithelp.ithome.com.tw/upload/images/20210913/20132916CnXaxxuyQO.png

    Privacy mode is disabled for 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot.
    

    disabled - 表示機器人就算不是管理員也讀取群組裡的所有訊息
    https://ithelp.ithome.com.tw/upload/images/20210913/2013291666UHDAeSg2.png
    機器人是成員時就能讀取所有訊息


  • Payments - 付款相關設定

    台灣不能用,有生之年系列,跳過


  • Domain - 網站登入用

    與機器人較無關,暫時不提


Payments - 付款相關設定

https://ithelp.ithome.com.tw/upload/images/20210913/20132916GOvlEAqxP0.png
歐付寶、綠界、台灣 pay、街口、悠遊付,不考慮進駐一下嗎


Transfer Ownership - 轉移機器人

⚠️ 注意:非必要請勿使用!
https://ithelp.ithome.com.tw/upload/images/20210913/20132916Sfhdggu39h.png

  • Choose recipient - 選擇使用者
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916InbUAr8MtD.png

    Please share the new owner's contact or their username.
    

    按下按鈕後,它會請你把對方以聯絡人的方式分享給它,或是輸入對方的 username


    常見問題:

    • 要輸入 @username,不能只輸入 username
      https://ithelp.ithome.com.tw/upload/images/20210913/20132916M12gG75Iz2.png

      Incorrect format. Please make sure to send either a contact or username.
      
    • 不能轉移給頻道、機器人、或是自己
      https://ithelp.ithome.com.tw/upload/images/20210913/20132916leUV2F3WrT.png

      Bot ownership can't be transferred to channel, another bot or yourself.
      
    • 對方要私訊過機器人,而且不能封鎖機器人
      https://ithelp.ithome.com.tw/upload/images/20210913/20132916mtKhjsExi4.png

      Oops! Please make sure the new owner has sent at least one message to the bot and didn't block it.
      

    輸入正確的話,就會出現以下訊息:
    https://ithelp.ithome.com.tw/upload/images/20210913/20132916bmr5Uz5Lfl.png

    You are about to transfer ownership of the bot @ironman2021_by_miku3920_bot to 初音 ミク.
    
    After this you won't be able to control the bot anymore. The new owner will get access to the bot messages and other data – and can even delete the bot completely.
    
    Please make sure you don't violate your users' privacy (consider GDPR and other laws). If you are sure please press the button below.
    

    看到這則訊息代表離成功轉移不遠了

    • Yes, I am sure, proceed. - 確認轉移
      https://ithelp.ithome.com.tw/upload/images/20210913/20132916GsIP1cHr21.png
      如果你有設定兩步驟驗證的話,這邊會跳出來要你輸入


      常見問題:

      • 對方擁有的機器人數量已達上限
        https://ithelp.ithome.com.tw/upload/images/20210913/20132916V3NbMAaeTD.png

        Oops! has reached the maximum allowed number of bots. Please ask them to delete (or pass to another account) one of their unused bots first.
        

        如果對方已經有 20 隻機器人(達到上限),就會出現這個對話框,他請你先叫對方轉移或刪除一些沒在用的機器人,這樣你才可以轉移給對方。


      https://ithelp.ithome.com.tw/upload/images/20210913/20132916ihSKToQY2e.png

      It worked! We hope @ironman2021_by_miku3920_bot will enjoy its new home.
      

      如果轉移成功就會出現這則訊息

      https://ithelp.ithome.com.tw/upload/images/20210913/20132916rOcBGIIXxL.png

      Ownership of the bot @ironman2021_by_miku3920_bot has been transferred to you by 初音 ミク. You can now control the bot using /mybots.
      
      If you did not request this, you can delete the bot.
      

      對方會收到一則這樣的訊息


Delete Bot - 刪除機器人

⚠️ 注意:非必要請勿使用!
https://ithelp.ithome.com.tw/upload/images/20210913/20132916P7QKGHg8Ea.png

You are about to delete your bot 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot. Is that correct?

這邊的按鈕順序是隨機的,避免你頭腦不清楚把機器人刪了
https://ithelp.ithome.com.tw/upload/images/20210913/20132916PrquRBqk6d.png

Are you TOTALLY sure you want to delete 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot ?

要連續按兩次 Yes 機器人才會被刪掉
https://ithelp.ithome.com.tw/upload/images/20210913/20132916UbKBOVHpbC.png

You have deleted 2021 iThome鐵人賽 @ironman2021_by_miku3920_bot.

看到這則訊息表示機器人已經刪除,無法復原
所有群組裡的這隻機器人都會顯示成 Deleted Account


上一篇
【PHP Telegram Bot】Day03 - 向 @BotFather 申請一隻機器人吧!
下一篇
【PHP Telegram Bot】Day05 - 程式語言的運作原理
系列文
用 PHP 打造專屬於自己的 Telegram 聊天機器人吧!30

尚未有邦友留言

立即登入留言