ข้อกำหนดและข้อจำกัดของ Telegram

1. ข้อจำกัดของข้อความ

  • ข้อความที่มีแต่ข้อความ: สูงสุด 4,096 ตัวอักษร
  • ข้อความที่มีรูปภาพ: สูงสุด 1,024 ตัวอักษร (สำหรับรูปภาพขนาด 1080x1080 px)

2. ข้อกำหนดของรูปภาพ

  • รูปแบบ: รูปภาพสี่เหลี่ยมจัตุรัสเป็นที่ต้องการ
  • ขนาดที่เหมาะสม: 900x900 พิกเซล สูงสุด 5 MB

3. ข้อกำหนดของไฟล์

Telegram API มีข้อกำหนดเฉพาะสำหรับไฟล์ที่อัปโหลด:

  • บอทสามารถส่งไฟล์ได้สูงสุด 2 GB
  • คุณสามารถใช้ file_id เพื่อทำงานกับไฟล์ที่อัปโหลดก่อนหน้านี้ ในกรณีนี้ ข้อจำกัดของไฟล์จะเป็นไปตามเอกสารของ Telegram
  • ไฟล์สามารถส่งได้โดยใช้ URL (บอทจะดาวน์โหลดและส่ง):
    • รูปภาพ: ≤ 5 MB
    • ไฟล์อื่นๆ: ≤ 20 MB
  • ข้อจำกัดที่แตกต่างกันสำหรับการโพสต์:
    • รูปภาพ: 10 MB
    • ไฟล์อื่นๆ: 2 GB

อ่านเพิ่มเติมในแหล่งต้นฉบับ

การสร้างบอท Telegram

บอท Telegram ถูกสร้างขึ้นผ่าน BotFather ซึ่งเป็นระบบจัดการบอทอย่างเป็นทางการของ Telegram เครื่องมือที่ได้รับการยืนยันนี้ (ระบุด้วยเครื่องหมายถูกสีน้ำเงิน) ช่วยให้คุณสร้างบอทได้โดยไม่ต้องมีความรู้ด้านการเขียนโปรแกรม และปกป้องคุณจากผู้เลียนแบบที่เป็นอันตราย

ขั้นตอนการสร้าง:

  1. เริ่มแชท กับ BotFather
  2. ส่งคำสั่ง: /newbot
  3. เลือกชื่อ สำหรับบอทของคุณ (นี่คือชื่อที่แสดงต่อผู้ใช้)
  4. เลือกชื่อผู้ใช้ สำหรับบอทของคุณ โดย ต้อง ลงท้ายด้วย bot หรือ _bot (เช่น my_test_bot)

หากชื่อผู้ใช้นั้นว่าง BotFather จะส่งข้อความยืนยันที่มี "โทเค็น" ซึ่งเป็นคีย์เฉพาะสำหรับการเข้าถึง API

สำคัญ: โทเค็นนี้คือรหัสผ่านของบอทของคุณ เก็บไว้อย่างปลอดภัยและ อย่าแชร์ให้ใครเด็ดขาด

ไปที่ส่วน Messengers เลือก Telegram และวางโทเค็นของบอทของคุณในช่องที่กำหนด

คลิกปุ่ม Done เพื่อเสร็จสิ้นการตั้งค่าบอทและเปิดใช้งานการเชื่อมต่อกับโปรเจกต์ของคุณ

การทำงานกับกลุ่ม/ช่องทาง Telegram

ข้อมูลที่เป็นประโยชน์

กลุ่ม Telegram คือช่องทางการสื่อสารระหว่างผู้เข้าร่วม: ผู้เข้าร่วมทุกคนสามารถเขียนข้อความในนั้นได้

ช่องทาง Telegram คือวิธีการสื่อสารทางเดียว เฉพาะเจ้าของหรือผู้ดูแลระบบเท่านั้นที่สามารถส่งข้อความได้ ในขณะที่ผู้เข้าร่วมคนอื่นๆ สามารถดูและแสดงความคิดเห็นได้เท่านั้น

วิธีเพิ่มบอทในกลุ่ม/ช่องทาง Telegram

ฟีเจอร์นี้สำหรับบอทมีอยู่ใน BotFather:

ขั้นตอนที่ 1. ไปที่การตั้งค่าบอท:

ขั้นตอนที่ 2. คลิกที่ "Allow Groups?"

ขั้นตอนที่ 3. ควรมีสถานะเปิดใช้งาน

เพิ่มบอทเป็นผู้ดูแลระบบในกลุ่ม/ช่องทาง

เพื่อทำงานอัตโนมัติในแชทและช่องทาง คุณต้องเพิ่มบอทของคุณเองเป็นผู้ดูแลระบบ

ทำอย่างไร?

ขั้นตอนที่ 1. ไปที่การจัดการกลุ่ม/ช่องทาง และเลือกแท็บ Administrators

ขั้นตอนที่ 2. คลิกปุ่ม "Add Admin"

ขั้นตอนที่ 3. ป้อนชื่อผู้ใช้ของบอทในช่องค้นหา

