# News: Articles for #Messaging API

2020/11/30

[功能更新] 屬性分類功能優化

感謝您對LINE官方帳號的支持。 官方帳號即將優化屬性資料,詳細內容請參考下方。

# 屬性分類功能優化

您可於群發訊息時選擇欲傳送之目標對象,依屬性篩選並設定篩選條件傳送予條件符合之對象,例如:性別、年齡、作業系統等。

我們預計將於 2020年12月1日 起優化屬性資料功能,使屬性資料更佳精準。

※請留意,選擇屬性後的目標好友數和群發訊息的發送量可能會有變動。

未來我們將持續新增與優化更多功能,敬請期待。

非常感謝您支持LINE官方帳號。

2020/06/22

已新增識別 Channel Access Token 的 Key ID

基於資安的原因,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。

預計會棄用的 Endpoint

由於此次的更新,我們預計於七月上旬建議勿用 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技術文件。

2020/06/10

Messaging API更新(2020年6月)

Messaging API 追加了新的 endpoint。以下為本次更新的功能:

Endpoint

新功能的敘述如下。若需了解更多細節,請查閱 Messaging API reference 中各個新功能的說明。

# 取得群組的資訊

當你的 LINE 官方帳號是群組的其中一員時,可取得的群組 ID、群組名稱以及群組圖示連結。

關於更多資訊,請查看Messaging API reference中的取得群組的資訊

# 取得群組裡的成員總數

取得群組中的成員總數。即使其中的成員尚未將LINE官方帳號加為好友,或是已將LINE官方帳號封鎖,您都可以取得群組成員的總數。

關於更多資訊,請查看Messaging API reference中的取得群組裡的成員總數

# 取得聊天室的成員總數

取得聊天室的成員總數。即使其中的成員未將LINE官方帳號加為好友,或是已將LINE官方帳號封鎖,您都可以取得聊天室成員的總數。

關於更多資訊,請查看Messaging API reference中的取得聊天室的成員總數

2020/06/09

Flex Message Simulator 的教學指南

我們發布了第一個關於使用Flex Message Simulator (opens new window)的教學指南。

遵循教學指南,您將能獲得關於使用Flex Message Simulator的實際操作經驗與知識。並且,在教學指南的最後,您將會使用Flex Message製作出如下方的出數位名片:

Final Output

我們鼓勵您把握這次機會去學習如何使用Flex Message Simulator並創造出屬於您獨特的 Flex Message。

2020/05/12

Messaging API更新(2020年5月)

我們對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 高度)
    無限制

# 從webhook event的message物件中取得LINE表情貼資訊

如果使用者傳送的文字中包含LINE表情貼,則在webhook接收到文字訊息物件時會包含emojis的屬性,相關資訊被歸納在LINE emoji物件當中。

LINE表情貼種類是由productIdemojiId來識別:

