← บทความทั้งหมด
บทช่วยสอน

LINE Webhook หลายอีเวนต์: รับมือเมื่อบันทึกแบตช์สำเร็จเพียงบางส่วน

คำขอ webhook ของ LINE Messaging API หนึ่งครั้งอาจมีหลายอีเวนต์จากผู้ใช้ต่างคนกัน อย่าประมวลผลเฉพาะ events[0] อย่าผูกทั้งคำขอกับผู้ส่งคนแรก และอย่าตอบว่าสำเร็จหลังบันทึกได้เพียงบางส่วน ให้ตรวจสอบลายเซ็น บันทึกทุกอีเวนต์อย่างถาวร แล้วจึงตอบ 200 ใช้ webhookEventId ของแต่ละอีเวนต์ป้องกันการทำงานซ้ำเมื่อได้รับการส่งซ้ำ

ประเด็นสำคัญ

  • HTTP request หนึ่งรายการไม่ได้หมายถึงอีเวนต์ ผู้ใช้ หรือบทสนทนาเดียวเสมอไป
  • การตอบรับครอบคลุมทั้งคำขอ แต่ข้อมูลและสถานะการทำงานควรแยกเป็นรายอีเวนต์
  • deliveryContext.isRedelivery ใช้ประกอบการวิเคราะห์ ไม่ใช่คีย์ตรวจสอบข้อมูลซ้ำ
  • การส่งซ้ำของ LINE ไม่ใช่คลังประวัติที่รับประกัน และไม่ใช่กลไกลองใหม่ของ worker ในแอป

ทำไมการอ่านเฉพาะอีเวนต์แรกจึงทำให้งานตกหล่น

แนวทางการพัฒนาของ LINE ระบุชัดว่าอีเวนต์ข้อความของผู้ใช้ A และอีเวนต์ติดตามของผู้ใช้ B อาจอยู่ใน webhook เดียวกัน ส่วน Messaging API reference กำหนดโครงสร้างอาร์เรย์ events และออบเจ็กต์ภายใน

ขอบเขตความหมายสิ่งที่ไม่ควรทำ
HTTP requestการส่งที่กำลังตรวจสอบและตอบรับถือว่าอีเวนต์แรกสำเร็จเท่ากับทั้งหมดสำเร็จ
ออบเจ็กต์อีเวนต์อีเวนต์ที่มีประเภท แหล่งที่มา และ ID ของตนเองใช้ผู้ส่งหรือฟิลด์ข้อความของรายการแรกกับรายการอื่น

แยกเส้นทางตาม type และ source ของแต่ละอีเวนต์ อีเวนต์ติดตามไม่ใช่ข้อความที่ไม่มีเนื้อหา ส่วน destination ระดับบนระบุบอตผู้รับ ไม่ใช่ลูกค้าที่ทุกอีเวนต์ในคำขอนั้นเป็นของเขา

อาร์เรย์ว่างเป็นอีกกรณีหนึ่งที่ถูกต้องสำหรับการตรวจสอบการเชื่อมต่อ อ่าน คู่มือรับ events ว่าง สำหรับกรณีนั้น บทความนี้เน้นแบตช์ที่มีข้อมูลและเกิดความผิดพลาดระหว่างรับเข้า

ใช้การบันทึกครบทั้งแบตช์เป็นเงื่อนไขก่อนตอบรับ

ทำตาม คู่มือตรวจสอบลายเซ็นของ LINE โดยตรวจ x-line-signature จาก body เดิมด้วย channel secret แล้วจึงแปลง JSON ผูกคำขอกับการตั้งค่าช่องทางที่ใช้ตรวจลายเซ็น ไม่เลือกผู้เช่าระบบหรือลูกค้าจากอีเวนต์แรก

แนวทางที่แนะนำคือมีตารางรับอีเวนต์ในฐานข้อมูล:

  1. ตรวจโครงสร้างภายนอกและตัวระบุที่จำเป็นของทุกอีเวนต์
  2. บันทึกแต่ละอีเวนต์ใน transaction เดียว โดยใช้ขอบเขตช่องทางของแอปร่วมกับ webhookEventId เป็นคีย์ไม่ซ้ำ
  3. หากคีย์มีอยู่แล้ว ให้ถือว่ารับไว้แล้ว อย่าเขียนทับสถานะงานเดิมให้กลับเป็นงานรอทำ
  4. commit ก่อนตอบ 200 จากนั้นให้ worker อ่านแถวที่ commit แล้วไปทำงานที่ใช้เวลานาน