ขั้นตอนที่ 4. เพื่อการทำงานที่สมบูรณ์ ตรวจสอบให้แน่ใจว่าบอทมีสิทธิ์ในการอ่านและลบข้อความ

ตัวแปรสำหรับการทำงานในแชท

โปรดทราบ!

การบันทึกตัวแปรในแชทกลุ่มสำหรับเหตุการณ์ เช่น การเข้าร่วมแชท การออกจากแชท ไลค์ใหม่ ฯลฯ ไม่สามารถทำได้

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

สิ่งนี้ จะไม่ส่งผลกระทบ ต่อการทำงานของแชทบอทแต่อย่างใด จะไม่สามารถติดตามได้ว่าใครเข้า/ออกในส่วนของลูกค้า

  • ตัวแปรที่มีข้อมูลเกี่ยวกับผู้เขียนข้อความ

message_from - ID ของผู้เขียนข้อความ

message_from_name - ชื่อของผู้เขียนข้อความ

message_from_username - ชื่อเล่นของผู้เขียนข้อความใน Telegram

  • ตัวแปรที่มีข้อมูลเกี่ยวกับข้อความที่ถูกส่งต่อ

reply_message_id - หมายเลขของข้อความที่ถูกส่งต่อ

reply_from - ใครคือผู้เขียนข้อความที่ถูกส่งต่อ

reply_from_name - ชื่อของบุคคลที่ข้อความถูกส่งต่อ

reply_from_username - ชื่อเล่นของบุคคลที่ข้อความถูกส่งต่อ

reply_from_chat_id - หมายเลขของบทสนทนาที่ข้อความถูกส่งต่อ

  • การเพิ่มและลบออกจากกลุ่ม

ในกรณีนี้ callbacks new_chat_member และ left_chat_member จะถูกเรียกใช้ (ตัวแปรจะไม่ถูกบันทึกในการ์ดของลูกค้า):

chat_member_name - ชื่อผู้ใช้

chat_member_username - ชื่อเล่นของผู้ใช้

chat_member_id - หมายเลขของผู้ใช้

Callbacks ใน Telegram

client_unsubscribed - ลูกค้าได้ยกเลิกการสมัคร บล็อกบอท

client_returned - ลูกค้าได้ปลดบล็อกบอท

Callbacks ในกลุ่ม/ช่องทาง

new_chat_member - ผู้ใช้ใหม่ถูกเพิ่ม

left_chat_member - ผู้ใช้ออกจากช่องทาง

kicked_chat_member - ผู้ใช้ถูกลบโดยผู้ดูแลระบบ

chat_join_request - ได้รับคำขอให้เพิ่มในช่องทาง

edited_channel_post - โพสต์ในช่องทางถูกแก้ไข (edited_channel_post + วันที่และเวลาในการแก้ไข)

Callbacks จะแสดงในส่วน Clients

bot_added_to_group - บอทถูกเพิ่มในแชท (ไม่สำคัญว่าอันไหน มันจะตอบสนองต่อใครก็ได้ แม้ว่าบอทที่เชื่อมต่อจะถูกเพิ่มในกลุ่มเอง);

bot_left_group - callback ที่คล้ายกันคือการลบบอทออกจากช่องทาง;

new_like - ชอบโพสต์

like_deleted - ลบไลค์ออกจากโพสต์

ตัวเลขใน callback (new_like; like_deleted) คือ ID ของข้อความที่ถูกตอบกลับหรือลบออก

โปรดทราบ!

  • Callbacks สำหรับปฏิกิริยาจะไม่แสดงในช่องทาง Telegram! Callbacks สำหรับปฏิกิริยาจะมาเฉพาะในกลุ่มเท่านั้น
  • หากบุคคลหนึ่งกดไลค์หลายครั้ง แล้วลบ 1 ครั้ง จะไม่แสดงว่าลบอันไหน

เมื่อ callbacks ที่มีปฏิกิริยาปรากฏในกลุ่ม ตัวแปรจะพร้อมใช้งานในบล็อก:

reaction_on_message_id - มี ID ของข้อความที่ถูกตอบกลับ

reaction_from - id จากผู้ที่มีปฏิกิริยา

message_from_username - ชื่อผู้ใช้จากผู้ที่มีปฏิกิริยา (ถ้ามี)

reaction_from_name - ชื่อจากผู้ที่มีปฏิกิริยา

นอกจากนี้ หาก Telegram ตอบกลับข้อความ ตัวแปร reply_text ในการ์ดจะมีข้อความเต็มของข้อความที่ถูกตอบ

หากข้อความถูกส่งเป็นการตอบกลับ (อ้างอิงข้อความก่อนหน้า) ระบบจะสร้างตัวแปร tg_quote ซึ่งมีข้อความที่ถูกอ้างอิง

Callbacks พร้อมบูสต์

  • chat_boost_from user #{id_user} - ให้บูสต์กับแชท (หรือช่องทาง):

เมื่อ callback นี้ถูกเรียกใช้ ตัวแปรจะถูกสร้างขึ้น:

  • remove_boost_from user #{id_user} - นำบูสต์ออกจากแชท (หรือช่องทาง):

