Line Notify是Line的服務之一,可以一對一、指定群組發送訊息,與Lint Chatbot不同的是Line Notify僅提供發訊息的功能,並無法像機器人一樣與使用者對話。
登入到Line Notify,在個人頁面中,可以查看已連動的服務,也就是允許向誰發送訊息。
在個人頁面的下方,可以點選「發行權限」,選擇欲連動的對象後系統會產生一組Access Token的Key,並且你的Line中會加入Line Notify這個特殊用戶並提示連動完成的訊息。
我們不能把Line Notify這個用戶刪除,不然就會無法收到訊息,記得要把這組Key記下來,不然離開畫面後就無法查詢Key了。
如果真的忘記Key的話,就只能刪除此連動再重新建立一個。
有了這組Key之後,就可以撰寫程式,範例如下(python):
def line_notify(msg = "TEST Message"):
TOKEN_KEY = 'KerYtwHeulvV60h3aBlcfu'
# 認證資訊寫在Header
HEADER = {'Content-Type':'application/x-www-form-urlencoded',"Authorization":'Bearer ' + TOKEN_KEY}
# Line Notify API Web URL
URL = 'https://notify-api.line.me/api/notify'
# 發送的訊息
payload = {'message':msg}
res=requests.post(URL,headers=HEADER,data=payload)
return res.status_code
以上建立存取權杖的優點是不用登錄網站就可以發送訊息,但是要小心不要把Key透露出去,不然第三者將能取得您所連動的公開資料。
另一種方法是管理登錄服務,此方法較為複雜,而且需要一個網頁伺服器,步驟如下:
(資料來源:Line Notify API Document:https://notify-bot.line.me/doc/en/)
首先一樣登入到Line Notify,選擇「管理登錄服務」,接著依畫面指示將資料填入各欄之內,下面這兩個欄位要填寫正確。
當建立一個管理登錄服務時,Line Notify會依此欄mail地址寄一封內有Client ID等訊息給你。
Callback URL則是當你向Line Notify要求認證後,會將code key回傳至此欄指定的網址,我們需要這組code才能正確向Line Notify要求回傳Access Token。
完成設定後,可以查詢新建的登錄服務的Client ID及Client Secret,如下:
因為我們需要一個http的服務才能讓Line Notify回傳code,所以我用docker建立一個node.js的服務器,因為Callback URL指定Port 8888,所以Node.js也要指定8888
Node.js相關程式範例如下:
----------------
package.json
----------------
{
"name": "docker_web_app",
"version": "1.0.0",
"description": "Node.js on Docker",
"author": "test@test.com>",
"main": "server.js",
"license": "MIT",
"private": true,
"scripts": {
"start": "node server.js"
},
"dependencies": {
"express": "^4.16.1"
}
}
-----------
server.js
-----------
'use strict';
const express = require('express');
const PORT = 8888;
const HOST = '0.0.0.0';
const app = express();
app.get('/', (req, res) => {
res.sendfile('index.html', function(err) {
if (err) res.send(404);
});
});
app.listen(PORT, HOST);
-------------
index.html
-------------
<!DOCTYPE html>
<html lang="tw">
<head>
<title></title>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<script>
function auth() {
var URL = 'https://notify-bot.line.me/oauth/authorize?';
URL += 'response_type=code';
URL += '&client_id=RSgbFmvqGP3wj';
// redirect_url的值必需與Line Notify中的Callback URL一致
URL += '&redirect_url=http:\/\/localhost:8888';
URL += '&scope=notify';
URL += '&state=NO_STATE';
window.location.href = URL;
}
</script>
</head>
<body>
<button onclick="auth();"> LineNotify </button>
</body>
</html>
執行node.js後,首頁如下圖,按下按鈕
登入後,接著選擇要連動的選項
如果與Callback URL設定不一致的話,則會出現下列的訊息
Line Notify會將code回傳,如下圖紅框處
接著利用Postman這套網路測試工具來測試,在網址列輸入https://notify-bot.line.me/oauth/token
模式是POST,在Body的部份依API Document填入grant_type、code、redirect_url、client_id、client_secret
其中grant_type必需填上authorization_code;code的部份填上上一步驟中獲取的code值;redirect_url則必須與Line Notify設定的Callbach URL一致;
client_id與client_secret的值在Line Notify的登錄服務中可以得知
按下「Send」送出Http request後,如果認證資料正確,則會傳回Accesss Token
在Postman新建一個頁面,模式選擇POST,網址填入https://notify-api.line.me/api/notify
在Headers的部份,主要增加Authorization,把Access Token加上Bearer後填上
Body的部份則增加message,內容就是欲發送的訊息
按下「Send」,此時Line就會出現通知的訊息了。網址輸入https://notify-api.line.me/api/status
Line Notify的發送也有限制,可以用下列的方式來確認,如下圖紅色框選處