參考資源
- LINE Developers
- Messaging API reference
- 用 PHP 實現 Line Message API 接收系統訊息
- ChatBot&Chatbase 系列
- [Line Bot] Messaging Api 回話機器人 (PHP)
- LINE Chatbot 開發攻略(二)
--
沒有程式的生活圈是什麼樣的？
簡單說就只是「沒有程式自動化」，也就是沒有機器人自動回答，可以一對一客服也可以發訊息給全部好友
換句話說，如果想要讓客戶自行輸入關鍵字即可得到資訊就需要使用 API，需要切換到何種方案就需要看進一步的需求
--
名詞釋疑
生活圈 LINE@ 從 https://at.line.me/tw/ 建立的叫做生活圈，後台是 https://admin-official.line.me
生活圈 LINE@ 建立的稱作「帳號」，LINE Developers 建立的叫做 channel
使用生活圈必須另外在手機上下載使用另一個 LINE@ 的 APP 來管理 LINE 生活圈，生活圈的管理是無法從網頁後台或是 LINE 去操作的
--
Hoyo 提供線上工具
--
費用
從 https://manager.line.biz 進入，選擇對應 Accounts → 右上角 Settings → 最下面 Account details → Change plan (像迷宮一樣難找)
--
流程、步驟
- 從 LINE Developers 加入開發者
- 新增時選擇「Messaging API」
- Plan → Developer Trial
- 新增後再次選擇設定
- Channel access token : 產生 API 發送使用 access token
- Use webhooks : Enabled
- Webhook URL : 接受 LINE 訊息的網址
- 分享 QRCode 加入 LINE 機器人
--
Webhook URL - 接收訊息的 Reply.php
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
<?php $content = file_get_contents('php://input'); $json = json_decode($content, true); /* Array ( [events] => Array ( [0] => Array ( [type] => message [replyToken] => 774ac5a25e364a27baadc02cb4b85d3b [source] => Array ( [userId] => Ub6f482e797e6b2dd51916f82317c6852 [type] => user ) [timestamp] => 1549076498796 [message] => Array ( [type] => text [id] => 9285802797745 [text] => Jjj ) ) ) [destination] => Ue1a6a9ecfd1fa5147f94093b2995a511 ) */ |
--
接收 LINE 的訊息
收到的訊息是 JSON 格式，大概長這樣
|
1 |
{"events":[{"type":"message","replyToken":"abf341d141ea4d4c94cd510871163f84","source":{"userId":"Uc5629999999999999999999c88ed8","type":"user"},"timestamp":1535249611645,"message":{"type":"text","id":"8475560626630","text":"..."}}]} |
比較容易看的格式
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
Array ( [events] => Array ( [0] => Array ( [type] => message [replyToken] => 65bc479f0e964d99979214d4a9056613 [source] => Array ( [userId] => Uc5629999999999999999999c88ed8 [type] => user ) [timestamp] => 1535250117828 [message] => Array ( [type] => text [id] => 8475588288350 [text] => ... ) ) ) ) |
--
Reply 一問一答的 LINE 機器人
--
群發
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
curl -v -X POST https://api.line.me/v2/bot/message/multicast \ -H 'Content-Type:application/json' \ -H 'Authorization: Bearer {channel access token}' \ -d '{ "to": ["U4af4980629...","U0c229f96c4..."], "messages":[ { "type":"text", "text":"Hello, world1" }, { "type":"text", "text":"Hello, world2" } ] }' |
--
發送 - 圖檔
|
1 2 3 4 5 6 7 8 |
'to' => array('user1', 'user2', ...), 'messages' => [ [ 'type' => 'image', 'originalContentUrl' => 'https://hoyo.idv.tw/line.jpg', 'previewImageUrl' => 'https://hoyo.idv.tw/line.jpg' ] ] |
--
發送 - 視頻
官方文件說有影片以及預覽圖大小限制，實際上因為檔案放在自己主機上，所以並無限制
|
1 2 3 4 5 6 7 8 |
'to' => array('user1', 'user2', ...), 'messages' => [ [ 'type' => 'video', 'originalContentUrl' => 'https://hoyo.idv.tw/line.mp4', 'previewImageUrl' => 'https://hoyo.idv.tw/line.jpg' ] ] |
--
發送 - 音頻
|
1 2 3 4 5 6 7 8 |
'to' => array('user1', 'user2', ...), 'messages' => [ [ 'type' => 'audio', 'originalContentUrl' => 'https://hoyo.idv.tw/line.mp4', 'duration' => 10000 ] ] |
- duration 單位為千分之一毫秒，只和顯示播放倒數有關，音頻有多長還是播多長
--
取得使用者資訊
|
1 2 |
curl -v -X GET https://api.line.me/v2/bot/profile/{userId} \ -H 'Authorization: Bearer {channel access token}' |
PHP
回傳 JSON
|
1 2 3 4 5 6 |
{ <span style="color: #333333; font-family: Consolas, Monaco, monospace; font-style: normal; line-height: 1.5;"> "userId":"U4af4980629...", </span> "displayName":"LINE taro", "pictureUrl":"http://obs.line-apps.com/...", "statusMessage":"Hello, LINE!" } |
--
使用 LINE@ 後台
官方後台的訊息發送並不是立即， 2019-3-24 實測時有 3 分鐘的延遲，加入好友且已可接收訊息也沒有更新好友數
--
各種接收到的 Json
加入
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
Array ( [events] => Array ( [0] => Array ( [type] => follow [replyToken] => 292412474b244a969141b9eae2d5fdf2 [source] => Array ( [userId] => Ub6f482e797e6b2dd51916f82317c6852 [type] => user ) [timestamp] => 1557142887582 ) ) [destination] => U533b39b605394f172e618c9664f6199d ) |
退出 (隱藏後刪除)
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
Array ( [events] => Array ( [0] => Array ( [type] => unfollow [source] => Array ( [userId] => Ub6f482e797e6b2dd51916f82317c6852 [type] => user ) [timestamp] => 1557142871168 ) ) [destination] => U533b39b605394f172e618c9664f6199d ) |
文字訊息
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
Array ( [events] => Array ( [0] => Array ( [type] => message [replyToken] => 883e02438b034a92bc7d7dc8cca7e563 [source] => Array ( [userId] => Ub6f482e797e6b2dd51916f82317c6852 [type] => user ) [timestamp] => 1557156332815 [message] => Array ( [type] => text [id] => 9819169068594 [text] => 333 ) ) ) [destination] => U533b39b605394f172e618c9664f6199d ) |
表情貼
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
Array ( [events] => Array ( [0] => Array ( [type] => message [replyToken] => 79f3c0f0fda9497c818396b174b46958 [source] => Array ( [userId] => Ub6f482e797e6b2dd51916f82317c6852 [type] => user ) [timestamp] => 1557157644171 [message] => Array ( [type] => sticker [id] => 9819257408121 [stickerId] => 48135 [packageId] => 2000000 ) ) ) [destination] => U533b39b605394f172e618c9664f6199d ) |
貼圖
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
Array ( [events] => Array ( [0] => Array ( [type] => message [replyToken] => 1de46282b6c64322be8b89b571fffe66 [source] => Array ( [userId] => Ub6f482e797e6b2dd51916f82317c6852 [type] => user ) [timestamp] => 1557157662262 [message] => Array ( [type] => sticker [id] => 9819258559387 [stickerId] => 12881334 [packageId] => 1319240 ) ) ) [destination] => U533b39b605394f172e618c9664f6199d ) |
圖檔
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
Array ( [events] => Array ( [0] => Array ( [type] => message [replyToken] => 915eb2f10a1d4f8b8e2430bbd6c9696b [source] => Array ( [userId] => Ub6f482e797e6b2dd51916f82317c6852 [type] => user ) [timestamp] => 1557160096892 [message] => Array ( [type] => image [id] => 9819400393369 [contentProvider] => Array ( [type] => line ) ) ) ) [destination] => U533b39b605394f172e618c9664f6199d ) |
影片
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
Array ( [events] => Array ( [0] => Array ( [type] => message [replyToken] => d116c4c39c6a4369bd15525b3f4f97c2 [source] => Array ( [userId] => Ub6f482e797e6b2dd51916f82317c6852 [type] => user ) [timestamp] => 1557160527665 [message] => Array ( [type] => video [id] => 9819423462427 [contentProvider] => Array ( [type] => line ) [duration] => 197400 ) ) ) [destination] => U533b39b605394f172e618c9664f6199d ) |
--
取得圖、影音檔案內容
必須使用和 message 相同的 bot 才可以取得內容
https://api.line.me/v2/bot/message/{messageId}/content
--
顯示貼圖、表情貼
--
11,104 total views, 2 views today