เช็กลิสต์อัปเกรด Telegram Bot API 10.2: มีเดีย Rich Messages, แก้ไข Ephemeral และ Communities

Telegram เปิดตัว Bot API 10.2 เมื่อวันที่ 14 กรกฎาคม 2026 และขอบเขตการเปลี่ยนแปลงใหญ่กว่าที่หมายเลขเวอร์ชันสื่อ Rich Messages เพิ่มมีเดียและตัวสร้างระดับบล็อก ephemeral ได้ชุดเมธอดแก้ไข/ลบครบถ้วน และ Communities เพิ่มโทโพโลยีใหม่ที่ต้องจัดเก็บ สำหรับทีมที่ทำงานหลายแพลตฟอร์ม เส้นทางปลอดภัยคือผ่านเช็กลิสต์ก่อนปรับใช้งาน ตรึงเวอร์ชัน ย้ายเมธอดที่ได้รับผลกระทบ และคงการทำให้ข้อความเข้าเป็นมาตรฐานบน webhook เดียวก่อนแตะบอทในระบบจริง

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

• 10.2 เปิดตัวเมื่อ 14 กรกฎาคม 2026 เพิ่ม media ของ rich message, ชุดตัวสร้าง InputRichBlock*, เมธอดแก้ไข/ลบ ephemeral และข้อความวงจรชีวิต Communities ทั้งหมดอยู่ในเอกสารทางการของ core.telegram.org
• สามการเปลี่ยนแปลงใกล้เคียง breaking ต้องตรวจสอบโค้ด ได้แก่ ฟิลด์ media/blocks ใหม่บน InputRichMessage, พารามิเตอร์ receiver_user_id/ephemeral_message_id บนหลายเมธอด send* และประเภทข้อความ community_chat_added/community_chat_removed
• Rich Messages เป็นขาออกเท่านั้นใน Bot API ทางการ ข้อความเข้าจากผู้ใช้ยังคงมาถึงเป็นข้อความธรรมดา/มาร์กดาวน์ สายงานรับของคุณไม่จำเป็นต้องแยกวิเคราะห์ rich block เว้นแต่คุณสร้าง UI แบบริชขึ้นมาเอง
• Communities เพิ่มสถานะการกำหนดเส้นทาง ไม่ใช่การรวมข้อความ Community เชื่อมหลาย supergroup, channel และบอทเข้าด้วยกัน ข้อความยังคงอยู่กับ chat ID เดิมและต้องกำหนดเส้นทางตาม chat
• อัปเกรดหลัง feature flag และยืนยันว่าไลบรารี Bot API ของคุณออกเวอร์ชันที่รองรับ 10.2 ก่อนส่งการจราจรระบบจริงไปที่มัน

สิ่งที่ Bot API 10.2 เปลี่ยนจริง

ต่อไปนี้คือส่วนเพิ่มทีละคำจาก changelog Bot API ทางการ จัดกลุ่มตามพื้นที่ที่ทีมต้องลงมือจริง

Rich Messages: มีเดียและตัวสร้างบล็อก

10.1 เปิดตัว Rich Messages ข้อความที่มีโครงสร้าง สตรีม AI ได้และจัดรูปแบบ 10.2 ทำให้รองรับเนื้อหาจริง:

• เพิ่มคลาส InputRichMessageMedia และฟิลด์ media บน InputRichMessage เพื่อให้บอท “ระบุมีเดียที่ใช้ในการจัดรูปแบบ markdown หรือ html อย่างชัดเจนเมื่อส่ง rich message”
• เพิ่มคลาส InputMediaVoiceNote
• เพิ่ม InputRichBlockListItem และชุดคลาสบล็อกขาเข้าครบถ้วน: InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote, InputRichBlockThinking
• เพิ่มฟิลด์ blocks บน InputRichMessage ให้บอท “ระบุการจัดรูปแบบ rich message ผ่านเอนทิตีบล็อก”

