# Camiol用JAVA + Heroku CLI 建立自己的Line Robot
**Step1:** 到[LINE Developers](https://developers.line.biz/zh-hant/)申請Line Robot，選擇右上角登入自己的line帳號

幫自己的Developer取名，填寫Email，按下同意後，建立Developer account

接著按下按鈕，開始建立Provider

幫自己的Provider取名，按下Create

接著要建立Channel，今天我們要建立的是可以發送和接收訊息的Messaging API Channel

設定國籍，和我們機器人的大頭貼

設定機器人的名稱，和描述，還有選擇分類和子分類

把兩個同意打勾後，按下Create

會跳出確認視窗，按下OK

然後按下同意

可以在Basic settings看到我們機器人的基本資料，Channel ID另外記下來，之後會用到

往下拉，將Channel secret和 Your user ID也記下來

選擇Messaging API，Bot basic ID就是機器人的帳號，可以把機器人加入好友，或是用QR code也可以

往下拉，可以看到API的權限，可以回覆訊息和發送訊息

拉到最下面有Channel access token(long-lived)，按下Issue產生token

把產生出來的token另外抄下來，之後會用到

這樣就建立好一個基本的Line Robot Messaging API了!

---

**Step2:** **註冊與設定Heroku平台**
我們預計要把Line Bot部屬在Heroku平台，因為在Webhook URL中須設定Line Robot的IP位置，其中Line官方的規範中，Line Robot須是走Https協定且不能是明碼，所以我們使用Heroku免費的雲端平台進行測試，使用 Heroku網站來充當webhook

Heroku是一個PaaS（Platform as a Service，平台即服務）。使用 PaaS，我們只要把寫好的專案部屬到平台上，網站就能開始運作了。

---
到[Heroku](https://www.heroku.com/)去申請帳號

按下右上角的Sign up

填完基本資料之後，「職業 (Role)」可以選擇學生 (student) 或「業餘愛好者 (hobbyist) 」，語言選擇JAVA，然後按下Create free account

然後他會寄認證信到你填的信箱，再去信箱收信認證

認證完後設定密碼

設定完後按下按鈕

按下Accept同意條款

按下Create new app

替你的App取個名字，名稱只能用英文、數字和連字符號，如果名稱欄位底下出現紅字，代表名稱包含不被接受的字元或者該名稱已經被佔用了。然後按下Create app

即可在Heroku平台上建立好執行App的環境。你的雲端程式路徑將是：

https://[剛取的app name].herokuapp.com/

---
**然後下載、安裝與執行Heroku CLI**
在dashboard這邊下載安裝Heroku CLI

選擇適合自己作業系統的執行檔下載，我是Windows-64bit

下載下來後，一直按next即可

安裝完畢後，開啟Windows「命令提示字元」或者Mac的終端機，輸入"heroku login"命令，測試登入你的Heroku平台：

按下enter，開啟瀏覽器，登入Heroku，然後按下Log In

可以看到Log In成功

回來cmd這邊，可以看到已成功登入Heroku

---
**Step3:用Spring boot來寫JAVA Line Robot**

可參考之前寫的這篇[建立一個SpringBoot + Spring + JPA 的Web專案](https://hackmd.io/i3T9xRyQR0OOVczCQmtkZQ)來建立一個基礎的Spring boot專案。


建立完後，去[Maven Depository](https://mvnrepository.com/search?q=com.linecorp.bot)搜尋com.linecorp.bot，下載Line Bot Spring Boot的4.3版(目前最新版4.9版檔案有問題沒辦法正常使用)，將它加到POM檔裡面

<!-- https://mvnrepository.com/artifact/com.linecorp.bot/line-bot-spring-boot -->
<dependency>
    <groupId>com.linecorp.bot</groupId>
    <artifactId>line-bot-spring-boot</artifactId>
    <version>4.3.0</version>
</dependency>

然後在application.properties這邊設定line bot相關設定檔:
token的部分填入之前申請時的token

然後建立一個RestController來測試是否專案正常啟動

package camiol.com.linebot.controller;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RequestMapping("/robot")
@RestController
public class RobotController {

	@GetMapping("/test")
	public ResponseEntity<String> test() {
		return new ResponseEntity<String>("Hello JAVA", HttpStatus.OK);
	}
}

然後啟動application後，在網址列輸入http://localhost:8080/robot/test，
可以看到成功啟動的測試畫面。

然後新增Handler來管理收到的訊息，寫個基本的echo message測試

package camiol.com.linebot.handler;

import com.linecorp.bot.model.event.Event;
import com.linecorp.bot.model.event.MessageEvent;
import com.linecorp.bot.model.event.message.TextMessageContent;
import com.linecorp.bot.model.message.TextMessage;
import com.linecorp.bot.spring.boot.annotation.EventMapping;
import com.linecorp.bot.spring.boot.annotation.LineMessageHandler;

@LineMessageHandler
public class Handler {
	@EventMapping
	public TextMessage handleTextMessageEvent(MessageEvent<TextMessageContent> event) {
		// 這邊做的就是簡單的 echo
		System.out.println("event: " + event);
		return new TextMessage(event.getMessage().getText());
	}

	@EventMapping
	public void handleDefaultMessageEvent(Event event) {
		// 就是加入聊天室, 離開聊天室, 還有一些有的沒的事件
		System.out.println("event: " + event);
	}
}

---
**Step4: 將寫好的程式佈署到Heroku平台並測試我們剛寫的echo bot**

回到LINE機器人的頻道設定頁面，在Messaging API這邊設定Webhook settings，按下Edit

填入佈署在heroku平台的雲端程式路徑，
https://[剛取的app name].herokuapp.com/(填入你在application.properties填的handler路徑)

以我的專案來做舉例：

https://camiol-line-bot.herokuapp.com/callback

輸入完後按下update

然後開啟Use webhook選項

再來要將程式佈署到Heroku上面，利用之前申請過的Heroku CLI，打開cmd，按照之前寫的登入方法操作，成功登入後，執行cd命令切換到line bot程式的根路徑：


在cmd上面輸入

git init

設定我們本機的heroku git的repository位置

再來將這個git和我們之前在heroku上面設定app連接起來，輸入

heroku git:remote -a 'Heroku應用程式名稱'

，用來設定遠端的git repository位置

輸入

git add .

把當前路徑包含子目錄的所有檔案都加進去git

輸入

git commit -am "想記錄的話"

將檔案commit到本機的repository

輸入

git push heroku master

將檔案push到Heroku平台上面並安裝

輸入

heroku open

就會自動打開瀏覽器，開啟Heroku應用程式

在我們的網址後面輸入我們之前設定測試的網址

/robot/test

就可以看到Hello JAVA了，代表程式正常運作中

在cmd輸入

heroku logs --tail

就可以看到專案的log

再來我們回到LINE機器人的頻道設定頁面，在Messaging API這邊的Webhook settings的Webhook URL，按下Verify，正常運作的話會回應Success

最後回到Line上面跟機器人對話，它就會回覆跟你一樣的話，完成echo bot test。

預設每次LINE機器人都會先回覆一則罐頭訊息，若要取消它，請將LINE頻道設定頁面的Auto-reply messages（自動回覆訊息）欄位設定成Disabled（取消）：

在這邊按下Edit

進到機器人設定畫面，這邊可以設定加入好友的歡迎訊息，然後我們把自動回應訊息給停用

再次發送訊息，就可以看到自動回覆訊息取消了。

這樣基本的line echo bot就完成了!

###### tags: `Spring boot` `Java` `Line bot`