Line Notify 簡易教學


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的發送也有限制,可以用下列的方式來確認,如下圖紅色框選處