ผลลัพธ์ในทางปฏิบัติ: หาก 10.1 ให้คุณ ส่ง rich message ได้ 10.2 ให้คุณประกอบมันจากบล็อกแบบมีชนิดและแนบมีเดีย โค้ดใดที่สร้าง InputRichMessage เป็น literal ควรตรวจสอบใหม่ทั้งหมด เพราะหลังอัปเกรดไลบรารีอาจคาดหวัง blocks แทนสตริงอินไลน์

Ephemeral: วงจรชีวิตแก้ไข/ลบครบถ้วน

ข้อความ ephemeral (ข้อความกลุ่มที่มองเห็นได้เฉพาะผู้ใช้คนเดียวและบอท) ปรากฏก่อนหน้านี้เช่นกัน แต่ 10.2 เติมชุดเมธอดให้ครบ:

• เพิ่ม is_ephemeral ใน BotCommand
• เพิ่ม receiver_user และ ephemeral_message_id ในคลาส Message
• เพิ่มพารามิเตอร์ receiver_user_id และ callback_query_id ใน sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue
• เพิ่ม ephemeral_message_id ใน ReplyParameters (และทำให้ message_id เป็นทางเลือกเมื่อมันอยู่)
• เพิ่ม editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage

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

Communities: ประเภทข้อความใหม่

Communities คือ “supergroup, channel และบอทหลายรายการที่เชื่อมโยงกันรอบหัวข้อหรือผู้ฟังร่วมกัน” สำหรับผู้บริโภค webhook ส่วนเพิ่มหลักคือ:

• คลาส Community
• คลาสข้อความ CommunityChatAdded และ CommunityChatRemoved พร้อมฟิลด์ของพวกมันบน Message
• ฟิลด์ community บน ChatFullInfo

ข้อความวงจรชีวิตเหล่านี้เป็นอินเทอร์เฟซเดียวกับที่อธิบายใน คู่มือการจัดการเหตุการณ์ Communities สำหรับเช็กลิสต์อัปเกรด กฎง่ายกว่าคือ ถ้าคำสั่ง switch ของคุณใช้ message.text เป็นคีย์และตกไปที่สาขาเริ่มต้นเมื่อเจอประเภทที่ไม่รู้จัก community_chat_added/community_chat_removed จะถูกทิ้งโดยเงียบ จัดการพวกมันอย่างชัดเจนเพื่อบันทึกการเปลี่ยนแปลงโทโพโลยีของ Community

ทั่วไป

• เพิ่ม BotSubscriptionUpdated (และฟิลด์ subscription บน Update) สำหรับการเปลี่ยนแปลงการสมัครสมาชิกการชำระเงินของผู้ใช้
• เสริมความปลอดภัย Mini App: ห้ามการเรียกเมธอดจากต้นทางที่ต่างกัน เปิดใช้งานอัตโนมัติตั้งแต่ 20 กรกฎาคม 2026 (เลือกไม่รับได้ใน BotFather)

เช็กลิสต์อัปเกรด

ทำรายการเหล่านี้ให้เสร็จก่อนส่งการจราจรไปยังบอท 10.2

ลำดับ	การกระทำ	เหตุผลที่สำคัญ
1	ตรึงไลบรารี Bot API ที่เวอร์ชันรองรับ 10.2 (เช่น Telegram.BotAPI 10.2.0 บน .NET)	ไคลเอนต์เก่าหรือไม่มีชนิดจะละเว้นฟิลด์ใหม่และส่งข้อความที่ด้อยลงโดยเงียบ
2	ตรวจสอบโครงสร้าง sendRichMessage / InputRichMessage ทุกแห่ง	ฟิลด์ media และ blocks ใหม่เปลี่ยนวิธีประกอบ rich message
3	เพิ่ม community_chat_added / community_chat_removed ในตัวจัดการข้อความ	ประเภทข้อความที่ไม่รู้จักตกไปสาขาเริ่มต้นและสูญหาย
4	ตัดสินใจว่าจะรับเมธอดแก้ไข/ลบ ephemeral ใหม่หรือไม่	ให้บอทซัพพอร์ตแก้ไขการตอบกลับส่วนตัวโดยไม่ต้องส่งใหม่
5	จัดเก็บ community จาก ChatFullInfo ในเมตาดาต้าของ chat	จำเป็นเพื่ออนุมานโทโพโลยีของ Community ในภายหลัง
6	ทดสอบการจัดการต้นทางของ Mini App ก่อน 20 กรกฎาคม 2026	ตั้งแต่วันนี้การเรียกข้ามต้นทางเริ่มถูกบล็อก
7	คงการทำให้ข้อความเข้าเป็นมาตรฐานบน webhook เดียว	Rich block เป็นขาออกเท่านั้น ข้อความเข้ายังคงมาเป็นข้อความธรรมดา