{
  "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部分。

# 安全地重新呼叫已失敗的API請求

如果在使用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/05/01

「受眾群體」(Audience)與「分析」(Insight)的部分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.uniqueImpressionmessages[].impression會有相關回傳值。

  • 訊息發送的時間(JST): 2020年4月30日 00:00:00~
    狀態:有限制。

    • 受眾群體已可以創建。但是,如果有使用者在這段時間內使用受限制的LINE版本開啟訊息,該使用者將無法接收到使用受眾群體所送出的新訊息。
    • 統計資料已可正常回傳。但是,統計資料中將不包含使用者在這段時間內利用受限制的LINE版本開啟訊息的次數。

關於更多資訊,請參考下方頁面:

我們將會持續改善我們向各位發開者提供的服務品質,並對於您的理解致上真誠的感謝。

2020/05/01

Messaging API服務中斷通知 (已修復)

我們必須通知您關於Messaging API近期發生的服務中斷問題。 所有由Messaging API提供的功能皆有可能受到影響。

這項問題目前已解決。Messaging API自下方的發生時間後已恢復正常運作。對於遲來的通知與此問題所造成的不便,我們致上誠摯的歉意。

# 發生時間

日期: 2020年4月24日

時間: 14:41-17:46 (GMT+9)

# 原因

網路故障

# 影響範圍

所有由Messaging API提供的功能皆有可能受到此問題影響。

LINE將會持續改善我們的服務品質以避免未來發生相關問題。感謝您的諒解。

2020/04/22

[更新] 關於 Audience 和 Insight 在一些集成式 API 中服務故障的問題

2020年5月1日更新

在 2020 年 4 月 22 日我們回報了此 API,目前已可在有限制的狀況下使用它。

關於更多訊息,請參考下方頁面:

Messaging API 發生了下列故障的問題。對此造成您的不便,我們致上誠摯的歉意。

# 發生時間

日期: 2020 年 4 月 13 日

時間:約 15:30~ (GMT+9) (持續中)

# 細節

在上述時間發生之後,無法準確計算出曝光再行銷的受眾群的曝光量。

因此我們暫時限制了部分功能的使用。整體來說,我們將會採取以下行動:

我們正積極的調查與修復此問題。

LINE 將會持續改善我們的服務品質以避免未來發生相關問題。感謝您的諒解。

2020/04/14

【更新】Messaging API升級(2020年4月)

2020年4月16日更新

2020年4月14日通知的下列Property名稱已變更。

變更前 變更後
sticon emojis
sticon.sticonId emojis.emojiId

Messaging API進行了下列改善。

# 利用文字訊息傳送LINE表情貼

利用Messaging API傳送文字訊息之際,可傳送Unicode定義的表情貼、LINE獨家定義的表情貼(不建議),現在更可傳送LINE表情貼了。

LINE表情貼以productIdemojiId指定。

// 含有LINE表情貼的文字訊息示例
{
    "type": "text",
    "text": "Look at this: $ It's a LINE emoji!",
    "emojis": [
        {
            "index": 14,
            "productId": "5ac1bfd5040ab15980c9b435",
            "emojiId": "001"
        }
    ]
}

詳情請參閱《Messaging API reference》的「文字訊息」。

# 取得用戶語言

取得個人資料端點,既存的用戶個人資料資訊會和languageProperty一起退回。

languageProperty僅會在下列任一情況下退回。

  • 用戶使用在日本建立的LINE帳號,且同意LINE 8.0.0版本之後的隱私權政策
  • 用戶使用在台灣、泰國,或印尼建立的LINE帳號,且同意LINE 8.9.0版本之後的隱私權政策

# Multicast的收訊人數限制已刪除

傳送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》的「速度制限」。

2020/04/06

Channel Access Token v2.1已上線

Channel Access Token的最新版本已上線。新版本除了能指定Token的有效期限之外,亦可用JSON Web Token(JWT)來取代Channel Secret強化安全性。

建議您使用Channel Access Token最新版本。

JWT的生成方法

可使用任意的JWT函式庫 (opens new window),亦可自己寫Code 由Assertion Signing Key生成JWT。生成JWT是發行Channel Access Token v2.1必要的手續。

# 新追加的API

關於現在可利用的Channel Access Token種類及其不同,請參閱《Messaging API Document》的「Channel Access Token」。

2020/03/30

新「訊息貼圖」的資源型態已新增至貼圖訊息的webhook事件

隨著LINE訊息貼圖 (可輸入客製化文字的貼圖)的推出,對用於通知貼圖訊息傳送的webhook事件,我們在其stickerResourceType屬性中新增了PER_STICKER_TEXT

如果一位LINE使用者向您的LINE官方帳號傳送了訊息貼圖,您將會收到一則包含PER_STICKER_TEXT stickerResourceType的webhook事件物件。

更多資訊請查看『Messaging API參考資料』中的貼圖


2020/03/26

LINE Beacon已中止於多個版本的服務

March 10, 2020所通知,LINE Beacon已不再適用於LINE的下列版本:

  • 日本: LINE 8.17.0之前的任何版本
  • 台灣: LINE 9.14.0之前的任何版本
  • 泰國: LINE 9.8.0之前的任何版本
  • 印尼: LINE 9.8.0之前的任何版本 (無異動)

# 影響

以上版本的使用者無論是進入或離開LINE Beacon的發送範圍,都將無法被偵測到。

  • Webhook Beacon事件將不會傳送給bot app。
  • 該當使用者將無法看到Beacon橫幅廣告。

更多關於LINE Beacon的資訊,請查看使用Beacons

對於這項改變可能造成的不便,我們致上誠摯的歉意。我們將會持續改善LINE的服務品質。感謝您的諒解。

2020/03/25

不建議使用LINE URL scheme '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功能』。


2020/03/19

提醒: Endpoint 網域名稱變更通知

如同 2019 年 11 月 8 日新聞所述,部分 Messaging API endpoint 的網域名稱 (domain name) 由 api.line.me 變更為 api-data.line.me.

# 變更網域名稱的 endpoint:

# 影響

使用以上 endpoint 的開發者,請於轉換期限前變更網域名稱。

轉換期結束後,使用以上 endpoint 的舊網域名稱將會顯示 404 錯誤訊息。

如造成任何不便,敬請見諒,感謝配合。

# 轉換期間

2019 年 11 月 8 日 起至 2020 年 4 月 30 日

2020/03/04

所有 Narrowcast 及 Audience Management 英文技術文件正式上線

介紹如何透過 Messaging API 發送 Narrowcast 訊息、管理受眾的英文技術文件,已全數上線。

最新英文文件:

之前翻譯為英文的文件 (請見新聞 2020 年 2 月 19 日):

上述 Narrowcast 及 Audience Management 功能的相關新聞:

2020/02/19

Messaging API narrowcast 英文技術文件正式上線

介紹如何透過 Messaging API 發送 narrowcast 訊息、管理受眾的 (部分) 英文技術文件正式上線:

部份文件仍為日文,近期內將翻譯為英文:

欲查看上述 Messaging API 功能的相關新聞,請至:

2020/02/03

受眾群體分享功能正式上線

現在,開發者可於 LINE Official Account Manager 和 LINE Ad,使用以 Messaging API 建立的受眾群體 (Audience)。

受眾群體協助更精準地將廣告訊息發送給真正感興趣的用戶,透過使用受眾群體,開發者可將訊息傳送給之前曾開啟訊息,或點擊訊息連結的用戶。

之前建立過的受眾群體,將自動顯示於 LINE Official Account Manager 和 LINE Ad 中,開發者不須更改任何設定。

如欲取得更多受眾群體相關訊息,請查看 Messaging API 技術文件中的 Using audiences


2020/01/08

[Updated] 請確認 provider 名稱正確

2020 年 1 月 9 日追加說明

本功能原訂於 2020 年 1 月 9 日上線,但因故改於 2020 年 1 月 16 日上線。

自 2020 年 1 月 16 日起,使用 Messaging API 的 LINE 官方帳號,將於用戶資料下方顯示開發者註冊的 provider 名稱。

企業 LINE 官方帳號亦可能將個人名稱註冊為 provider 名稱,請確認所註冊的名稱正確無誤。Provider 可於 LINE Developers Console 進行更改。

用戶資料

*Provider 名稱如紅框中所示

2019/12/17

Messaging API webhook event 新增屬性 "mode"

Messaging API webhook event 新增屬性 mode

modechannel multiplexing 功能的必要屬性 (開發中)。目前,所有 webhook event 皆包含 "mode": "active"

mode 的值不會自動切換為 standby。若 channel 管理者開始使用 channel multiplexing 功能,可選擇將 mode 的值更改為 standby

如欲取得更多 mode 屬性相關訊息,請查看 Messaging API reference - webhook events 中的 Common properties 內容。


2019/12/11

LINE Developers Console - channel statistics 資料顯示問題 (已解決)

之前由於不同系統的時差設定有異,LINE Developers Console 中 Messaging API channel Statistics 表單所顯示的部份日期,與 TSV 檔案中所顯示的不一致 (TSV 檔案可透過點選 Download as TSV 按鍵產生)。

當時此狀況僅影響日本標準時間 (JST) 以外時區的資料顯示,且不會刪除或損毀資料。

# 發生時間

2019/11/26~2019/12/18

目前,此問題已排除,開發者可重新取得正常顯示的資料。之前所造成的不便,敬請包涵!

2019/12/06

Beacon event 新增 stay event

Messaging API beacon event 新增 stay event,可指出用戶目前位於 beacon 所涵蓋的範圍內。

如欲使用 stay event,歡迎與 LINE for Business (opens new window) 團隊聯繫。


2019/12/05

Webhook event 新增屬性"貼圖訊息"

Webhook event 新增 stickerResourceType 屬性,開發者在收到貼圖訊息後,將可於訊息通知中取得此屬性。

開發者可透過此屬性,查看接收到的貼圖類型 (靜態貼圖、動態貼圖、動態有聲貼圖,或其他類型貼圖)。

如欲取得更多資訊,請至 Messaging API reference - Sticker 介紹。


2019/11/08

Endpoint 網域名稱變更通知

部分 Messaging API endpoint 的網域名稱 (domain name) 由 api.line.me 變更為 api-data.line.me,本次變更不包含任何 maintenance。

# 變更網域名稱的 endpoint:

# 影響

使用以上 endpoint 的開發者,請於轉換期限前變更網域名稱。如造成任何不便,敬請見諒,感謝配合。

轉換期結束後,使用以上 endpoint 的舊網域名稱將會顯示 404 錯誤訊息。

# 轉換期間

即日起至 2020 年 4 月 30 日

2019/10/16

最新 Messaging API endpoint 提供互動數據資料

最新 Messaging API endpoint 正式上線,提供詳細數據資料,協助開發者了解用戶與 LINE 官方帳號 (OA) 發送的訊息進行哪些互動。

此 endpoint 提供的數據資料,與 LINE Official Account manager (opens new window)Insight 表單所顯示的數據資料相同。