Line Bot 教學

本教程介紹如何使用 Python LINE Bot SDK 在 Heroku 上架設一個簡單的回話機器人。

如果您想以另一種語言架設範例 bot，請參閱以下 LINE Bot SDK repositories。

在你開始之前

確保您具有以下內容：

擁有 Line 帳號
擁有 Heroku 帳戶（您可以免費創建一個）

建立 Heroku 專案

登入 Heroku 後，
在 Heroku 頁面中，點選 New -> Create New App
輸入自己喜歡的 App name ，然後點擊 Create app

創建 Line Bot 頻道

進入 Line 控制台
創建提供者
填入提供者名稱
點擊 Create
點擊 Create Channel
填入 Bot 資訊
同意 Line 條款，並按 Create
選擇剛剛創建的 Bot

設定範例機器人

按照以下步驟架設一個回話機器人。

下載範例程式碼
進入 Line 控制台，選擇你剛剛創建的機器人
開啟 webhook
關閉預設罐頭回覆訊息
產生 Channel access token
取得 Channel access token
取得 Channel secret
使用編輯器開啟範例程式碼資料夾內的 app.py，將剛剛取得的 channel secret 和 channel access token 填入

將程式推到 Heroku 上

下載並安裝 Heroku CLI、Git
開啟剛剛下載的範例程式碼資料夾，在路徑上輸入 cmd
使用終端或命令行應用程序登錄到 Heroku
```
 heroku login
```

初始化 git

 $ git config --global user.name "你的名字"
 $ git config --global user.email 你的信箱

注意：你的名字 和 你的信箱 要換成各自的名字和信箱

初始化 git
```
 git init
```
注意：僅第一次使用時要輸入
用 git 將資料夾與 heroku 連接
```
 heroku git:remote -a {HEROKU_APP_NAME}
```
注意：{HEROKU_APP_NAME} 是 Heroku 應用的名稱
輸入以下指令，將程式碼推上 Heroku，如果有跳出錯誤請重新輸入
```
 git add .
 git commit -m "Add code"
 git push -f heroku master
```
每當需要更新 Bot 時，請重新輸入上述指令

將 Heroku 與 Line 綁定

進入 Line 控制台，選擇你剛剛創建的 Bot
在 webhook URL 中輸入 Heroku 網址
```
 {HEROKU_APP_NAME}.herokuapp.com/callback
```
注意：{HEROKU_APP_NAME} 是 Heroku 應用的名稱

測試範例成果

進入 Line 控制台，選擇你剛剛創建的 Bot
通過在控制台的 “Channel settings” 頁面上掃描 QR Code，將您的 Bot 添加到 LINE 的朋友中
在 Line 上向您的 Bot 發送文字訊息，並確認它會學你說話

錯誤尋找

當程式遇到問題時，可查看日誌以找出錯誤

要查看您的 Bot 在 Heroku 的日誌，請按照以下步驟。

如果沒登入，請先透過 Heroku CLI 登入
```
 heroku login
```

顯示 app 日誌

 heroku logs --tail --app {HEROKU_APP_NAME}

注意：{HEROKU_APP_NAME} 是上述步驟2中的應用名稱。

 --tail                     # 持續打印日誌
 --app {HEROKU_APP_NAME}    # 指定 App

程式檔案解說

資料夾裡需含有兩份文件來讓你的程式能在 heroku 上運行

Procfile：heroku 執行命令，web: {語言} {檔案}，這邊語言為 python，要自動執行的檔案為 app.py，因此我們改成 web: python app.py。
requirements.txt：列出所有用到的套件，heroku 會依據這份文件來安裝需要套件

app.py (主程式)

可透過修改程式裡的 handle_message() 方法內的程式碼來控制機器人的訊息回覆

新版範例程式碼內附註解
如想更多了解此程式，可以去研究 Git、Python3、Flask 套件、Line bot sdk

進階操作

官方文件

回覆訊息

只有當有訊息傳來，才能回覆訊息

line_bot_api.reply_message(reply_token, 訊息物件)

主動傳送訊息

Bot 需要有開啟 push 功能才可以做，否則程式會出錯

line_bot_api.push_message(push_token, 訊息物件)

訊息物件分類

官方文件

修改範例程式碼中， handle_message() 方法內的程式碼，可實現多種功能

TextSendMessage （文字訊息）

message = TextSendMessage(text='Hello, world')
line_bot_api.reply_message(event.reply_token, message)

ImageSendMessage（圖片訊息）

message = ImageSendMessage(
    original_content_url='https://example.com/original.jpg',
    preview_image_url='https://example.com/preview.jpg'
)
line_bot_api.reply_message(event.reply_token, message)

