如何發送LINE Template Messages

Overview

這個Lab介紹如何透過 C# 以程式碼發送LINE的Template message訊息。包含Buttons Template, Confirm Template, Carousel Template, Image Carousel Template訊息。

Prerequisites

1. 建立好LINE Bot帳號，並取得Channel Access Token與UserId 參考這裡

2. 下載安裝 .net core sdk 3.1 以上版本 here

3. 安裝 Visual Studio Code 開發工具 here

4. 建立 .net core console 專案，在專案中引用 nuget 上的 LineBotSDK 套件。

5. ==請留意本Lab必須在手機上檢視結果==

Steps

建立 .net core console專案

在命令列模式建立資料夾，接著透過 dotnet new 指令建立專案

PS D:\> md linetest
PS D:\> cd linetest
PS D:\linetest> dotnet new console

系統會出現類似底下畫面...

The template "Console Application" was created successfully.

Processing post-creation actions...
Running 'dotnet restore' on D:\linetest\linetest.csproj...
  正在判斷要還原的專案...
  已還原 D:\linetest\linetest.csproj (251 ms 內)。
Restore succeeded.

接著執行底下指令， 安裝 LineBotSDK 套件...

PS D:\linetest> dotnet add package linebotsdk

系統會出現類似底下畫面...

PS D:\linetest> dotnet add package linebotsdk
  正在判斷要還原的專案...
  Writing C:\Users\...\AppData\Local\Temp\tmpC537.tmp
info : 正在將套件 'linebotsdk' 的 PackageReference 新增至專案 'D:\linetest\linetest.csproj'。
info : 正在還原 D:\linetest\linetest.csproj 的封裝...
info :   GET https://api.nuget.org/v3-flatcontainer/linebotsdk/index.json
info :   OK https://api.nuget.org/v3-flatcontainer/linebotsdk/index.json 1088 毫秒
info : 套件 'linebotsdk' 與專案 'D:\linetest\linetest.csproj' 中的所有架構相容。
info : 已將套件 'linebotsdk' 版本 '2.2.23' 的 PackageReference 新增至檔案 'D:\linetest\linetest.csproj'。
info : 正在認可還原...
info : 正在將資產檔案寫入磁碟。路徑: D:\linetest\obj\project.assets.json
log  : 已還原 D:\linetest\linetest.csproj (3.16 sec 內)。

安裝完成後我們順便建置(Build)一下，看結果如何:

PS D:\linetest> dotnet build
Microsoft (R) Build Engine for .NET Core 16.6.0+5ff7b0c9e 版
Copyright (C) Microsoft Corporation. 著作權所有，並保留一切權利。

  正在判斷要還原的專案...
  已還原 D:\linetest\linetest.csproj (712 ms 內)。
  linetest -> D:\linetest\bin\Debug\netcoreapp3.1\linetest.dll

建置成功。
    0 個警告
    0 個錯誤

經過時間 00:00:05.39

如果可以順利建置，你應該會收到類似上面這樣的訊息。

透過底下指令，開啟 VS Code進入開發環境

請在命令列輸入 code (空格) .

PS D:\linetest> code .
PS D:\linetest>

完成後會看到類似上面的畫面。

建立bot物件實體

輸入底下程式碼，建立bot instance (請將token與UserId換為你自己的)

var  ChannelAccessToken = "___token___="; //Channel Access Token
var  UserId = "___UserId__"; //收訊者
var  bot = new  isRock.LineBot.Bot(ChannelAccessToken);

發送ButtonsTemplate

輸入底下程式碼，發送具有三個action的Buttons Template Message:

//建立Actions
var Actions = new List<isRock.LineBot.TemplateActionBase>();
Actions.Add(new isRock.LineBot.MessageAction() //MessageAction
{
    label = "標題-文字回覆",
    text = "文字回覆"
});
Actions.Add(new isRock.LineBot.UriAction() //UriAction
{
    label = "標題-開瀏覽器",
    uri = new Uri("https://www.google.com")
});
Actions.Add(new isRock.LineBot.PostbackAction() //PostbackAction
{
    label = "標題-按了沒反應?(postback)",
    data = "abc=aaa&def=111"
});
//建立發送訊息
isRock.LineBot.ButtonsTemplate btnMsg =
new isRock.LineBot.ButtonsTemplate()
{
    thumbnailImageUrl = new Uri("https://i.imgur.com/5JKErL4.png"),
    text = "ButtonsTempalte的文字",
    title = "ButtonsTempalte的標題",
    actions = Actions,
};
//發送訊息
bot.PushMessage(UserId, btnMsg);

