.NET Walker

很多人期待這組API很久了，終於，在光輝的十月，LINE通知大家，這組API出現了😍： https://developers.line.biz/en/news/2020/10/06/messaging-api-update-october-2020/ 過去，開發者要動態修改LINE Bot的WebHook是不可能的。😢 唯一的方式是去LINE的Developer後台 手動 修改。 但這造成了許多LINE Bot開發廠商的維運難度。 想像一下，你需要為近百個客戶同時升級改版，更新WebHook的時候，會是一個多大的工程? 😒 還不僅如此，有許多LINE Bot應用廠商，自己也做了LINE Bot的管理後台，想讓客戶輸入LINE Bot的Channel Access Token，就可以幫客戶的LINE Bot動態賦予不同的行為。但過去，這也無法達成，非得要到客戶的後台去設定不可。(但直接去客戶後台修改? 還是手動? 有點 low 了吧…) 而現在這一組API，則徹底的解決了這個問題。現在，你只要有LINE Bot的Channel Access Token，就可以動態幫LINE Bot隨時設定或調整WebHook URL。 LINE公布了這組API之後，我們的SDK當然立刻更新。 現在，你只需要透過底下這樣的指令，就可以動態設定 LINE Bot的WebHook： isRock . LineBot . Utility . SetWebhookEndpointURL ( ChannelAccessToken , WebHookUrl ) ; 想要抓取當前LINE Bot的WebHook也不是難事： var ret = isRock . LineBot . Utility . GetWebhookEndpointInformation ( ChannelAccessToken ) ; 上面取得的ret，會有底下2個屬性： active屬性可以得知當前是否有使用WebHook，而endpoint當然就是WebHook的url囉。 想要測試 WebHook是否正確也可以用 API呢，例如： ret2 = isRock . LineBot . Utility . TestWebhookEndpoint ( Chan...

經過了前面三篇準備，我們是時候要來用 .net core 的 C# 來開發 LINE Bot了。 首先，我們來看如何撰寫程式碼發送(Push) LINE 訊息給用戶。 前面你已經看過我們怎麼用CLI工具在Command Line透過line指令(有點繞口)發送訊息，現在我們來看你怎麼建立一個 .net core 的C#應用程式來發訊息。 建立console application 為了讓範例盡可能簡單，我們先採用 console application。你可以用底下這樣的指令來建立Console App： dotnet new console 不過，我會先建議你找一個空的資料夾，或建立一個。所以，我們下這樣的指令： md TestLineBot cd TestLineBot dotnet new console 你會看到底下結果： PS D:\TestLineBot > dotnet new console Getting ready .. . The template "Console Application" was created successfully. Processing post-creation actions .. . Running 'dotnet restore' on D:\TestLineBot\TestLineBot.csproj .. . 正在判斷要還原的專案 .. . 已還原 D:\TestLineBot\TestLineBot.csproj ( 286 ms 內 ) 。 Restore succeeded. PS D:\TestLineBot > 這表示你的專案已經建立好了，如果你這表示你的專案已經建立好了，如果你透過ls或dir來顯示資料夾中的內容，應該會發現： 其中主程式是 Program.cs，而TestLineBot.csproj則是 .net core的專案檔，預設與資料夾同名(如果你沒有指定的話)。 接著，我們耀來撰寫程式，我們使用 VS Code作為開發工具。 我們透過 『code .』來開啟VS Code… 請注意 code和 . 中間有個空白。 這個指令的意思是，開啟VS Code，並且預設以當前目...

