ฟังก์ชันสำหรับส่งไฟล์แนบในข้อความ

02-01-2026

ในหน้านี้

วิธีส่งเอกสาร

ส่งเอกสาร tg_send_document()

! ฟังก์ชันเหล่านี้ช่วยให้คุณส่งไฟล์ทุกประเภทได้ รูปแบบที่แนะนำ: GIF, PDF, ZIP สูงสุด 2GB

! ทำงานกับบัญชีธุรกิจ Telegram

tg_send_document(platform_id, document, caption, reply_markup, parse_mode,reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

พารามิเตอร์:

! platform_id — ตัวระบุไคลเอนต์ใน Telegram ที่จะส่งข้อความไป *

! document - ลิงก์ไปยังเอกสารบนเซิร์ฟเวอร์ของ Telegram การรับลิงก์ผ่าน tg_request อธิบายไว้ ที่นี่

caption - คำอธิบาย สูงสุด 1024 ตัวอักษร

reply_markup — การตั้งค่าปุ่ม **

parse_mode — การจัดรูปแบบข้อความในคำอธิบาย (ตัวหนาหรือตัวเอียง) ***. ค่าที่เป็นไปได้: html, markdown, markdownV2. ลิงก์

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

protect_content — แฟล็กเพื่อป้องกันเนื้อหาจากการคัดลอก หากต้องการเปิดใช้งาน ให้ส่งค่าใดๆ ที่ไม่ใช่ 0, False หรือเครื่องหมายคำพูดว่าง ''

disable_notification — แฟล็กเพื่อควบคุมการแจ้งเตือนด้วยเสียง (ค่าเริ่มต้น: 0)
1 - ส่งโดยไม่มีการแจ้งเตือน, 0 - ส่งพร้อมการแจ้งเตือน

message_thread_id — ตัวระบุเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

entities — ให้คุณใช้ข้อความที่จัดรูปแบบไว้ล่วงหน้าพร้อมสไตล์ได้ เพียงกำหนดออฟเซ็ตของอักขระและช่วงสำหรับการจัดรูปแบบ ตัวอย่างมีอยู่ใน tg_request ภายใต้ฟิลด์ที่เกี่ยวข้อง ต้องเป็นพจนานุกรม

ตัวอย่างการส่งพารามิเตอร์:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

ในตัวอย่างนี้ แสดงเฉพาะพจนานุกรม ในขณะที่ข้อความจริงถูกกำหนดในตัวแปรแยกต่างหาก

เพื่อให้การอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ เคล็ดลับ ต่อไปนี้

ส่งเอกสารหลายรายการหรือไฟล์อื่นๆ tg_send_some_document()

tg_send_some_document(platform_id, document_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

พารามิเตอร์:

! platform_id — ตัวระบุไคลเอนต์ใน Telegram ที่จะส่งข้อความไป *

! document_list - อาร์เรย์ของเอกสาร ตัวอย่างการสร้างอาร์เรย์ดังกล่าวมีให้ด้านล่าง

protect_content — แฟล็กสำหรับป้องกันเนื้อหาจากการคัดลอก หากต้องการเปิดใช้งาน ให้ส่งค่าใดๆ ที่ไม่ใช่ 0, False หรือเครื่องหมายคำพูดว่าง ''

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

message_thread_id — ตัวระบุเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

ตัวอย่างการสร้างอาร์เรย์ document_list:
'[["ลิงก์เอกสาร", "คำอธิบาย", "parse_mode"], ["ลิงก์เอกสาร 2"], ["ลิงก์เอกสาร 3", "คำอธิบาย"]]'

ตัวอย่างการจัดรูปแบบข้อมูลสำหรับเอกสารเดียว
["ลิงก์เอกสาร", "คำอธิบาย", "parse_mode"]

ลำดับของพารามิเตอร์สำคัญ! เมื่อสร้างอาร์เรย์ของเอกสาร สามารถละเครื่องหมายคำพูด " " ได้

คำอธิบายพารามิเตอร์สำหรับอาร์เรย์ document_list:
! ลิงก์เอกสาร - ลิงก์เอกสารจากเซิร์ฟเวอร์ Telegram การรับลิงก์ผ่าน tg_request อธิบายไว้ ที่นี่
caption — คำอธิบายสูงสุด 1024 ตัวอักษร
parse_mode — การจัดรูปแบบคำอธิบาย เช่น การเน้นข้อความด้วยตัวหนาหรือตัวเอียง ***

ตัวอย่าง

มาดูตัวอย่างการส่งเอกสารเดียว เพิ่มปุ่มอินไลน์และคำอธิบายให้กับเอกสาร:

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

ตอนนี้มาดูการส่งเอกสารหลายรายการ

เช่นกัน คุณต้องได้รับลิงก์ภายใน Telegram สำหรับแต่ละเอกสารและสร้างอาร์เรย์
lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
สุดท้าย ประกอบฟังก์ชันสำหรับส่งเอกสาร:

และตรวจสอบผลลัพธ์:

ตัวอย่างโค้ดสำหรับคัดลอก

จำไว้ว่าลิงก์ไม่ซ้ำกันสำหรับแต่ละบอท ดังนั้นโปรดสร้างลิงก์ของคุณเอง

ตัวอย่างโค้ดสำหรับส่งเอกสารเดียว:

lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "Excellent","callback_data":"Answer1"}, {"text": "Not accepted","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Document sending", opts)

ตัวอย่างโค้ดสำหรับส่งเอกสารหลายรายการ:

lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)