VideoSendMessage（影片訊息）

message = VideoSendMessage(
    original_content_url='https://example.com/original.mp4',
    preview_image_url='https://example.com/preview.jpg'
)
line_bot_api.reply_message(event.reply_token, message)

AudioSendMessage（音訊訊息）

message = AudioSendMessage(
    original_content_url='https://example.com/original.m4a',
    duration=240000
)
line_bot_api.reply_message(event.reply_token, message)

LocationSendMessage（位置訊息）

message = LocationSendMessage(
    title='my location',
    address='Tokyo',
    latitude=35.65910807942215,
    longitude=139.70372892916203
)
line_bot_api.reply_message(event.reply_token, message)

StickerSendMessage（貼圖訊息）

message = StickerSendMessage(
    package_id='1',
    sticker_id='1'
)
line_bot_api.reply_message(event.reply_token, message)

ImagemapSendMessage （組圖訊息）

message = ImagemapSendMessage(
    base_url='https://example.com/base',
    alt_text='this is an imagemap',
    base_size=BaseSize(height=1040, width=1040),
    actions=[
        URIImagemapAction(
            link_uri='https://example.com/',
            area=ImagemapArea(
                x=0, y=0, width=520, height=1040
            )
        ),
        MessageImagemapAction(
            text='hello',
            area=ImagemapArea(
                x=520, y=0, width=520, height=1040
            )
        )
    ]
)
line_bot_api.reply_message(event.reply_token, message)

TemplateSendMessage - ButtonsTemplate （按鈕介面訊息）

message = TemplateSendMessage(
    alt_text='Buttons template',
    template=ButtonsTemplate(
        thumbnail_image_url='https://example.com/image.jpg',
        title='Menu',
        text='Please select',
        actions=[
            PostbackTemplateAction(
                label='postback',
                text='postback text',
                data='action=buy&itemid=1'
            ),
            MessageTemplateAction(
                label='message',
                text='message text'
            ),
            URITemplateAction(
                label='uri',
                uri='http://example.com/'
            )
        ]
    )
)
line_bot_api.reply_message(event.reply_token, message)

TemplateSendMessage - ConfirmTemplate（確認介面訊息）

message = TemplateSendMessage(
    alt_text='Confirm template',
    template=ConfirmTemplate(
        text='Are you sure?',
        actions=[
            PostbackTemplateAction(
                label='postback',
                text='postback text',
                data='action=buy&itemid=1'
            ),
            MessageTemplateAction(
                label='message',
                text='message text'
            )
        ]
    )
)
line_bot_api.reply_message(event.reply_token, message)

TemplateSendMessage - CarouselTemplate

message = TemplateSendMessage(
    alt_text='Carousel template',
    template=CarouselTemplate(
        columns=[
            CarouselColumn(
                thumbnail_image_url='https://example.com/item1.jpg',
                title='this is menu1',
                text='description1',
                actions=[
                    PostbackTemplateAction(
                        label='postback1',
                        text='postback text1',
                        data='action=buy&itemid=1'
                    ),
                    MessageTemplateAction(
                        label='message1',
                        text='message text1'
                    ),
                    URITemplateAction(
                        label='uri1',
                        uri='http://example.com/1'
                    )
                ]
            ),
            CarouselColumn(
                thumbnail_image_url='https://example.com/item2.jpg',
                title='this is menu2',
                text='description2',
                actions=[
                    PostbackTemplateAction(
                        label='postback2',
                        text='postback text2',
                        data='action=buy&itemid=2'
                    ),
                    MessageTemplateAction(
                        label='message2',
                        text='message text2'
                    ),
                    URITemplateAction(
                        label='uri2',
                        uri='http://example.com/2'
                    )
                ]
            )
        ]
    )
)
line_bot_api.reply_message(event.reply_token, message)

TemplateSendMessage - ImageCarouselTemplate

message = TemplateSendMessage(
    alt_text='ImageCarousel template',
    template=ImageCarouselTemplate(
        columns=[
            ImageCarouselColumn(
                image_url='https://example.com/item1.jpg',
                action=PostbackTemplateAction(
                    label='postback1',
                    text='postback text1',
                    data='action=buy&itemid=1'
                )
            ),
            ImageCarouselColumn(
                image_url='https://example.com/item2.jpg',
                action=PostbackTemplateAction(
                    label='postback2',
                    text='postback text2',
                    data='action=buy&itemid=2'
                )
            )
        ]
    )
)
line_bot_api.reply_message(event.reply_token, message)