JavaScript ต่อไปนี้เป็นตัวอย่างขอบเขตการทำงานเท่านั้น inbox.transaction และ tx.insertIfAbsent เป็น abstraction ที่แอปต้องสร้างเอง ไม่ใช่เมธอดหรือ SDK ของ LINE ต้องใช้ transaction จริงและ unique constraint ส่วน channelKey มาจากการตั้งค่าตัวรับที่เชื่อถือได้ และอินพุตผ่านการตรวจลายเซ็นแล้ว

async function acceptVerifiedLineBatch(payload, channelKey, inbox) {
  if (!payload || !Array.isArray(payload.events)) {
    throw new Error('Invalid events array');
  }
  for (const event of payload.events) {
    if (!event || typeof event.webhookEventId !== 'string' ||
        event.webhookEventId.length === 0 ||
        typeof event.type !== 'string') {
      throw new Error('Invalid event envelope');
    }
  }

  await inbox.transaction(async (tx) => {
    for (const event of payload.events) {
      await tx.insertIfAbsent(channelKey, event.webhookEventId, event);
    }
  });
  return 200;
}

นี่ไม่ใช่ HTTP server ที่สมบูรณ์ ผู้เรียกต้องปฏิเสธลายเซ็นที่ไม่ถูกต้อง จัดการข้อผิดพลาดในการแปลงข้อมูล และไม่ตอบสำเร็จหากการตรวจสอบหรือ commit ล้มเหลว เมื่อระบบจัดเก็บขัดข้องชั่วคราว อาจเลือกตอบสถานะที่ไม่ใช่ 2xx เช่น 503 แต่เป็นนโยบายของแอป ไม่ใช่คำรับประกันว่า LINE จะกู้คืนได้ทุกอีเวนต์

อย่าเขียนลงตารางรับแล้วส่งเข้าคิวแยกกันโดยไม่มีระบบกู้คืน หากโปรเซสหยุดระหว่างสองขั้นตอน งานที่ตอบรับไปแล้วอาจไม่มี worker พบ ให้ worker อ่านจากตารางถาวรโดยตรง หรือใช้ transactional outbox ส่งต่องาน

กู้คืนความล้มเหลวบางส่วนโดยไม่ผูกกับตัวแบตช์

คู่มือรับข้อความของ LINE ระบุว่าอีเวนต์อาจซ้ำ และแนะนำให้ตรวจด้วย webhookEventId การส่งซ้ำคง event ID เดิมแต่เปลี่ยน deliveryContext.isRedelivery อย่าคาดว่ากลุ่มเดิมจะถูกส่งมาพร้อมกันอีก และอย่าใช้ hash ของ HTTP body ทั้งก้อนเป็นคีย์ป้องกันงานซ้ำ

สมมติว่าแบตช์มีอีเวนต์ A และ B:

จุดที่เกิดปัญหาผลลัพธ์ที่แนะนำ
transaction ล้มเหลวขณะบันทึก Brollback รายการใหม่และไม่ตอบรับว่าสำเร็จ
A ถูกบันทึกจากคำขอก่อนหน้าแล้วเก็บแถวเดิมของ A และยังรับ B
commit สำเร็จแต่ HTTP response หายID ที่ซ้ำพบแถวเดิม ไม่สร้างงานใหม่
worker ล้มเหลวหลังตอบ HTTP สำเร็จลองใหม่จากตารางของแอป ไม่รอ LINE ส่งอีก
ได้รับประเภทอีเวนต์ที่ถูกต้องแต่ยังไม่มีตัวประมวลผลบันทึกไว้ตรวจสอบอย่างควบคุม ไม่ทิ้งอีเวนต์ข้างเคียงเงียบ ๆ

หากระบบเดิม commit ทีละอีเวนต์ ให้รักษารายการที่บันทึกแล้วและตรวจซ้ำเมื่อได้รับอีกครั้ง อย่าทำเครื่องหมายว่าทั้งคำขอเสร็จแล้วเพียงเพราะ insert แรกสำเร็จ

