← 所有文章
教學

用 message.updated Webhook 處理 LINE 訊息編輯

LINE 在 2026 年 8 月 12 日為 Messaging API 新增編輯事件。用戶在包含 LINE 官方帳號的適用群組聊天室修改已傳送的文字訊息後，LINE 可以送出 messageEdited Webhook。共享收件箱不應新增第二則訊息，而應更新原訊息；在 UnifyPort 中，對應的標準事件是 message.updated，並以原本的 data.message.id 關聯。

重點

  • LINE 原生事件名稱是 messageEdited，UnifyPort 標準事件名稱是 message.updated。
  • 以訊息帳號、對話及 data.message.id 的組合定位原訊息。
  • 編輯是狀態變更，不應再次增加入站訊息數量。
  • 先驗證 HMAC-SHA256 簽署，再解析及寫入資料。
  • 能接收 LINE 編輯事件，不代表可透過 UnifyPort 主動編輯 LINE 訊息。

LINE 群組聊天室有甚麼變化

LINE 的官方 Messaging API 新聞頁記錄了 2026 年 8 月 12 日的更新：用戶可在包含 LINE 官方帳號的群組聊天室編輯訊息，Messaging API 的 Webhook 事件物件亦新增 messageEdited。現時的官方 API Reference已把 Edit event 列入 Webhook 事件物件。

這項改動會影響共享收件箱、CRM 時間線、搜尋索引及 AI 上下文。客戶若更正訂單編號、地址或問題，而系統仍保存舊文字，後續自動化可能繼續處理過期資料；若把編輯內容插入成新訊息，又會造成重複計數，時間線亦會與 LINE 不一致。

正確的資料模型是：同一則平台訊息發生一次狀態更新。

LINE messageEdited 與 UnifyPort message.updated

LINE 官方載荷採用平台專屬結構。UnifyPort 將更新放入統一事件信封，讓同一個處理器接收不同平台的訊息編輯：

{
  "id": "evt_7f42c18a9d",
  "type": "message.updated",
  "provider": "line",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-08-22T09:15:30Z",
  "data": {
    "conversation": {
      "id": "c8f2a4d91e",
      "type": "group",
      "title": "訂單支援"
    },
    "sender": {
      "id": "u71b9d420f",
      "type": "user",
      "name": "Jordan Lee"
    },
    "message": {
      "id": "551842037194",
      "text": "更正：訂單編號是 A1234。",
      "direction": "inbound",
      "sent_at": "2026-08-22T09:12:04Z"
    },
    "event": {
      "kind": "message_updated"
    }
  }
}

兩個 ID 用途不同：

  • 頂層 id 標識這次 Webhook 事件，可用來排除重複投遞。
  • data.message.id 標識被修改的原訊息。

可在各平台 Webhook 標準事件差異核對現有能力矩陣。矩陣列出 LINE 對 message.updated 的支援，但實際欄位仍可能受上游帳號及部署情況影響。

避免建立重複訊息的合併流程

不要假設平台訊息 ID 在全域唯一，建議使用組合鍵：

(account_id, conversation_id, provider_message_id)

然後把編輯視為冪等狀態更新：

  1. 驗證原始請求內容的簽署。
  2. 以 Webhook 事件 ID 排除重複投遞。
  3. 用 account_id、data.conversation.id 及 data.message.id 查找原訊息。
  4. 以 data.message.text 取代目前文字。
  5. 將 occurred_at 保存為觀察到編輯的時間。
  6. 保留最初接收時間；如有稽核要求，另存內部修訂紀錄。
  7. 資料持久化成功後才回傳 2xx。

以下是精簡的 Express 處理器，資料庫方法保持抽象，讓真實事件欄位更清楚：

import crypto from 'crypto';
import express from 'express';

const app = express();
const secret = process.env.WEBHOOK_SIGNING_SECRET;

app.post('/webhook', express.raw({ type: 'application/json' }), async (req, res) => {
  const timestamp = req.get('X-Device-Timestamp') || '';
  const signature = req.get('X-Device-Signature') || '';
  const expected = crypto.createHmac('sha256', secret)
    .update(timestamp + '.')
    .update(req.body)
    .digest('hex');

  const valid = signature.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
  if (!valid) return res.sendStatus(401);

  const event = JSON.parse(req.body.toString('utf8'));
  if (await db.hasWebhookEvent(event.id)) return res.sendStatus(200);

  if (event.type === 'message.updated') {
    await db.applyMessageEdit({
      accountId: event.account_id,
      conversationId: event.data.conversation.id,
      messageId: event.data.message.id,
      text: event.data.message.text,
      editedAt: event.occurred_at
    });
  }

  await db.rememberWebhookEvent(event.id);
  return res.sendStatus(200);
});

簽署字串、重試條件及事件順序注意事項可查看Webhook 投遞與簽署文件。如需深入處理時間戳及冪等性，可閱讀Webhook HMAC 重送防護教學。

原訊息缺少或事件次序顛倒時

Webhook 不保證投遞次序。編輯事件可能比原訊息更早完成寫入；接收器離線時，亦可能漏掉原訊息。這時不要立即建立一般時間線項目，也不要增加入站統計。

較穩妥的做法，是先將更新暫存在以組合訊息識別值為鍵的短期資料表。收到原始 message.received 後，先套用待處理文字，再顯示給客服。若原訊息一直沒有到達，應把紀錄標示為「不完整的編輯觀察」，交由人員檢查，而不是當成完整訊息呈現。

表情回應也適用相同的狀態思維。可參考如何在統一 Webhook 中處理訊息回應，區分「事件」與「被事件改變的訊息狀態」。

UnifyPort 的適用範圍與限制

小型團隊若同時接收 LINE、WhatsApp、Telegram、TikTok、Zalo 或 X，並希望下游只維護一種已簽署事件格式，UnifyPort 的非官方介面可以減少各平台專用解析器。處理器只需針對 message.updated 分支。

若系統以 LINE 官方帳號為中心，並需要 LINE 原生能力或原始平台載荷，官方 Messaging API 仍較合適。也要留意目前的動作邊界：UnifyPort 可標準化收到的 LINE 訊息更新，但目前不支援透過 POST /v1/messages/edit 主動編輯 LINE 訊息。接收編輯與發起編輯是兩種不同能力。

常見問題

LINE messageEdited 是甚麼？

它是 LINE Messaging API 針對適用訊息編輯提供的官方 Webhook 事件。LINE 於 2026 年 8 月 12 日宣布，此事件可用於包含 LINE 官方帳號的群組聊天室。

UnifyPort 應訂閱哪個事件名稱？

訂閱 message.updated。若端點確實要接收所有公開標準事件，也可使用 "*"；正式環境的精確篩選應採完整事件名稱。

編輯後的 LINE 訊息要建立新收件箱項目嗎？

不需要。請用 data.message.id 找到並更新原訊息；如有稽核要求，再另外保存修訂紀錄。

可以透過 UnifyPort 編輯 LINE 訊息嗎？

目前不可以。現有平台動作矩陣未列出 LINE 對主動編輯動作的支援。本文只處理接收及合併編輯事件。

下一步

先核對各平台 Webhook 事件矩陣，把 message.updated 加入訂閱，並在正式共享收件箱啟用前測試冪等更新及事件亂序流程。

官方來源

核對日期：2026 年 8 月 22 日。

UnifyPort API

令訊息接入變成一條穩定嘅產品管線。

先用統一嘅 API 跑通發送，再用標準事件將所有入站訊息接返去業務系統。

攞 API Key睇 API 參考