สิ่งที่ 10.2 ไม่เปลี่ยนสำหรับทีมขาเข้า

สิ่งที่ “ไม่เปลี่ยนแปลง” ที่สำคัญที่สุดคือ ข้อความเข้าจากผู้ใช้ยังคงมาถึงเป็นข้อความธรรมดา เมื่อผู้ใช้พิมพ์ในแชต Telegram ออบเจกต์ RichMessage จะไม่ถูกสร้างขึ้นฝั่งคุณ Rich Messages เป็นความสามารถที่ บอทส่ง นี่คือบทสรุปเดียวกับจาก การวิเคราะห์ Bot API 10.1 ก่อนหน้านี้ ปัญหาของขาเข้าคือการทำให้รูปแบบเป็นมาตรฐานข้ามแพลตฟอร์ม ไม่ใช่การแยกวิเคราะห์ rich block

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

ตำแหน่งของ UnifyPort

UnifyPort ส่งมอบข้อความ Telegram ขาเข้า (พร้อมด้วย WhatsApp, LINE, X, Zalo และ TikTok) เป็นสตรีมเหตุการณ์ message.received ที่ทำเป็นมาตรฐานเดียว ดังนั้นส่วนขาเข้าของการอัปเกรด 10.2 รับข้อความของผู้ใช้ ตรวจสอบลายเซ็น HMAC-SHA256 และกำหนดเส้นทางตามการสนทนา ยังคงไม่เปลี่ยนแปลงไม่ว่าเวอร์ชัน Bot API จะเป็นอย่างไร

แคตตาล็อกเหตุการณ์ webhook มีเสถียรภาพ: message.received, message.updated, message.deleted, message.read, message.reaction บวกเหตุการณ์วงจรชีวิตการสนทนาและบัญชี การส่งมอบแต่ละครั้งมี X-Device-Event-Id, X-Device-Delivery-Id, X-Device-Timestamp และ X-Device-Signature แบบเฮ็กซ์ (HMAC-SHA256 ของ "<เวลา>" + "." + "<เนื้อหาดิบ>") เมื่อ endpoint มี signing_secret คุณตรวจสอบด้วยเนื้อหาดิบ แยกวิเคราะห์ JSON และแตกสาขาตาม event.type กระบวนการตรวจสอบที่แน่นอนอยู่ใน คู่มือการส่งมอบและลายเซ็น webhook

หากเป้าหมายการอัปเกรดของคุณเป็นเพียงความน่าเชื่อถือของขาเข้าข้ามแพลตฟอร์ม คุณไม่จำเป็นต้องแตะ Bot API ทางการเลย หากคุณ พร้อมกัน ต้องการส่งการตอบกลับ rich หรือ ephemeral จากโค้ดบอท Telegram ของคุณเอง นั่นคือจุดที่การเปลี่ยนแปลงของ 10.2 มีผล การอนุญาต Telegram ของ UnifyPort อธิบายโฟลว์ api_id / api_hash / เบอร์โทรศัพท์ที่จำเป็นเพื่อเชื่อมต่อบัญชี

ข้อจำกัดและการแลกเปลี่ยน