วิธีส่งเสียง / ข้อความเสียง

ส่งข้อความเสียง tg_send_voice()

! ฟังก์ชันนี้ช่วยให้ส่งไฟล์เสียงประเภท .OGG ที่เข้ารหัสด้วย OPUS ได้สูงสุดถึง 2 GB

! ทำงานกับบัญชีธุรกิจ Telegram เท่านั้น

tg_send_voice(platform_id, voice, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

พารามิเตอร์:

! platform_id — ตัวระบุไคลเอนต์ใน Telegram ที่จะส่งข้อความไป *

! voice - ลิงก์ไปยังข้อความเสียงในรูปแบบ .OGG

caption - คำอธิบายสูงสุด 1024 ตัวอักษร

reply_markup — การตั้งค่าปุ่ม **

parse_mode — การจัดรูปแบบข้อความในคำอธิบาย ตัวหนาหรือตัวเอียง ***. ค่าที่เป็นไปได้: html, markdown, markdownV2.

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

protect_content — แฟล็กสำหรับป้องกันเนื้อหาจากการถูกคัดลอก หากต้องการเปิดใช้งาน ให้ส่งค่าใดๆ ยกเว้น 0, False หรือเครื่องหมายคำพูดว่าง ''

disable_notification — แฟล็กสำหรับส่งข้อความพร้อมการแจ้งเตือนด้วยเสียง (ค่าเริ่มต้นคือ 0) 1 - ปิดการแจ้งเตือนเมื่อได้รับ, 0 - ส่งพร้อมการแจ้งเตือน

message_thread_id — ตัวระบุหัวข้อ (ใช้ได้ในซูเปอร์กรุ๊ปหากเปิดใช้งานฟีเจอร์ฟอรัม)

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

ตัวอย่างการส่งพารามิเตอร์:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

ตัวอย่างแสดงเฉพาะพจนานุกรม ในขณะที่ข้อความถูกกำหนดในตัวแปร

เพื่อให้การอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ เคล็ดลับ ต่อไปนี้

ส่งข้อความเสียงหลายรายการ tg_send_some_audio()

! ฟังก์ชันนี้ช่วยให้ส่งไฟล์เสียงประเภท .MP3 หรือ .M4A ได้สูงสุด 2GB

! ทำงานกับบัญชีธุรกิจ Telegram

tg_send_some_audio(platform_id, audio_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

พารามิเตอร์:

! platform_id — ตัวระบุไคลเอนต์ใน Telegram ที่จะส่งข้อความไป *

! audio_list - อาร์เรย์ของไฟล์เสียง (รายละเอียดด้านล่าง)

disable_notification — แฟล็กสำหรับส่งข้อความโดยมีหรือไม่มีการแจ้งเตือนด้วยเสียง (ค่าเริ่มต้น: 0) 1 — ส่งโดยไม่มีการแจ้งเตือน, 0 — ส่งพร้อมการแจ้งเตือน

protect_content — แฟล็กเพื่อป้องกันเนื้อหาจากการคัดลอก หากต้องการเปิดใช้งาน ให้ส่งค่าใดๆ ยกเว้น 0, False หรือเครื่องหมายคำพูดว่าง ''

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

message_thread_id — ID หัวข้อ (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

ตัวอย่างการสร้างอาร์เรย์ audio_list:
'[["ลิงก์เสียง 1", "คำอธิบาย", "parse_mode"], ["ลิงก์เสียง 2"], ["ลิงก์เสียง 3", "คำอธิบาย"]]'

ตัวอย่างของเสียงเดียว:
["ลิงก์เสียง", "คำอธิบาย", "parse_mode"]

ลำดับของพารามิเตอร์สำคัญ! เมื่อสร้างอาร์เรย์ของไฟล์เสียง สามารถละเครื่องหมายคำพูด "" ได้

คำอธิบายพารามิเตอร์:
! ลิงก์เสียง - ลิงก์ไปยังไฟล์เสียงในรูปแบบ .OGG
caption — คำอธิบาย (สูงสุด 1024 ตัวอักษร)
parse_mode — การจัดรูปแบบข้อความในคำอธิบาย ตัวหนาหรือตัวเอียง ***

ตัวอย่าง

ตามที่กล่าวไว้ข้างต้น ฟังก์ชันทำงานกับไฟล์ .OGG ดังนั้น ภารกิจแรกคือการได้รับการบันทึกเสียงในรูปแบบนี้
หากคุณมีไฟล์ .MP3 คุณสามารถแปลงเป็น .OGG โดยใช้บอท https://t.me/mp3toolsbot

จากนั้น ส่งไฟล์ผลลัพธ์ให้ตัวเองในบอทเพื่อรับ file_id ตามอัลกอริทึม ที่อธิบายไว้ที่นี่

ตอนนี้ประกอบฟังก์ชัน:

เยี่ยม! ทำได้ดีมาก!

ตัวอย่างสำหรับคัดลอก

tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")

ข้อผิดพลาดเมื่อส่งข้อความเสียง

หากข้อความไม่สามารถส่งได้เนื่องจากการตั้งค่าความเป็นส่วนตัว ข้อผิดพลาดต่อไปนี้จะถูกส่งกลับ:

{"ok":false,"error_code":400,"description":"Bad Request: user restricted receiving of voice messages"}

สาเหตุของข้อผิดพลาด: การตั้งค่าความเป็นส่วนตัวของผู้ใช้มีตัวเลือก "ไม่รับข้อความเสียง" (จากทุกคน หรืออนุญาตเฉพาะผู้ใช้บางคน):

แม้ว่าผู้ใช้จะปิดการจำกัดความเป็นส่วนตัวนี้ ข้อผิดพลาดจะยังคงปรากฏต่อไป

ในความเป็นจริง การลบไคลเอนต์ออกจากฐานข้อมูล Mavibot อย่างสมบูรณ์เท่านั้นที่จะช่วยแก้ไขข้อผิดพลาดนี้ได้ แม้ว่าผู้ใช้จะเปิดใช้งานสิทธิ์แล้วก็ตาม

วิธีแก้ไข:

หลังจากที่ผู้ใช้เปลี่ยนการตั้งค่าความเป็นส่วนตัว คุณต้องรอประมาณ 30–60 วินาที (จนกว่าเซิร์ฟเวอร์ของ messenger จะประมวลผลการเปลี่ยนแปลง) จากนั้นจึงส่งคำขอ API ไปยัง Telegram ผ่านบอท:
https://api.telegram.org/bot\/getChat?chat_id=#{platform_id}

หลังจากนั้น ข้อมูลผู้ใช้จะถูกรีเฟรชและข้อความเสียงจะถูกส่งอย่างถูกต้อง

วิธีส่งภาพเคลื่อนไหว

ส่งภาพเคลื่อนไหว tg_send_animation()

! ฟังก์ชันนี้ช่วยให้ส่ง GIF หรือวิดีโอ H.264/MPEG-4 AVC ที่ไม่มีเสียงได้สูงสุด 2GB

! การทำงานกับบัญชีธุรกิจ Telegram

tg_send_animation(platform_id, animation, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

พารามิเตอร์:

!** platform_id** — ID ไคลเอนต์ Telegram ที่จะส่งข้อความไป *

!** animation**- ลิงก์ไปยังภาพเคลื่อนไหว วิธีรับลิงก์ผ่าน tg_request อธิบายไว้ ที่นี่

caption - คำอธิบายสูงสุด 1024 ตัวอักษร

reply_markup — การกำหนดค่าปุ่ม **

parse_mode — การจัดรูปแบบข้อความในคำอธิบายแบบตัวหนาหรือตัวเอียง ***. ค่าที่เป็นไปได้: html, markdown, markdownV2

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น อ้างอิง)

has_spoiler — เปิดใช้งานสปอยเลอร์ หากต้องการเปิดใช้งาน ให้ตั้งค่าเป็น True

message_thread_id — ID เธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

entities — ด้วยพารามิเตอร์นี้ คุณสามารถคัดลอกข้อความที่จัดรูปแบบพร้อมคุณสมบัติทั้งหมดและระบุว่าตัวอักษรใดถึงตัวอักษรใดจะแสดงด้วยสไตล์เฉพาะ คุณสามารถดูตัวอย่างใน tg_request ในฟิลด์ที่เกี่ยวข้อง พารามิเตอร์ควรเป็นพจนานุกรม

show_caption_above_media - หากตั้งค่าเป็น True คำอธิบายข้อความจะแสดงเหนือสื่อ

ตัวอย่างการส่งพารามิเตอร์:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

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

เพื่อให้คำอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ lifehack ต่อไปนี้

ตัวอย่าง

มาทำให้งานซับซ้อนขึ้นและส่งภาพเคลื่อนไหวพร้อมการป้องกันการคัดลอกและสปอยเลอร์

เช่นเคย กระบวนการเริ่มต้นด้วยการรับลิงก์ Telegram ภายในสำหรับภาพเคลื่อนไหวที่เลือก (รายละเอียด ที่นี่)

สุดท้าย ประกอบฟังก์ชัน:

และตรวจสอบผลลัพธ์การทำงาน:

ตัวอย่างโค้ดสำหรับคัดลอก

โปรดจำไว้ว่าลิงก์นั้นไม่ซ้ำกันสำหรับแต่ละบอท ดังนั้นโปรดสร้างลิงก์ของคุณเอง

animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "Happy New Year!"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)

วิธีส่งวิดีโอ

ส่งวิดีโอโดยใช้ API Telegram tg_send_video()

! ฟังก์ชันนี้ช่วยให้คุณส่งไฟล์ MPEG4 ขนาดสูงสุด 2GB
(รูปแบบอื่นสามารถส่งเป็นไฟล์ได้โดยใช้ tg_send_document())

! การทำงานกับบัญชีธุรกิจ Telegram

tg_send_video(platform_id, video, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media, cover)

พารามิเตอร์:

!** platform_id** — ID ไคลเอนต์ Telegram ที่จะส่งข้อความไป *

!** video** - ลิงก์วิดีโอ วิธีรับลิงก์ผ่าน tg_request ดู ที่นี่

caption - คำอธิบายสูงสุด 1024 ตัวอักษร

reply_markup — การตั้งค่าปุ่ม **

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น อ้างอิง)

has_spoiler — เปิดใช้งานสปอยเลอร์ หากต้องการเปิดใช้งาน ให้ตั้งค่าเป็น True

disable_notification — แฟล็กสำหรับส่งข้อความโดยมีการแจ้งเตือนด้วยเสียง (ค่าเริ่มต้น: 0)
1 — ส่งโดยไม่มีการแจ้งเตือน, 0 — ส่งพร้อมการแจ้งเตือน

show_caption_above_media - หากตั้งค่าเป็น True ข้อความจะแสดงเหนือสื่อ

cover - ภาพปกวิดีโอในข้อความ การรับ URL ผ่าน tg_request คือ ที่นี่

ตัวอย่างการส่งพารามิเตอร์:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

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

เพื่อให้คำอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ lifehack ต่อไปนี้

ส่งวิดีโอหลายรายการโดยใช้ API Telegram tg_send_some_video()

! การทำงานกับบัญชีธุรกิจ Telegram

tg_send_some_video(platform_id, video_list, disable_notification, protect_content, reply_to_message_id, has_spoiler, message_thread_id)

พารามิเตอร์:

!** platform_id** — ID ไคลเอนต์ Telegram ที่จะส่งข้อความไป *

!** video_list** - อาร์เรย์ของไฟล์วิดีโอ (รายละเอียดด้านล่าง)

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น อ้างอิง)