前面我們介紹過了如何建立LINE Bot，並且取得Channel Access Token和你個人的UserID，接著，我們要介紹如何來控制LINE Bot發送(Push推播)訊息給特定人。 控制LINE Bot的主要要件是Channel Access Token，而透過命令列控制LINE Bot，則是完全不用寫程式的，堪稱是最簡單的方式。 但前提是: 你要安裝好 .net core SDK 3.1.300+(先前有提過，沒裝趕快裝，後面也會用到) 你要下載 line.cli 工具。請在命令列執行底下指令，即可下載 dotnet tool install --global line.cli 在一台尚未安裝過的電腦上，執行上述指令，會看到底下畫面： 確認安裝成功之後，你可以直接在命令列(MAC環境請用bash)，下line指令： 當你下了line指令，會看到上面這樣的說明畫面，介紹如何使用。例如，你可以透過底下這樣簡單的指令，命令LINE Bot發訊息給特定用戶(當然前提是，該用戶已經加你的LINE Bot為好友。) line push -u [userId] -m Hello 但下達上面這個指令之前，別忘了先進行config設定，請用底下這樣的指令，設定你的LINE Bot Channel Access Token(記得嗎？你剛建立好LINE Bot時候取得的那個…) line config -t [channel access token] 例如： 正確的設定完成之後，接著你就可以發送訊息了！ 你還不知道任何人的 UserID，是的。但你知道你自己的啊，還記得嗎？LINE Bot後台可以看到 Your user ID: 找到後，你就可以嘗試透過命令列發送訊息給自己囉(請記得把UserID換成你自己的），例如: line push -u Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxa -m “Hello, 發大財” 就這樣，你不用撰寫任何一行程式碼，就可以控制你的LINE Bot囉…即便對初學者來說，都應該算是很簡單吧。 如果完成了，請試著發送貼圖和圖片訊息給自己，在上面的LINE CLI工具說明中可以找到線索。 交給你了。就當成練習，試試看囉~

為何使用 .net core 開發 LINE Bot? 如果你原本就是 .net 開發人員，這個問題對你不是問題，反而你可能需要知道的是，我們後面的開發都會採用VS Code，而非Visual Studio。 而如果你原本不是 .net 開發人員，那選擇 .net core 作為 LINE Bot 的開發有底下幾個好處： .net core是跨平台開發工具，可以輕鬆的在MAC/Linux/Docker環境上運行 開發時只需要使用 VS Code(Visual Studio Code)，如果你用MAC，也無須安裝Windows或Visual Studio(雖然它很強) 如果你使用Windows，也只需要安裝 VS Code，可以在極輕省的狀況下進行開發 在 .net core 環境上，有非常方便的 LineBotSDK可用，讓你幾乎不用花太多精力就可以做出一個LINE Bot 如果要測試，.net core 世界中還有 LINE 的 CLI 工具，可以讓你在命令列無須寫程式就可以控制 LINE Bot。 好處很多。總的來說，如果你曾經覺得寫 LINE Bot或LINE官方帳號很麻煩，那使用C#搭配 .net core 應該會讓你改觀。 關於開發工具與環境 VS Code(Visual Studio Code)是近代跨平台開發工具中的黑馬，不管是開發 Python, Node.js, 或是 .net core，它都是很好的選擇。由於支持跨平台且開源(open source)，因此獲得了眾多開發人員的青睞與支持。內建 git 版控管理工具，也讓開發人員可以輕易的完成各項開發版本控管工作。同時，豐富的擴充套件(extensions)，也使得開發人員可以得到許多額外擴充功能的支援(例如程式碼的自動格式化、單元測試、單步執行偵錯…等) 你可以透過底下這個位置下載安裝 VS Code(不過等等，我們建議先安裝 .net core SDK): https://code.visualstudio.com/download 除了安裝 VS Code之外，你另外唯一需要安裝的是 .net core SDK，同樣的，因為支援跨平台，所以你可以輕鬆地找到適合你作業系統的版本： https://dotnet.microsoft.com/download ...

申請你的LINE Bot帳號 關於這個主題，我大概每年重寫一次，原因很簡單 – LINE的網站一直在變。 在敏捷成為主流的這個年代，網站改版已經是常態。有時候上課上到一半，突然間網站UI整個不同，也不是一件新奇的事情了。也因此，每年寫一版『申請帳號』流程，大概也是剛好而已。 來吧，如何申請你的LINE Bot帳號? 首先，請準備你的LINE帳號，我知道你有一個LINE ID，但我們用不上它，們待會需要的是你的email和密碼，也就是你用來登入desktop版本的LINE時，所用的那組email帳號和密碼，如果你真的沒有(不曾用PC/MAC登入LINE?) 那你待會用手機掃QR Code登入也行。 準備好帳密或手機之後，請進入底下網址： https://developers.line.biz/zh-hant/ 進入後，請點選下圖中的Log in，以你的帳號密碼登入： 如果出現底下畫面，請選擇 使用LINE帳號登入 接著，你可以輸入email和密碼，或是透過手機掃描QR Code登入： 第一次登入，可能會要求你建立Provider，這個Provider是你待會要建立的LINE Bot的所屬單位，一般用公司或機構名稱，如果你是自己玩玩，也可以用個人工作室名稱或你自己的代號： 建立完成之後，你可以在Provider的首頁，建立LINE Bot了。LINE Bot屬於 channel 的一種，所以你可以透過底下『Create a new channel』來建立： 接著在出現的畫面點選『Messaging API』，這就是LINE Bot帳號了： 接著在Create a channel的畫面中，選擇Bot的圖示(Channel Icon)： 並填寫名稱(Channel name)、說明(Channel description)、分類和子分類(Category/Subcategory)，並填寫你的mail和勾選同意條款後，按下Create即可： 取得重要資訊 建立好LINE Bot之後，我們要取得幾個重要的相關資訊，你可以在LINE Bot的首頁找到Messaging API，點選後，可以看到底下畫面： 即便你是該LINE Bot的建立者，你自己也要將其加入為好友才行測試。 透過上面的QR Code或Bot ID(@xxxxx...