• Rich Messages ต้องการไคลเอนต์ที่รองรับ ไคลเอนต์ Telegram รุ่นเก่ามากอาจไม่แสดง rich block ให้ออกแบบทางเลือกสำรองเป็นข้อความธรรมดา
• ข้อความ ephemeral ต้องการสิทธิผู้ดูแลกลุ่ม และเข้าถึงผู้ใช้ได้คนเดียว ไม่ใช่เครื่องมือกระจายข้อความ
• Communities เป็นฟีเจอร์ใหม่และยังพัฒนาอยู่ อย่าสมมติว่าการรวบรวมข้อความระดับ Community มีอยู่แล้ววันนี้ กำหนดเส้นทางตาม chat ID และจัดเก็บโทโพโลยีเมื่อมาถึง
• Bot API ทางการยังคงเป็นแพลตฟอร์มเดียว หากทีมของคุณจัดการขาเข้าของ WhatsApp, LINE หรือ X ด้วย การรับ 10.2 แก้เฉพาะด้าน Telegram ปัญหาขาเข้าข้ามแพลตฟอร์มต้องจัดการแยกต่างหาก

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

Bot API 10.2 เปิดตัวเมื่อไร?

Telegram เปิดตัว Bot API 10.2 เมื่อ วันที่ 14 กรกฎาคม 2026 ตาม changelog ทางการที่ core.telegram.org/bots/api-changelog ส่วนเพิ่มหลักคือมีเดียและตัวสร้างบล็อกของ Rich Message ชุดเมธอดแก้ไข/ลบ ephemeral ที่ครบถ้วน และ Communities

ฉันต้องอัปเกรดทันทีไหม?

ไม่มีกำหนดเส้นตายบังคับให้อัปเกรดฟังก์ชันรับ รายการเดียวที่มีกรอบเวลาคือการบังคับตรวจต้นทางของ Mini App ตั้งแต่ วันที่ 20 กรกฎาคม 2026 หากคุณใช้ Mini App ให้ทดสอบพฤติกรรมข้ามต้นทางก่อนวันนั้น

รูปแบบข้อความขาเข้าจะเปลี่ยนหลัง 10.2 ไหม?

ไม่ Rich Messages เป็นความสามารถขาออกของบอท ข้อความเข้าจากผู้ใช้ยังคงมาถึงเป็นข้อความธรรมดาหรือมาร์กดาวน์ ดังนั้นตัวแยกวิเคราะห์ขาเข้าของคุณไม่จำเป็นต้องรองรับ rich block

Communities เหมือนกับแชตกลุ่มไหม?

ไม่ใช่ Community คือชุดของ supergroup, channel และบอทที่เชื่อมโยงกัน ข้อความยังคงอยู่กับแชตเดิม และคุณกำหนดเส้นทางและจัดเก็บตาม chat ID ประเภทข้อความ community_chat_added และ community_chat_removed ใหม่ใช้ติดตามการเปลี่ยนแปลงโทโพโลยี

UnifyPort รับเหตุการณ์วงจรชีวิต Community ของ Telegram ได้ไหม?

UnifyPort ส่งมอบ Telegram ขาเข้าเป็นเหตุการณ์ message.* ที่ทำเป็นมาตรฐานและเหตุการณ์วงจรชีวิตบน webhook รวม สำหรับเหตุการณ์โทโพโลยีเฉพาะของ Community ให้จัดการตามวิธีที่ คู่มือเหตุการณ์ Communities อธิบาย คงฟิลด์ service-message ไว้และกระทบยอดด้วย getChat

ขั้นตอนถัดไป

• ตรวจทานแคตตาล็อกเหตุการณ์ webhook เพื่อยืนยันว่าตัวจัดการขาเข้าของคุณครอบคลุมเหตุการณ์ message.* มาตรฐานแล้ว ดูได้ที่ อ้างอิง provider message support
• หากคุณเชื่อมต่อบัญชี Telegram เป็นครั้งแรก Quickstart จะพาคุณส่งและรับข้อความแรก

แหล่งข้อมูล

• Changelog Telegram Bot API (ทางการ): https://core.telegram.org/bots/api-changelog — Bot API 10.2, 14-07-2026. ตรวจสอบเมื่อ 30-07-2026.
• อ้างอิง Telegram Bot API (ทางการ): https://core.telegram.org/bots/api. ตรวจสอบเมื่อ 30-07-2026.