has_spoiler — เปิดใช้งานการจัดรูปแบบสปอยเลอร์ (ไม่บังคับ; ตั้งค่าเป็น True เพื่อเปิดใช้งาน)

message_thread_id — ID เธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

ตัวอย่างการสร้างอาร์เรย์วิดีโอ video_list:
'[["Video link1", "caption", "parse_mode"], ["Video link2"], ["Video link3", "caption"]]'

ตัวอย่างการสร้างวิดีโอเดี่ยว:
["Video link", "caption", "parse_mode"]

ลำดับของพารามิเตอร์มีความสำคัญ! เมื่อสร้างอาร์เรย์ไฟล์วิดีโอ สามารถละเว้นเครื่องหมายคำพูด "" ได้

คำอธิบายพารามิเตอร์:
!** Video link** — URL วิดีโอ Telegram ภายใน การรับลิงก์ผ่าน tg_request อธิบายไว้ ที่นี่
caption — คำอธิบายข้อความสูงสุด 1024 ตัวอักษร
parse_mode — การจัดรูปแบบข้อความในคำอธิบายแบบตัวหนาหรือตัวเอียง ***. ค่าที่เป็นไปได้: html, markdown, markdownV2

ตัวอย่าง

เริ่มต้นด้วยการรับลิงก์ไปยังไฟล์ที่เราต้องการส่ง จากนั้นกรอกพารามิเตอร์ฟังก์ชันที่จำเป็น:

หลังจากตรวจสอบ เราจะได้วิดีโอ:

ตัวอย่างโค้ดสำหรับคัดลอก

video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video

วิธีส่งวิดีโอแบบวงกลม

ส่งวิดีโอแบบวงกลม tg_send_video_note()

! ตั้งแต่เวอร์ชัน 4.0 Telegram รองรับการส่งวิดีโอ MPEG4 แบบวงกลมที่มีความยาวสูงสุดหนึ่งนาที

! การทำงานกับบัญชีธุรกิจ Telegram

tg_send_video_note(platform_id, video_note, reply_markup, protect_content, reply_to_message_id, disable_notification, message_thread_id)

พารามิเตอร์:

!** platform_id** — ID ไคลเอนต์ Telegram ที่จะส่งข้อความไป *

!** video_note** - ลิงก์วิดีโอ วิธีรับลิงก์ผ่าน tg_request อธิบายไว้ ที่นี่
reply_markup — การตั้งค่าปุ่ม **

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น อ้างอิง)

message_thread_id — ID เธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

เพื่อให้คำอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ lifehack ต่อไปนี้

ตัวอย่าง

หากคุณมีวิดีโอสี่เหลี่ยมจัตุรัส คุณสามารถแปลงเป็นวิดีโอแบบวงกลมได้โดยใช้บอท https://t.me/roundNoteBot:

เมื่อคุณมีวิดีโอแบบวงกลมแล้ว ให้ส่งไปให้ตัวเองในบอทเพื่อรับลิงก์ (รายละเอียด ที่นี่) จากนั้นตั้งค่าฟังก์ชันสำหรับส่งวิดีโอแบบวงกลม:

ตัวอย่างโค้ดสำหรับคัดลอก

tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')

วิธีส่งตำแหน่ง

ส่งตำแหน่งทางภูมิศาสตร์ tg_send_venue()

! การทำงานกับบัญชีธุรกิจ Telegram

tg_send_venue(platform_id, latitude, longitude, title, address, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

พารามิเตอร์:

! platform_id — รหัสลูกค้า Telegram ที่ควรส่งข้อความไป *

! latitude — ละติจูด

! longitude — ลองจิจูด

! title — ชื่อเรื่อง

! address — ที่อยู่

disable_notification — แฟล็กสำหรับส่งข้อความพร้อมการแจ้งเตือนด้วยเสียง (ค่าเริ่มต้น: 0)
1 — ส่งโดยไม่มีการแจ้งเตือน, 0 — ส่งพร้อมการแจ้งเตือน

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

reply_markup — การตั้งค่าปุ่ม **

message_thread_id — ID ของเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

เพื่อให้คำอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ lifehack ต่อไปนี้

ตัวอย่าง

มาเริ่มต้นด้วยการกำหนดพิกัดของสถานที่กัน คุณสามารถรับพิกัดได้โดยใช้ Google Maps

จากนั้น แปลงพิกัดที่ได้จากองศาทศนิยมเป็นรูปแบบพิกัดทางภูมิศาสตร์โดยใช้ ตัวแปลงพิกัด ออนไลน์:

ตอนนี้ มาดำเนินการกรอกพารามิเตอร์ของฟังก์ชันและรับผลลัพธ์ที่ต้องการ:

ตัวอย่างโค้ดสำหรับคัดลอก

soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Dreams come true!", "Paris, Eiffel Tower")

วิธีส่งรายชื่อติดต่อ

ส่งรายชื่อติดต่อ tg_send_contact()

! ทำงานกับ Telegram business - บัญชี

Telegram มีวิธีที่รวดเร็วในการแชร์รายชื่อติดต่อจากสมุดที่อยู่ของคุณ แอปพลิเคชันรองรับการส่ง vCard — นามบัตรอิเล็กทรอนิกส์

ฟังก์ชัน tg_send_contact อนุญาตให้ส่งหมายเลขโทรศัพท์พร้อมชื่อ (หรือชื่อองค์กร) รวมถึงเพิ่มปุ่มและเปิดใช้งานการป้องกันเนื้อหาสำหรับข้อความ

tg_send_contact(platform_id, phone, first_name, last_name, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

! - พารามิเตอร์ฟังก์ชันที่จำเป็น

พารามิเตอร์:

! platform_id — รหัสลูกค้า Telegram ที่ควรส่งข้อความไป *

! phone — หมายเลขโทรศัพท์ในรูปแบบสากล ตัวอย่างเช่น สำหรับรัสเซีย: +7XXXXXXXXXX

! first_name และ last_name - ชื่อและนามสกุล

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

reply_markup — การตั้งค่าปุ่ม **

message_thread_id — ID ของเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

เพื่อให้คำอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ lifehack ต่อไปนี้

ตัวอย่าง

กรอกพารามิเตอร์: หมายเลขโทรศัพท์ ชื่อ และนามสกุล

ดูผลลัพธ์:

ตัวอย่างโค้ดสำหรับคัดลอก

soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1)

วิธีส่งสติกเกอร์

ส่งสติกเกอร์ tg_send_sticker()

! ทำงานกับ Telegram business - บัญชี

tg_send_sticker(platform_id, sticker_id, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

พารามิเตอร์:

! platform_id — รหัสลูกค้า Telegram ที่ควรส่งข้อความไป *

! sticker_id - ID สติกเกอร์ วิธีรับลิงก์ผ่าน tg_request อธิบายไว้ ที่นี่

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

reply_markup — การตั้งค่าปุ่ม **

message_thread_id — ID ของเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

เพื่อให้คำอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ lifehack ต่อไปนี้

ตัวอย่าง

การส่งสติกเกอร์ไม่แตกต่างจากการส่งไฟล์แนบอื่นๆ:

รับลิงก์ภายใน Telegram (รายละเอียดที่นี่)
กรอกพารามิเตอร์ของฟังก์ชัน
ส่งบล็อกไปให้ตัวเองและตรวจสอบผลลัพธ์

ผลลัพธ์:

ตัวอย่างโค้ดสำหรับคัดลอก

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

soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')

วิธีส่งรูปภาพ

ทำความเข้าใจพารามิเตอร์ caption

พารามิเตอร์ caption ให้ข้อความอธิบายสำหรับรูปภาพ (เช่น สรุปสั้นๆ หรือคำอธิบาย) โดยทำงานดังนี้:

กับรูปภาพเดียว: หากมีการระบุคำอธิบาย ข้อความจะประกอบด้วยทั้งรูปภาพและข้อความอธิบาย

กับรูปภาพหลายรูป: แต่ละรูปภาพสามารถมีคำอธิบายของตัวเองได้ ในกรณีนี้ แต่ละรูปภาพจะถูกส่งพร้อมกับคำอธิบายเฉพาะของมัน

ประสบการณ์ผู้ใช้: ข้อความคำอธิบายมักจะแสดงเมื่อผู้ใช้คลิกหรือแตะที่รูปภาพ

สำหรับข้อมูลจำเพาะทางเทคนิคโดยละเอียดและพฤติกรรมของ API โปรดดูเอกสารอย่างเป็นทางการของ Telegram

หมายเหตุ: หากคุณกำลังติดตามวิดีโอสอน โปรดตรวจสอบขั้นตอนอย่างละเอียด เนื่องจากการตั้งค่าและอินเทอร์เฟซอาจมีการอัปเดตเมื่อเวลาผ่านไป

ส่งรูปภาพ tg_send_photo()

! รูปภาพควรมีขนาดไม่เกิน 10 MB ความกว้างและความสูงรวมไม่ควรเกิน 10,000 พิกเซล อัตราส่วนความกว้างต่อความสูงไม่ควรเกิน 20

! ทำงานกับ Telegram business - บัญชี

tg_send_photo(platform_id, photo, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

พารามิเตอร์:

! platform_id — รหัสลูกค้า Telegram ที่ควรส่งข้อความไป *

! photo - ลิงก์ไปยังรูปภาพ วิธีรับลิงก์ผ่าน tg_request อธิบายไว้ ที่นี่

caption - คำอธิบายสูงสุด 1024 ตัวอักษร

reply_markup — การตั้งค่าปุ่ม **

parse_mode — การจัดรูปแบบข้อความในคำอธิบายแบบตัวหนาหรือตัวเอียง ***

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

has_spoiler — เปิดใช้งานการจัดรูปแบบสปอยเลอร์ ตั้งค่าเป็น True เพื่อเปิดใช้งาน

message_thread_id — ID ของเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

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

show_caption_above_media - หากตั้งค่าเป็น True ข้อความจะแสดงเหนือสื่อ

ตัวอย่างการส่งพารามิเตอร์:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

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

เพื่อให้คำอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ lifehack ต่อไปนี้

ส่งรูปภาพหลายรูป tg_send_some_photo()

! ทำงานกับ Telegram business-account

tg_send_some_photo(platform_id, image_list, disable_notification=0, protect_content=False, reply_to_message_id=0, has_spoiler=False,message_thread_id)

พารามิเตอร์:

! platform_id — รหัสลูกค้า Telegram ที่ควรส่งข้อความไป *

! image_list - อาร์เรย์ของไฟล์รูปภาพ (รายละเอียดด้านล่าง)

protect_content — แฟล็กเพื่อป้องกันเนื้อหาจากการคัดลอก (พารามิเตอร์เสริม หากต้องการเปิดใช้งาน ให้ส่ง 1 เป็นค่า)

reply_to_message_id - ID ของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

has_spoiler — เปิดใช้งานการจัดรูปแบบสปอยเลอร์ (ไม่บังคับ ตั้งค่าเป็น True เพื่อเปิดใช้งาน)

message_thread_id — ID ของเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

ตัวอย่าง image_list:

'[["Image link 1", "caption", "parse_mode"], ["Image link 2"], ["Image link 3", "caption"]]'

ตัวอย่างข้อมูลสำหรับรูปภาพเดียว:
["Image link 1", "caption", "parse_mode"]

ลำดับพารามิเตอร์มีความสำคัญ! เมื่อสร้างอาร์เรย์ของไฟล์รูปภาพ สามารถละเครื่องหมายคำพูด "" ได้

คำอธิบายพารามิเตอร์:

! Image link 1 - ลิงก์รูปภาพ วิธีรับลิงก์ผ่าน tg_request อธิบายไว้ที่นี่

caption — คำอธิบายสูงสุด 1024 ตัวอักษร

parse_mode — การจัดรูปแบบข้อความในคำอธิบายแบบตัวหนาหรือตัวเอียง ***

ตัวอย่าง

มาดูตัวอย่างฟังก์ชันสำหรับส่งรูปภาพหลายรูป:

ขั้นแรก สร้างอาร์เรย์รูปภาพ

จากนั้น กรอกพารามิเตอร์ของฟังก์ชัน

ส่งบล็อกไปให้ตัวเองและเพลิดเพลินกับผลลัพธ์

ตัวอย่างโค้ดที่สามารถคัดลอกได้

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

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

วิธีส่งลูกเต๋า

ส่งอีโมจิแบบสุ่ม (ลูกเต๋า) tg_send_dice()

tg_send_dice(platform_id, emoji, reply_markup, disable_notification, reply_to_message_id, protect_content, message_thread_id)

! ทำงานกับบัญชี Telegram business

พารามิเตอร์:

! platform_id — รหัสลูกค้า Telegram ที่จะส่งข้อความไป *

emoji - อีโมจิที่จะส่ง หากคุณปล่อยพารามิเตอร์ว่างไว้ จะส่งลูกเต๋าโดยค่าเริ่มต้น คุณสามารถส่งอีโมจิเป็นสตริงหรือคีย์เวิร์ดที่ใช้แทนอีโมจินั้นก็ได้

reply_markup — การตั้งค่าปุ่ม **

disable_notification — แฟล็กสำหรับส่งข้อความโดยไม่มีการแจ้งเตือนด้วยเสียง (ค่าเริ่มต้น: 0)
1 — ส่งโดยไม่แจ้งเตือน, 0 — ส่งพร้อมการแจ้งเตือน

reply_to_message_id - รหัสของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

message_thread_id — รหัสเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม)

เพื่อให้คำอธิบายชุดปุ่มง่ายขึ้น คุณสามารถใช้ เคล็ดลับ นี้ได้

รายการอีโมจิที่เป็นไปได้: \

'darts' หรือ '🎯', ค่าตั้งแต่ 1 ถึง 6 \
'dice' หรือ '🎲', ค่าตั้งแต่ 1 ถึง 6 \
'bowling' หรือ '🎳', ค่าตั้งแต่ 1 ถึง 6 \
'basketball' หรือ '🏀', ค่าตั้งแต่ 1 ถึง 5 \
'football' หรือ '⚽', ค่าตั้งแต่ 1 ถึง 5 \
'slots' หรือ '🎰', ค่าตั้งแต่ 1 ถึง 64

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

ตัวอย่าง

ตัวเลือกที่ง่ายที่สุดคือการเรียกใช้ฟังก์ชันด้วยพารามิเตอร์ที่จำเป็นเพียงตัวเดียว:

ในกรณีนี้ ลูกค้าจะได้รับลูกเต๋า:

หากลูกค้าโยนลูกเต๋า (โดยคลิกที่อีโมจิที่ได้รับ) บอทจะได้รับการตอบกลับด้วยจำนวนแต้มที่โยนได้:

คุณสามารถทดลองกับฟังก์ชันนี้ได้ ตัวอย่างเช่น มาสร้างสล็อตแมชชีนและเพิ่มปุ่ม คะแนน เมื่อกดปุ่ม เราจะได้รับคะแนนรวมของลูกค้า:

ตัวอย่างโค้ดที่สามารถคัดลอกได้

ตัวอย่างแรก:

soob=tg_send_dice(platform_id)

ตัวอย่างที่สอง:

/* ตัวอย่างแรก */
tg_send_message(platform_id,'คลิกที่สล็อตแมชชีนเพื่อลองเสี่ยงโชค!')
opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* บล็อกที่สอง - ข้อความ */
 #{res[1]} แต้มที่โยนได้
/* บล็อกที่สอง - เครื่องคิดเลข */
res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* บล็อกที่สาม - ข้อความ */
คุณมีคะแนนรวม #{balls} แต้ม

วิธีส่งกลุ่มสื่อ

ส่งกลุ่มสื่อ tg_send_media_group()

! ทำงานกับบัญชี Telegram business

วิธีการส่งกลุ่มรูปภาพ วิดีโอ เอกสาร หรือไฟล์เสียงเป็นอัลบั้ม เมื่อสำเร็จ จะส่งคืนอาร์เรย์ของไฟล์ที่ส่ง

หมายเหตุ: เอกสารและไฟล์เสียงไม่สามารถจัดกลุ่มร่วมกับไฟล์ประเภทอื่นได้!

tg_send_media_group(platform_id, media_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

พารามิเตอร์:

! platform_id — รหัสลูกค้า Telegram ที่จะส่งข้อความไป

! media_list - อาร์เรย์ที่มีรูปภาพ วิดีโอ เอกสาร หรือไฟล์เสียง 2 ถึง 10 รายการ (รายละเอียดด้านล่าง);

disable_notification — แฟล็กสำหรับส่งข้อความโดยไม่มีการแจ้งเตือนด้วยเสียง (ค่าเริ่มต้น: 0)
1 — ส่งโดยไม่แจ้งเตือน, 0 — ส่งพร้อมการแจ้งเตือน

protect_content — แฟล็กเพื่อป้องกันเนื้อหาจากการคัดลอก หากต้องการเปิดใช้งาน ให้ส่งค่าใดๆ ที่ไม่ใช่ 0, False หรือเครื่องหมายคำพูดว่าง ''

reply_to_message_id - รหัสของข้อความที่จะตอบกลับ (เช่น การอ้างอิง)

message_thread_id — รหัสเธรด (ใช้ได้ในซูเปอร์กรุ๊ปที่มีฟังก์ชันฟอรัม);

เนื้อหาขององค์ประกอบในอาร์เรย์ media_list:

! type - ประเภทไฟล์, “photo”, “video”, “audio” หรือ ”document”

! media - ไฟล์ที่จะส่ง ส่ง file_id เพื่อส่งไฟล์ที่มีอยู่แล้วบนเซิร์ฟเวอร์ Telegram (แนะนำ), URL HTTP สำหรับ Telegram เพื่อดึงไฟล์จากอินเทอร์เน็ต หรือ «attach://<file_attach_name>» เพื่ออัปโหลดไฟล์ใหม่โดยใช้ multipart/form-data ด้วยชื่อ <file_attach_name>

อ่านเพิ่มเติม: https://core.telegram.org/bots/api#sending-files

caption — คำอธิบายของไฟล์ที่ส่ง, 0–1024 อักขระ

parse_mode — การจัดรูปแบบข้อความในคำอธิบายแบบตัวหนาหรือตัวเอียง

อ่านเพิ่มเติม: https://core.telegram.org/bots/api#sending-files

ตัวอย่างอาร์เรย์ media_list:

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "วิดีโอผี"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “วิดีโอกระต่าย”}]

ตัวอย่าง

มาดูตัวอย่างฟังก์ชันสำหรับส่งรูปภาพหลายรูป:

ขั้นแรก สร้างอาร์เรย์รูปภาพ

จากนั้น กรอกพารามิเตอร์ของฟังก์ชัน

ส่งบล็อกไปให้ตัวเองและเพลิดเพลินกับผลลัพธ์

ตัวอย่างโค้ดที่สามารถคัดลอกได้

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

วิธีส่งไฟล์แนบขนาดใหญ่

ตัวอย่าง

ใน Telegram (ทั้งสำหรับบัญชีธุรกิจและบัญชีทั่วไป) คุณสามารถส่งไฟล์แนบผ่านลิงก์:

คุณสามารถส่งไฟล์แนบทุกขนาด โดยไม่จำกัดขนาดไฟล์
คุณยังสามารถส่งไฟล์แนบทุกประเภทที่คุณต้องการ

วิธีทำ:

คัดลอกลิงก์ไปยังไฟล์แนบที่เปิดเผยต่อสาธารณะอยู่แล้ว:

จากนั้น วางลิงก์ที่คัดลอกลงในฟังก์ชันแนบไฟล์ในบล็อกของคุณ:

เสร็จแล้ว ด้วยวิธีนี้ คุณสามารถส่งไฟล์แนบทุกประเภทและทุกขนาด

ฟังก์ชันสำหรับส่งไฟล์แนบในข้อความ

วิธีส่งเอกสาร

วิธีส่งเสียง / ข้อความเสียง

วิธีส่งภาพเคลื่อนไหว

วิธีส่งวิดีโอ

วิธีส่งวิดีโอแบบวงกลม

วิธีส่งตำแหน่ง

วิธีส่งรายชื่อติดต่อ

วิธีส่งสติกเกอร์

วิธีส่งรูปภาพ

ทำความเข้าใจพารามิเตอร์ caption

วิธีส่งลูกเต๋า

วิธีส่งกลุ่มสื่อ

วิธีส่งไฟล์แนบขนาดใหญ่

ทำความเข้าใจพารามิเตอร์ `caption`