輸入完畢後，鍵入 dotnet run 執行程式

PS D:\linetest> dotnet run

結果如下:

enter image description here

第1個MessageAction當用戶按下，會顯示文字(如同幫用戶說一句話) 第2個UriAction當用戶按下，會開啟指定的網頁 第3個PostbackAction當用戶按下，會觸發後端WebHook可接收的PostBack事件

發送ConfirmTempalte

請繼續加入底下程式碼，可發送ConfirmTempalte訊息：

//建立Actions
var Actions = new List<isRock.LineBot.TemplateActionBase>();
Actions.Add(new isRock.LineBot.MessageAction() //MessageAction
{
    label = "Yes",
    text = "Yes"
});
Actions.Add(new isRock.LineBot.MessageAction() //MessageAction
{
    label = "No",
    text = "No"
});

//建立發送訊息
isRock.LineBot.ConfirmTemplate ConfirmTemplateMsg =
new isRock.LineBot.ConfirmTemplate()
{
    text = "Confirm Template Message",
    actions = Actions,
};
//發送訊息
bot.PushMessage(UserId, ConfirmTemplateMsg);

輸入完畢後，鍵入 dotnet run 執行程式

PS D:\linetest> dotnet run

執行結果如下:

enter image description here

發送 Carousel Template

底下的程式碼，可發送Carousel Template，Carousel Template是可左右捲動的卡片，卡片外型類似Buttons Template，每個Carousel Template物件最多可放置十個卡片，每一個卡片稱為一個Column。

底下建立一個Column，並重複放置3次到Carousel Template中...

//建立actions
var actions = new List<isRock.LineBot.TemplateActionBase>();
actions.Add(new isRock.LineBot.MessageAction() { label = "標題-文字回覆", text = "回覆文字" });
actions.Add(new isRock.LineBot.UriAction() { label = "標題-Google", uri = new Uri("http://www.google.com") });
actions.Add(new isRock.LineBot.PostbackAction() { label = "標題-發生postback", data = "abc=aaa&def=111" });
//單一Column 
var Column = new isRock.LineBot.Column
{
    text = "ButtonsTemplate文字訊息",
    title = "ButtonsTemplate標題",
    //設定圖片
    thumbnailImageUrl = new Uri("https://arock.blob.core.windows.net/blogdata201706/22-124357-ad3c87d6-b9cc-488a-8150-1c2fe642d237.png"),
    actions = actions //設定回覆動作
};
//建立CarouselTemplate
var CarouselTemplate = new isRock.LineBot.CarouselTemplate();
//這是範例，所以用一組樣板建立三個
CarouselTemplate.columns.Add(Column);
CarouselTemplate.columns.Add(Column);
CarouselTemplate.columns.Add(Column);
//發送訊息
bot.PushMessage(UserId, CarouselTemplate);

輸入完畢後，鍵入 dotnet run 執行程式

PS D:\linetest> dotnet run

執行結果如下：

enter image description here

發送Image Carousel

Image Carousel是可左右捲動的滿版圖片，並且可附上按鈕。

請輸入下面的程式碼...

//單一Column 
var Column = new isRock.LineBot.ImageCarouselColumn
{
    imageUrl = new Uri("https://arock.blob.core.windows.net/blogdata201706/22-124357-ad3c87d6-b9cc-488a-8150-1c2fe642d237.png"),
    action = new isRock.LineBot.MessageAction() { label = "標題-文字回覆", text = "回覆文字" } //設定回覆動作
};
//建立ImageCarouselTemplate
var ImageCarouselTemplate = new isRock.LineBot.ImageCarouselTemplate();
//這是範例，所以用一組樣板建立三個
ImageCarouselTemplate.columns.Add(Column);
ImageCarouselTemplate.columns.Add(Column);
ImageCarouselTemplate.columns.Add(Column);
//發送訊息
bot.PushMessage(UserId, ImageCarouselTemplate);

輸入完畢後，鍵入 dotnet run 執行程式

PS D:\linetest> dotnet run

執行後，可得到結果如下：

enter image description here

相關參考資料

電子書：https://www.pubu.com.tw/ebook/103305 實體書：https://www.tenlong.com.tw/products/9789865022662 線上課程：https://www.udemy.com/line-bot/ LineBotSDK：https://www.nuget.org/packages/LineBotSDK

如果需要即時取得更多相關訊息，可按這裡加入FB專頁。若這篇文章對您有所幫助，請幫我們分享出去，謝謝您的支持。