เมื่อ callback นี้ถูกเรียกใช้ ตัวแปรจะถูกสร้างขึ้น:

  • chat_boost from giveaway - ออกระหว่างการจับรางวัลดาวในช่องทาง
  • remove_chat_boost from giveaway - ระยะเวลาบูสต์สำหรับการจับรางวัลดาวในช่องทางสิ้นสุดลง

วิธีทำให้การลบการแจ้งเตือนระบบในกลุ่มเป็นอัตโนมัติ

เพื่อลบข้อความระบบทั้งหมดโดยอัตโนมัติ เพียงกำหนดค่าใดๆ ให้กับตัวแปร del_tg_system_messages (ตัวแปรสามารถเป็นค่าคงที่ของโปรเจกต์หรือตัวแปรธุรกรรม) และให้สิทธิ์บอทในการลบข้อความ

ตัวแปร del_tg_system_messages สามารถใช้ได้เฉพาะในกลุ่มเท่านั้น ในช่องทาง การกำหนดค่าใดๆ ให้กับตัวแปรนี้จะไม่ให้ผลลัพธ์ใดๆ

สิทธิ์ผู้ดูแลระบบในการตั้งค่ากลุ่ม Telegram

การแจ้งเตือนระบบประเภทต่อไปนี้จะถูกลบ:

- ชื่อของกลุ่มถูกเปลี่ยน

- รูปภาพของกลุ่มถูกเปลี่ยน

- รูปภาพกลุ่มถูกลบ

- ข้อความถูกปักหมุด

- ผู้ใช้เข้าร่วมกลุ่ม

- ผู้ใช้ออกจากกลุ่ม

หากคุณต้องการลบเฉพาะการแจ้งเตือนระบบบางประเภท ให้สร้างตัวแปร del_tg_chosen_messages แทนตัวแปร del_tg_system_messages และใส่ประเภทของการแจ้งเตือนที่จะลบในรูปแบบอาร์เรย์ คั่นด้วยเครื่องหมายจุลภาค

โปรดทราบ!

ตัวแปรเหล่านี้จะทำงานเฉพาะกับกลุ่ม Telegram เท่านั้น แต่ไม่ใช่กับช่องทาง

ตัวเลือกการแจ้งเตือนระบบ:

  • 'new_chat_member' – ผู้ใช้เข้าร่วมกลุ่ม
  • 'left_chat_member' – ผู้ใช้ออกจากกลุ่ม
  • 'pinned_message' – ข้อความถูกปักหมุด
  • 'delete_chat_photo' – รูปภาพกลุ่มถูกลบ
  • 'new_chat_photo' – รูปภาพของกลุ่มถูกเปลี่ยน
  • 'new_chat_title' – ชื่อของกลุ่มถูกเปลี่ยน

ตัวอย่างเช่น คุณต้องลบข้อความระบบทุกประเภท ยกเว้นการเข้าร่วมกลุ่ม จากนั้นคุณต้องเพิ่ม callbacks ทุกประเภทลงในตัวแปรโปรเจกต์ (ค่าคงที่) ยกเว้น "new_chat_member"

โปรดทราบ!

การลบการแจ้งเตือนระบบจะไม่ส่งผลกระทบต่อ callbacks เฉพาะข้อความระบบจากบทสนทนา Telegram เท่านั้นที่จะถูกลบ

ฟอรัมใน Telegram

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

วัตถุประสงค์หลักของฟอรัมคือ จัดโครงสร้างการสื่อสาร ภายในชุมชนขนาดใหญ่

ในแชทกลุ่มมาตรฐานที่มีผู้เข้าร่วมจำนวนมาก การติดตามการสนทนาและการค้นหาข้อความที่เกี่ยวข้องกลายเป็นเรื่องยาก ฟอรัมแก้ปัญหานี้โดยจัดระเบียบการสนทนาเป็น หัวข้อเฉพาะตามธีม ซึ่งจะแบ่งกลุ่มชุมชนตามหัวข้อและความสนใจโดยอัตโนมัติ ทำให้การสื่อสารมีประสิทธิภาพและจัดการได้ง่ายขึ้น

เฉพาะเจ้าของกลุ่มเท่านั้นที่สามารถสร้างหัวข้อได้หากมีสมาชิกมากกว่า 100 คนในกลุ่ม หากกลุ่มเชื่อมโยงกับช่องทาง คุณจะไม่สามารถสร้างธีมได้ หัวข้อจะเปิดใช้งานใน การตั้งค่ากลุ่ม:

ในฐานะผู้ดูแลระบบ คุณสามารถสร้างหัวข้อในการตั้งค่ากลุ่มฟอรัม:

หลังจากเชื่อมต่อ หัวข้อ รูปประจำตัวจะเปลี่ยนจากทรงกลมเป็นสี่เหลี่ยมจัตุรัส ซึ่งช่วยให้คุณแยกแยะฟอรัมจากแชท Telegram อื่นๆ:

วิธีกำหนดค่าการรวมลูกค้า Telegram กับเว็บไซต์?

อ่านเพิ่มเติมเกี่ยวกับวิธีเชื่อมโยงลูกค้า Telegram และลูกค้าจากเว็บไซต์หลังจาก การชำระเงินสำเร็จที่นี่