การลองใหม่ของ worker ต้องมีมาตรการแยกต่างหาก การอัปเดต CRM หรือส่งคำตอบอาจสำเร็จแล้วก่อน worker บันทึกว่าเสร็จ เก็บผลลัพธ์ที่ยังไม่ทราบแน่ชัด และใช้ความสามารถด้าน idempotency ที่ปลายทางระบุไว้หากรองรับ สำหรับการตอบข้อความ อ่าน คู่มือกู้คืน reply token เพื่อเข้าใจว่าการรับอีเวนต์ซ้ำไม่ได้สร้างโอกาสตอบใหม่ที่เป็นอิสระ

แยกข้อจำกัดของ LINE ออกจากสัญญา UnifyPort

การส่งซ้ำของ LINE ต้องเปิดใช้งานฟีเจอร์และเกิดการตอบ webhook ที่ล้มเหลว LINE ไม่เปิดเผยจำนวนครั้งหรือช่วงเวลาลองใหม่ และระบุว่าการส่งซ้ำไม่รับประกันว่าจะส่งถึงอย่างแน่นอน ลำดับที่มาถึงอาจต่างจากลำดับที่เกิด ให้เก็บ timestamp เพื่อประกอบบริบท ไม่ใช้ตำแหน่งในแบตช์เป็นลำดับของทั้งระบบ

อินเทอร์เฟซที่ไม่เป็นทางการของ UnifyPort เป็นอีกเส้นทางหนึ่งสำหรับบัญชีรับส่งข้อความที่เชื่อมต่ออยู่ โครงสร้างอีเวนต์มาตรฐาน ใช้ id, type, provider, account_id, occurred_at และ data ไม่ใช่อาร์เรย์ events ของ LINE ส่วน สัญญาการส่ง webhook ใช้ X-Device-Signature เมื่อตั้ง signing_secret และถือว่า 2xx ทุกสถานะเป็นการตอบรับ

ใช้แนวคิดตารางถาวรร่วมกันได้ แต่ไม่ควรใช้ parser หรือสตริงลายเซ็นร่วมกัน การไม่มีฟิลด์ events ไม่ได้แปลว่าเป็นคำขอทดสอบที่มีอาร์เรย์ว่าง หากต้องใช้ตัวตนของ LINE Official Account ให้คงเส้นทาง Messaging API ทางการไว้ การเปลี่ยนระบบเชื่อมต่อไม่ใช่วิธีกู้คำขอที่รับได้เพียงบางส่วน

คำถามที่พบบ่อย

ตอบสำเร็จได้ไหมเมื่ออีเวนต์หนึ่งล้มเหลว?

ได้เฉพาะเมื่อรับทุกอีเวนต์ไว้ในที่จัดเก็บถาวรแล้ว และความล้มเหลวอยู่ที่ขั้นตอนต่อมาซึ่งระบบของคุณกู้คืนเองได้ หากยังมีอีเวนต์ที่ไม่ได้บันทึก อย่ารายงานว่ารับทั้งคำขอสำเร็จ

ควรทิ้งทุกอีเวนต์ที่เป็น isRedelivery หรือไม่?

ไม่ควร นั่นอาจเป็นสำเนาแรกที่คุณรับได้สำเร็จ ให้ตรวจจากบันทึกป้องกันข้อมูลซ้ำที่เก็บถาวร

Promise.all ทำให้แบตช์ปลอดภัยหรือไม่?

ไม่ การทำพร้อมกันยังสำเร็จเพียงบางส่วนได้ ความปลอดภัยมาจากการเก็บถาวร คีย์ไม่ซ้ำ และกลไกกู้คืน ไม่ใช่ตัวจัดตารางงานของ JavaScript

ขั้นตอนถัดไปและแหล่งอ้างอิง

ทดสอบแบตช์ที่มีหลายผู้ใช้ อีเวนต์เก่าปนใหม่ commit ล้มเหลว response หาย และ worker หยุดทำงาน ทั้งหมดนี้เป็นรายการทดสอบที่เสนอ ไม่ใช่ผลที่ได้ทดสอบแล้ว สำหรับตัวรับ UnifyPort แยกต่างหาก ให้เริ่มจาก เอกสารการส่ง webhook

ตรวจสอบแหล่งข้อมูลทางการเมื่อ 2026-11-13:

UnifyPort API

เปลี่ยนการเชื่อมต่อข้อความให้เป็น pipeline ผลิตภัณฑ์ที่เสถียร

เริ่มจากการส่งผ่าน API เดียว แล้วส่งข้อความขาเข้าทั้งหมดกลับสู่ระบบธุรกิจของคุณด้วย event มาตรฐาน