感謝您對LINE官方帳號的支持。
官方帳號即將優化屬性資料,詳細內容請參考下方。
# 屬性分類功能優化
您可於群發訊息時選擇欲傳送之目標對象,依屬性篩選並設定篩選條件傳送予條件符合之對象,例如:性別、年齡、作業系統等。
我們預計將於 2020年12月1日 起優化屬性資料功能,使屬性資料更佳精準。
※請留意,選擇屬性後的目標好友數和群發訊息的發送量可能會有變動。
未來我們將持續新增與優化更多功能,敬請期待。
非常感謝您支持LINE官方帳號。
感謝您對LINE官方帳號的支持。
官方帳號即將優化屬性資料,詳細內容請參考下方。
您可於群發訊息時選擇欲傳送之目標對象,依屬性篩選並設定篩選條件傳送予條件符合之對象,例如:性別、年齡、作業系統等。
我們預計將於 2020年12月1日 起優化屬性資料功能,使屬性資料更佳精準。
※請留意,選擇屬性後的目標好友數和群發訊息的發送量可能會有變動。
未來我們將持續新增與優化更多功能,敬請期待。
非常感謝您支持LINE官方帳號。
基於資安的原因,Get all valid channel access tokens v2.1 的 Endpoint 會回傳重新加密後的 channel access tokens。
藉由這次的更新,在產生 channel access token v2.1 時會回傳一個對應 token 的 unique key ID (key_id)。您可以使用新的 Get all valid channel access token key IDs v2.1 的 Endpoint 來識別對應的 channel access tokens。
由於此次的更新,我們預計於七月上旬建議勿用 Get all valid channel access tokens v2.1 的 Endpoint。如果您正在使用此 Endpoint,請將您的 Bot 修改為新的 Get all valid channel access token key IDs v2.1 的 Endpoint。
更多關於發行channel access token v2.1的內容,請參考Messaging API技術文件。
Messaging API 追加了新的 endpoint。以下為本次更新的功能:
Endpoint
新功能的敘述如下。若需了解更多細節,請查閱 Messaging API reference 中各個新功能的說明。
當你的 LINE 官方帳號是群組的其中一員時,可取得的群組 ID、群組名稱以及群組圖示連結。
關於更多資訊,請查看Messaging API reference中的取得群組的資訊。
取得群組中的成員總數。即使其中的成員尚未將LINE官方帳號加為好友,或是已將LINE官方帳號封鎖,您都可以取得群組成員的總數。
關於更多資訊,請查看Messaging API reference中的取得群組裡的成員總數。
取得聊天室的成員總數。即使其中的成員未將LINE官方帳號加為好友,或是已將LINE官方帳號封鎖,您都可以取得聊天室成員的總數。
關於更多資訊,請查看Messaging API reference中的取得聊天室的成員總數。
我們發布了第一個關於使用Flex Message Simulator (opens new window)的教學指南。
遵循教學指南,您將能獲得關於使用Flex Message Simulator的實際操作經驗與知識。並且,在教學指南的最後,您將會使用Flex Message製作出如下方的出數位名片:
我們鼓勵您把握這次機會去學習如何使用Flex Message Simulator並創造出屬於您獨特的 Flex Message。
我們對Messaging API做了幾項改善。
目前已調整針對文字訊息的字數限制以及影音檔案使用條件。請參考下方表格比對變更前後的差異。
項目 | 變更前 | 變更後 |
---|---|---|
最大字數 | 2000 | 5000 |
圖文選單(Richmenu)物件 (圖片)
項目 | 變更前 | 變更後 |
---|---|---|
圖片尺寸 | 2500px × 1686px 2500px × 843px 1200px × 810px 1200px × 405px 800px × 540px 800px × 270px (寬度 x 高度) | 寬度800px以上 〜 2500px以下,高度250px以上 * |
* 寬度/長度的比例應至少為1.45。
圖片訊息 (圖片)
項目 | 變更前 | 變更後 |
---|---|---|
檔案格式 | JPEG | JPEG, PNG |
圖片尺寸上限 | 4096px × 4096px (寬度 x 高度) | 無限制 |
檔案大小上限 | 1MB | 10MB |
影片訊息 (影片)
項目 | 變更前 | 變更後 |
---|---|---|
長度上限 | 1分鐘 | 無限制 |
檔案大小上限 | 10MB | 200MB |
語音訊息 (語音)
項目 | 變更前 | 變更後 |
---|---|---|
長度上限 | 1分鐘 | 無限制 |
檔案大小上限 | 10MB | 200MB |
Imagemap訊息 (圖片)
項目 | 變更前 | 變更後 |
---|---|---|
檔案大小上限 | 1MB | 10MB |
Imagemap訊息 (影片)
項目 | 變更前 | 變更後 |
---|---|---|
長度上限 | 1分鐘 | 無限制 |
檔案大小上限 | 10MB | 200MB |
圖片訊息 / 影片訊息 / Imagemap訊息 (預覽圖片)
項目 | 變更前 | 變更後 |
---|---|---|
檔案格式 | JPEG | JPEG, PNG |
圖片尺寸上限 | 240px x 240px (寬度 x 高度) | 無限制 |
如果使用者傳送的文字中包含LINE表情貼,則在webhook接收到文字訊息物件時會包含emojis
的屬性,相關資訊被歸納在LINE emoji物件當中。
LINE表情貼種類是由productId
和emojiId
來識別:
{
"replyToken": "nHuyWiB7yP5Zw52FIkcQobQuGDXCTA",
"type": "message",
"mode": "active",
"timestamp": 1462629479859,
"source": {
"type": "user",
"userId": "U4af4980629..."
},
"message": {
"id": "325708",
"type": "text",
"text": "Hello, world! (love)",
"emojis": [
{
"index": 14,
"length": 6,
"productId": "5ac1bfd5040ab15980c9b435",
"emojiId": "001"
}
]
}
}
更多細節請參考Messaging API reference中的Text部分。
如果在使用Messaging API傳送訊息時出現錯誤,或是請求超時,您將無法得知訊息是否有正確地傳給使用者。而重新發送相同請求時,若第一次的請求已成功傳送,將可能導致使用者接收到同樣的訊息兩次。
您可以將retry key(X-Line-Retry-Key
)追加至HTTP Header來安全地重新發送相同的請求。
Retry key的值是由十六進制隨機產生的UUID(例如: 123e4567-e89b-12d3-a456-426614174000)。無論API請求時使用多少次含有相同UUID的retry key,終將只會有一次請求被接受,避免重複執行相同請求。而透過retry key,能使API請求在retry時能夠更安全地執行。
curl -v -X POST https://api.line.me/v2/bot/message/push \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {CHANNEL_ACCESS_TOKEN}' \
-H 'X-Line-Retry-Key: {UUID}' \
-d '{
"messages": [
{
"type": "text",
"text": "Hello, user"
}
]
}'
更多資訊請參考重新嘗試失敗的API請求。
我們在2020年4月22日發布了[更新] 關於Audience和Insight在一些集成式API中服務故障的問題。上述API現已可在受限制的狀況下使用。
請留意相關訊息的傳送日期與時間,關於建立曝光再行銷的受眾群可能會受限制,以及統計資料可能會有相關回傳值。
訊息發送的時間(JST): ~2020年3月29日,23:59:59
狀態:現已無限制。
訊息發送的時間(JST): 2020年3月30日 00:00:00~2020年4月29日23:59:59
狀態:有限制。
overview.uniqueImpression
與messages[].impression
會有相關回傳值。訊息發送的時間(JST): 2020年4月30日 00:00:00~
狀態:有限制。
關於更多資訊,請參考下方頁面:
我們將會持續改善我們向各位發開者提供的服務品質,並對於您的理解致上真誠的感謝。
我們必須通知您關於Messaging API近期發生的服務中斷問題。 所有由Messaging API提供的功能皆有可能受到影響。
這項問題目前已解決。Messaging API自下方的發生時間後已恢復正常運作。對於遲來的通知與此問題所造成的不便,我們致上誠摯的歉意。
日期: 2020年4月24日
時間: 14:41-17:46 (GMT+9)
網路故障
所有由Messaging API提供的功能皆有可能受到此問題影響。
LINE將會持續改善我們的服務品質以避免未來發生相關問題。感謝您的諒解。
Messaging API 發生了下列故障的問題。對此造成您的不便,我們致上誠摯的歉意。
日期: 2020 年 4 月 13 日
時間:約 15:30~ (GMT+9) (持續中)
在上述時間發生之後,無法準確計算出曝光再行銷的受眾群的曝光量。
因此我們暫時限制了部分功能的使用。整體來說,我們將會採取以下行動:
我們正積極的調查與修復此問題。
LINE 將會持續改善我們的服務品質以避免未來發生相關問題。感謝您的諒解。
2020年4月14日通知的下列Property名稱已變更。
變更前 | 變更後 |
---|---|
sticon | emojis |
sticon.sticonId | emojis.emojiId |
Messaging API進行了下列改善。
利用Messaging API傳送文字訊息之際,可傳送Unicode定義的表情貼、LINE獨家定義的表情貼(不建議),現在更可傳送LINE表情貼了。
LINE表情貼以productId
及emojiId
指定。
// 含有LINE表情貼的文字訊息示例
{
"type": "text",
"text": "Look at this: $ It's a LINE emoji!",
"emojis": [
{
"index": 14,
"productId": "5ac1bfd5040ab15980c9b435",
"emojiId": "001"
}
]
}
詳情請參閱《Messaging API reference》的「文字訊息」。
在取得個人資料端點,既存的用戶個人資料資訊會和language
Property一起退回。
但language
Property僅會在下列任一情況下退回。
傳送Multicast訊息 端點原本有限制1分鐘的收訊人數,此限制已在今天刪除。其他速度限制將繼續適用。關於變更前的限制和變更後的差異,請參閱下表。
Bot種類 | 變更前 | 變更後 |
---|---|---|
LINE官方帳號綁定的Bot | 100,000 Request/分 1,700 Request/秒(※) 2,000,000 收訊人/分 | 100,000 Request/分 1,700 Request/秒(※) |
LINE@帳號綁定的Bot | 10,000 Request/分 170 Request/秒(※) 200,000 收訊人/分 | 10,000 Request/分 170 Request/秒(※) |
※1秒單位的速度限制為大量傳送時的大概速度。
不僅如此,傳送Multicast訊息時,最多可指定500筆用戶ID(原為150筆,增加至500筆)。
詳情請參閱《Messaging API reference》的「速度制限」。
Channel Access Token的最新版本已上線。新版本除了能指定Token的有效期限之外,亦可用JSON Web Token(JWT)來取代Channel Secret強化安全性。
建議您使用Channel Access Token最新版本。
可使用任意的JWT函式庫 (opens new window),亦可自己寫Code 由Assertion Signing Key生成JWT。生成JWT是發行Channel Access Token v2.1必要的手續。
關於現在可利用的Channel Access Token種類及其不同,請參閱《Messaging API Document》的「Channel Access Token」。
隨著LINE訊息貼圖 (可輸入客製化文字的貼圖)的推出,對用於通知貼圖訊息傳送的webhook事件,我們在其stickerResourceType
屬性中新增了PER_STICKER_TEXT
。
如果一位LINE使用者向您的LINE官方帳號傳送了訊息貼圖,您將會收到一則包含PER_STICKER_TEXT
stickerResourceType
的webhook事件物件。
更多資訊請查看『Messaging API參考資料』中的貼圖 。
如March 10, 2020所通知,LINE Beacon已不再適用於LINE的下列版本:
以上版本的使用者無論是進入或離開LINE Beacon的發送範圍,都將無法被偵測到。
更多關於LINE Beacon的資訊,請查看使用Beacons。
對於這項改變可能造成的不便,我們致上誠摯的歉意。我們將會持續改善LINE的服務品質。感謝您的諒解。
由於LINE URL scheme line://
可能會產生接管攻擊,因此不建議使用。請改用https://line.me/R/
或https://liff.line.me/
。
line://
接管攻擊是指使用者在點擊line://
時,其他非LINE的app可能會不顧使用者的意願自動開始執行。這項攻擊僅會在特定的情況下發生。
line://
將來有可能會受到中止。如有進一步的決定,我們會在此通知。
更多關於LINE URL scheme的資訊,請查看『透過LINE URL scheme使用LINE功能』。
如同 2019 年 11 月 8 日新聞所述,部分 Messaging API endpoint 的網域名稱 (domain name) 由 api.line.me 變更為 api-data.line.me.
使用以上 endpoint 的開發者,請於轉換期限前變更網域名稱。
轉換期結束後,使用以上 endpoint 的舊網域名稱將會顯示 404
錯誤訊息。
如造成任何不便,敬請見諒,感謝配合。
2019 年 11 月 8 日 起至 2020 年 4 月 30 日
介紹如何透過 Messaging API 發送 Narrowcast 訊息、管理受眾的英文技術文件,已全數上線。
最新英文文件:
之前翻譯為英文的文件 (請見新聞 2020 年 2 月 19 日):
上述 Narrowcast 及 Audience Management 功能的相關新聞:
介紹如何透過 Messaging API 發送 narrowcast 訊息、管理受眾的 (部分) 英文技術文件正式上線:
部份文件仍為日文,近期內將翻譯為英文:
欲查看上述 Messaging API 功能的相關新聞,請至:
現在,開發者可於 LINE Official Account Manager 和 LINE Ad,使用以 Messaging API 建立的受眾群體 (Audience)。
受眾群體協助更精準地將廣告訊息發送給真正感興趣的用戶,透過使用受眾群體,開發者可將訊息傳送給之前曾開啟訊息,或點擊訊息連結的用戶。
之前建立過的受眾群體,將自動顯示於 LINE Official Account Manager 和 LINE Ad 中,開發者不須更改任何設定。
如欲取得更多受眾群體相關訊息,請查看 Messaging API 技術文件中的 Using audiences。
本功能原訂於 2020 年 1 月 9 日上線,但因故改於 2020 年 1 月 16 日上線。
自 2020 年 1 月 16 日起,使用 Messaging API 的 LINE 官方帳號,將於用戶資料下方顯示開發者註冊的 provider 名稱。
企業 LINE 官方帳號亦可能將個人名稱註冊為 provider 名稱,請確認所註冊的名稱正確無誤。Provider 可於 LINE Developers Console 進行更改。
*Provider 名稱如紅框中所示
Messaging API webhook event 新增屬性 mode
。
mode
為 channel multiplexing 功能的必要屬性 (開發中)。目前,所有 webhook event 皆包含 "mode": "active"
。
mode
的值不會自動切換為 standby
。若 channel 管理者開始使用 channel multiplexing 功能,可選擇將 mode
的值更改為 standby
。
如欲取得更多 mode
屬性相關訊息,請查看 Messaging API reference - webhook events 中的 Common properties 內容。
之前由於不同系統的時差設定有異,LINE Developers Console 中 Messaging API channel Statistics 表單所顯示的部份日期,與 TSV 檔案中所顯示的不一致 (TSV 檔案可透過點選 Download as TSV 按鍵產生)。
當時此狀況僅影響日本標準時間 (JST) 以外時區的資料顯示,且不會刪除或損毀資料。
2019/11/26~2019/12/18
目前,此問題已排除,開發者可重新取得正常顯示的資料。之前所造成的不便,敬請包涵!
Messaging API beacon event 新增 stay
event,可指出用戶目前位於 beacon 所涵蓋的範圍內。
如欲使用 stay
event,歡迎與 LINE for Business (opens new window) 團隊聯繫。
Webhook event 新增 stickerResourceType
屬性,開發者在收到貼圖訊息後,將可於訊息通知中取得此屬性。
開發者可透過此屬性,查看接收到的貼圖類型 (靜態貼圖、動態貼圖、動態有聲貼圖,或其他類型貼圖)。
如欲取得更多資訊,請至 Messaging API reference - Sticker 介紹。
最新 Messaging API endpoint 正式上線,提供詳細數據資料,協助開發者了解用戶與 LINE 官方帳號 (OA) 發送的訊息進行哪些互動。
此 endpoint 提供的數據資料,與 LINE Official Account manager (opens new window) 中 Insight 表單所顯示的數據資料相同。