การตั้งค่าแชทและเมสเซนเจอร์ของ Telegram

tg_set_group_title(platform_id, title)

เปลี่ยนชื่อของกลุ่ม Telegram

พารามิเตอร์

tg_set_chat_description(platform_id, description)

เปลี่ยนคำอธิบายของแชท Telegram

พารามิเตอร์

tg_set_chat_photo(platform_id, photo)

ตั้งค่ารูปโปรไฟล์ใหม่สำหรับแชท Telegram

พารามิเตอร์

tg_delete_chat_photo(platform_id)

ลบรูปโปรไฟล์ปัจจุบันออกจากแชท Telegram

พารามิเตอร์

tg_ban_chat_sender_chat(platform_id, sender_chat_id)

แบนแชทผู้ส่งไม่ให้โพสต์ข้อความในแชท Telegram

พารามิเตอร์

หมายเหตุ

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

ในขณะเดียวกัน เจ้าของแชทที่ถูกแบนจะไม่สามารถเขียนในนามของแชทอื่นของเขา/เธอได้จนกว่าจะถูกแบน

tg_unban_chat_sender_chat(platform_id, sender_chat_id)

ปลดแบนแชทผู้ส่งที่ถูกแบนก่อนหน้านี้ในแชท Telegram

พารามิเตอร์

tg_create_chat_invite_link(platform_id, member_limit, hours, request, name)

สร้างลิงก์เชิญใหม่สำหรับแชท Telegram

พารามิเตอร์

สำคัญ

หากระบุพารามิเตอร์ member_limit พารามิเตอร์ request จะถูกตั้งค่าเป็น False โดยอัตโนมัติ

หากต้องการให้ผู้ใช้ส่งคำขอเข้าร่วม ให้เว้นพารามิเตอร์ member_limit ว่างไว้

เมื่อส่งพารามิเตอร์ member_limit ค่าของพารามิเตอร์ request จะถูกเปลี่ยนเป็น False โดยอัตโนมัติ หากคุณต้องการรับคำขอเป็นสมาชิก ให้เว้นพารามิเตอร์ member_limit ว่างไว้

การสร้างลิงก์เชิญแชท

tg_revoke_chat_invite_link(platform_id, invite_link)

เพิกถอนลิงก์เชิญที่มีอยู่สำหรับแชท Telegram

พารามิเตอร์

tg_export_chat_link(platform_id)

สร้างลิงก์เชิญหลักใหม่สำหรับแชท Telegram

พารามิเตอร์

คำเตือน

เมธอดนี้จะสร้างลิงก์เชิญหลักใหม่สำหรับแชท

ลิงก์เชิญหลักที่สร้างไว้ก่อนหน้านี้ทั้งหมดจะไม่ทำงาน ลิงก์ที่สร้างขึ้นใหม่จะเป็นลิงก์เชิญหลักที่ใช้งานได้เพียงลิงก์เดียวจนกว่าจะมีการสร้างลิงก์เชิญเพิ่มเติม

ใช้เมธอดนี้ด้วยความระมัดระวัง

tg_approve_chat_join_request(chat_id, user_id)

อนุมัติคำขอเข้าร่วมที่รอดำเนินการสำหรับกลุ่มหรือแชนเนล Telegram

พารามิเตอร์

การอนุมัติคำขอ:

tg_decline_chat_join_request(chat_id, user_id)

ปฏิเสธคำขอเข้าร่วมที่รอดำเนินการสำหรับกลุ่มหรือแชนเนล Telegram

พารามิเตอร์

tg_ban_chat_member(chat_id, user_id, hours)

แบนผู้ใช้จากแชท Telegram

พารามิเตอร์

หมายเหตุ

หากค่า hours เกิน 366 วัน ผู้ใช้จะถูกแบนถาวร

tg_unban_chat_member(chat_id, user_id)

ปลดบล็อกผู้ใช้จากแชท Telegram

พารามิเตอร์

tg_get_chat_member(chat_id, user_id)

ดึงข้อมูลเกี่ยวกับสถานะสมาชิกของผู้ใช้ในแชท Telegram

พารามิเตอร์

tg_get_chat_member_count(platform_id)

ส่งคืนจำนวนสมาชิกทั้งหมดในแชท Telegram

พารามิเตอร์

some_client_in_list(list_id, recepient)

ตรวจสอบว่าผู้ใช้ Telegram อยู่ในรายการที่ระบุหรือไม่

พารามิเตอร์

tg_send_chat_action(platform_id, bot_action, message_thread_id)

ส่งการกระทำในแชท (เช่น การพิมพ์หรืออัปโหลดไฟล์) ไปยังแชท Telegram

พารามิเตอร์

หมายเหตุ

ฟังก์ชันนี้รองรับเมื่อทำงานกับ บัญชี Telegram Business

typing สำหรับข้อความ
&#xNAN;upload_photo สำหรับรูปภาพ
&#xNAN;record_video หรือ upload_video สำหรับวิดีโอ
&#xNAN;record_voice หรือ upload_voice สำหรับบันทึกเสียง
&#xNAN;upload_document สำหรับเอกสารทั่วไป
&#xNAN;choose_sticker สำหรับสติกเกอร์
&#xNAN;find_location สำหรับข้อมูลตำแหน่ง
&#xNAN;record_video_note หรือ upload_video_note สำหรับบันทึกวิดีโอ

tg_answer_callback_query(callback_query_id, text, show_alert, cache_time)

ส่งการตอบกลับไปยังคำขอ callback ที่ถูกเรียกเมื่อผู้ใช้คลิกปุ่ม inline ใน Telegram

พารามิเตอร์

สำคัญ

ฟังก์ชันนี้สามารถใช้ได้เฉพาะในการตอบสนองต่อการคลิก ปุ่ม callback แบบ inline ของผู้ใช้ใน Telegram เท่านั้น

ตัวอย่าง

คีย์บอร์ด inline ต่อไปนี้จะส่งค่า callback ที่แตกต่างกันเมื่อคลิกแต่ละปุ่ม:

[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]

หลังจากคลิกปุ่ม callback จะมาถึงพร้อมกับข้อความที่อยู่ในฟิลด์ที่เกี่ยวข้อง เมื่อคุณคลิกปุ่ม "111" คุณจะได้รับ callback พร้อมข้อความ "first"

มาสร้างบล็อก Start และระบุข้อความที่ต้องการในทริกเกอร์ ในกรณีของเรา: "first"

หากในฟิลด์ Matches คุณเลือก Ignoring errors and inaccuracies บล็อกนี้สามารถนำกลับมาใช้ใหม่ในภายหลังสำหรับรูปแบบที่คล้ายกันทั้งหมดที่แตกต่างกัน 1–2 ตัวอักษร ตัวอย่างเช่น เพื่อขอบคุณผู้ใช้ที่ให้คะแนนด้วยปุ่มดังกล่าว

จากนั้น ในเครื่องคิดเลข ให้ใช้ฟังก์ชัน tg_answer_callback_query และส่งพารามิเตอร์ต่อไปนี้:
callback_query_id - ID นี้ช่วยให้คุณระบุผู้ใช้ที่กดปุ่มและแสดงการแจ้งเตือนแบบ Alert แก่พวกเขา
text - ข้อความของการแจ้งเตือนแบบ Alert

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

tg_answer_callback_query('#{callback_query_id}', "You pressed the button 111")

โปรดทราบ! ควรส่งพารามิเตอร์ callback_query_id ตามที่แสดงในตัวอย่าง นั่นคือ ภายใน '#{}'

หากตั้งค่าทุกอย่างถูกต้อง การกดปุ่มจะส่งผลให้มีการแจ้งเตือนแบบ Alert พร้อมข้อความที่ระบุ ในเวอร์ชันมือถือ ชื่อบอทจะปรากฏเป็นส่วนหัวเหนือข้อความ

หากคุณต้องการแสดง ข้อความป๊อปอัป แบบง่ายแทน ให้ส่ง False เป็นพารามิเตอร์ที่สาม ดังที่แสดงในตัวอย่างด้านล่าง:
tg_answer_callback_query('#{callback_query_id}', "You passed the button 222", False)

tg_callback_url_open(callback_query_id, url, cache_time)

เปิดบอท Telegram โดยใช้ deep link เพื่อตอบสนองต่อ callback ของปุ่ม inline

พารามิเตอร์

สำคัญ

ฟังก์ชันนี้สามารถใช้ได้เฉพาะในการตอบสนองต่อการคลิก ปุ่ม callback แบบ inline ของผู้ใช้ใน Telegram เท่านั้น

ในการตอบกลับปุ่ม callback คุณสามารถเพิ่มการเปลี่ยนไปยังบอทโดยใช้แท็ก tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX')

ตัวอย่างเช่น ลองใช้ปุ่มต่อไปนี้:

[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]

หลังจากคลิกปุ่ม callback จะมาถึงพร้อมกับข้อความที่อยู่ในฟิลด์ที่เกี่ยวข้อง เมื่อคุณคลิกปุ่ม "111" คุณจะได้รับ callback พร้อมข้อความ "first"

สร้างบล็อกที่มีการตรวจสอบเงื่อนไขหลักและระบุข้อความที่ต้องการในเงื่อนไข ในกรณีของเรา: "first":

หากในฟิลด์ Matching option คุณเลือก Ignore errors and inaccuracies บล็อกนี้สามารถนำกลับมาใช้ใหม่ในภายหลังสำหรับรูปแบบที่คล้ายกันทั้งหมดที่แตกต่างกัน 1–2 ตัวอักษร ตัวอย่างเช่น เพื่อขอบคุณผู้ใช้ที่ให้คะแนนด้วยปุ่มดังกล่าว

จากนั้น ในเครื่องคิดเลขของบล็อก ให้ระบุ tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX'):

tg_promote_user(platform_id, user_id, promote_options_list)

เลื่อนผู้ใช้ Telegram เป็นผู้ดูแลในซุปเปอร์กรุ๊ปหรือแชนแนลพร้อมสิทธิ์ที่ระบุ

พารามิเตอร์

หมายเหตุ

เฉพาะสิทธิ์ที่รวมอยู่ใน promote_options_list เท่านั้นที่จะถูกมอบให้กับผู้ใช้

สามารถระบุสิทธิ์ต่อไปนี้ใน promote_options_list :

1. is_anonymous — ซ่อนการปรากฏตัวของผู้ดูแลในแชท
2. can_manage_chat — ผู้ดูแลสามารถเข้าถึงบันทึกเหตุการณ์แชท สถิติแชท สถิติข้อความในแชนแนล ดูสมาชิกแชนแนล ดูผู้ดูแลที่ไม่ระบุชื่อในซุปเปอร์กรุ๊ป และข้ามโหมดช้า สิทธิ์ระดับนี้จะถูกมอบให้โดยค่าเริ่มต้นหากมีการระบุสิทธิ์ย่อยใดๆ ต่อไปนี้
3. can_post_messages — ผู้ดูแลสามารถสร้างโพสต์แชนแนล (เฉพาะแชนแนล)
4. can_edit_messages — ผู้ดูแลสามารถแก้ไขข้อความของผู้ใช้อื่นและปักหมุดข้อความ (เฉพาะแชนแนล)
5. can_delete_messages — ผู้ดูแลสามารถลบข้อความของผู้ใช้อื่น
6. can_manage_video_chats — ผู้ดูแลสามารถจัดการวิดีโอแชท
7. can_restrict_members — ผู้ดูแลสามารถจำกัดสมาชิก แบน/เลิกแบนในแชท
8. can_promote_members — ผู้ดูแลสามารถแต่งตั้งผู้ดูแลใหม่ที่มีสิทธิ์ชุดย่อยของตนเอง หรือลดตำแหน่งผู้ดูแลที่ตนแต่งตั้งโดยตรงหรือโดยอ้อม (เช่น ผู้ดูแลที่ตนแต่งตั้ง)
9. can_change_info — ผู้ดูแลสามารถเปลี่ยนชื่อแชท รูปภาพ และการตั้งค่าอื่นๆ
10. can_invite_users — ผู้ดูแลสามารถเชิญผู้ใช้ใหม่เข้าสู่แชท
11. can_pin_messages — ผู้ดูแลสามารถปักหมุดข้อความ (เฉพาะซุปเปอร์กรุ๊ป)

ตัวอย่าง: การเลื่อนผู้ใช้เป็นผู้ดูแลในซุปเปอร์กรุ๊ป:

ในตัวอย่างนี้ นอกเหนือจากสิทธิ์ที่ระบุ สิทธิ์ can_manage_chat จะถูกมอบให้โดยค่าเริ่มต้น

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

ตัวอย่างที่ 1 
promote_options_list = '[“can_promote_members”,”can_change_info”,”can_invite_users”]' 
tg_promote_user(platform_id, user_id, promote_options_list)

ตัวอย่างที่ 2 
promote_options_list = '["can_manage_chat","can_post_messages","can_edit_messages","can_delete_messages","can_manage_video_chats","can_promote_members","can_restrict_members","can_invite_users","can_pin_messages"]' 
result=tg_promote_user(platform_id, reply_from, promote_options_list)  

tg_set_administrator_title(platform_id, user_id, title)

กำหนดตำแหน่งผู้ดูแลแบบกำหนดเองสำหรับผู้ดูแลซุปเปอร์กรุ๊ป Telegram

พารามิเตอร์

สำคัญ

• ตำแหน่งต้องมีความยาวระหว่าง 0 ถึง 16 ตัวอักษร
• ไม่อนุญาตให้ใช้อีโมจิ ในตำแหน่ง
• ฟังก์ชันนี้ทำงาน เฉพาะกับผู้ดูแลที่ถูกเลื่อนโดยบอทเท่านั้น

ตัวอย่าง

result = tg_set_administrator_title(platform_id, reply_from, "firetitle")

tg_chat_permission(platform_id, permission, media_permissions)

ตั้งค่าสิทธิ์เริ่มต้นสำหรับสมาชิกในแชท Telegram

พารามิเตอร์

หมายเหตุ

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

• 1 — อนุญาตสิทธิ์
• 0 — ปฏิเสธสิทธิ์

รายการข้อจำกัดสำหรับ permission:

1. can_send_messages - สิทธิ์ในการส่งข้อความ รายชื่อติดต่อ สถานที่ และสถานที่
2. can_send_media_messages - สิทธิ์ในการส่งเสียง เอกสาร รูปภาพ วิดีโอ วิดีโอโน้ต และวอยซ์โน้ต ต้องมี can_send_messages
3. can_send_polls - สิทธิ์ในการส่งโพล ต้องมี can_send_messages
4. can_send_other_messages - สิทธิ์ในการส่งแอนิเมชัน เกม สติกเกอร์ และใช้บอทอินไลน์ ต้องมี can_send_media_messages
5. can_add_web_page_previews - สิทธิ์ในการเพิ่มตัวอย่างหน้าเว็บในข้อความ ต้องมี can_send_media_messages
6. can_change_info - สิทธิ์ในการเปลี่ยนชื่อแชท รูปภาพ และการตั้งค่าอื่นๆ ตัวเลือกนี้จะถูกเพิกเฉยในซุปเปอร์กรุ๊ปสาธารณะ
7. can_invite_users - สิทธิ์ในการเชิญผู้ใช้
8. can_pin_messages - สิทธิ์ในการปักหมุดข้อความ ตัวเลือกนี้จะถูกเพิกเฉยในซุปเปอร์กรุ๊ปสาธารณะ
9. can_manage_topics - สิทธิ์ในการสร้างหัวข้อในกลุ่มฟอรัม หากใช้ในกลุ่มประเภทที่ไม่ถูกต้อง ฟังก์ชันจะล้มเหลวและส่งคืนข้อผิดพลาด

ค่าสำหรับการให้สิทธิ์ที่เกี่ยวข้องกับสื่อ media_permissions:

1. can_send_audios - สิทธิ์ในการส่งไฟล์เสียง
2. can_send_documents - สิทธิ์ในการส่งเอกสาร
3. can_send_photos - สิทธิ์ในการส่งรูปภาพ
4. can_send_videos - สิทธิ์ในการส่งวิดีโอ
5. can_send_video_notes - สิทธิ์ในการส่งข้อความวิดีโอแบบกลม
6. can_send_voice_notes - สิทธิ์ในการส่งข้อความเสียง

tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions).

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

รายการข้อจำกัดสำหรับ permission:

1. can_send_messages - สิทธิ์ในการส่งข้อความ รายชื่อติดต่อ สถานที่ และสถานที่
2. can_send_media_messages - สิทธิ์ในการส่งเสียง เอกสาร รูปภาพ วิดีโอ วิดีโอโน้ต และวอยซ์โน้ต ต้องมี can_send_messages
3. can_send_polls - สิทธิ์ในการส่งโพล ต้องมี can_send_messages
4. can_send_other_messages - สิทธิ์ในการส่งแอนิเมชัน เกม สติกเกอร์ และใช้บอทอินไลน์ ต้องมี can_send_media_messages
5. can_add_web_page_previews - สิทธิ์ในการเพิ่มตัวอย่างหน้าเว็บในข้อความ ต้องมี can_send_media_messages
6. can_change_info - สิทธิ์ในการเปลี่ยนชื่อแชท รูปภาพ และการตั้งค่าอื่นๆ ตัวเลือกนี้จะถูกเพิกเฉยในซุปเปอร์กรุ๊ปสาธารณะ
7. can_invite_users - สิทธิ์ในการเชิญผู้ใช้
8. can_pin_messages - สิทธิ์ในการปักหมุดข้อความ ตัวเลือกนี้จะถูกเพิกเฉยในซุปเปอร์กรุ๊ปสาธารณะ
9. can_manage_topics - สิทธิ์ในการสร้างหัวข้อในกลุ่มฟอรัม หากใช้ในกลุ่มประเภทที่ไม่ถูกต้อง ฟังก์ชันจะล้มเหลวและส่งคืนข้อผิดพลาด

ค่าสำหรับการให้สิทธิ์ที่เกี่ยวข้องกับสื่อ media_permissions:

1. can_send_audios - สิทธิ์ในการส่งไฟล์เสียง
2. can_send_documents - สิทธิ์ในการส่งเอกสาร
3. can_send_photos - สิทธิ์ในการส่งรูปภาพ
4. can_send_videos - สิทธิ์ในการส่งวิดีโอ
5. can_send_video_notes - สิทธิ์ในการส่งข้อความวิดีโอแบบกลม
6. can_send_voice_notes - สิทธิ์ในการส่งข้อความเสียง

ตัวอย่างการใช้ฟังก์ชัน โดยผู้ใช้ถูกจำกัดทุกอย่างเป็นเวลา 3 นาที:

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

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

permission = [0, 0, 0, 0, 0, 0, 0, 0] 
tg_restrict_chat_member(-1001607137668, 473737685, 3, permission)

tg_pin_chat_message(platform_id, message_id, disable_notification)

ปักหมุดข้อความในแชท Telegram

พารามิเตอร์

หมายเหตุ

การแจ้งเตือนจะถูกปิดใช้งานเสมอใน แชนเนล และ แชทส่วนตัว โดยไม่คำนึงถึงค่าของ disable_notification

tg_unpin_chat_message(platform_id, message_id)

ถอนหมุดข้อความในแชท Telegram

พารามิเตอร์

หมายเหตุ

หากไม่ได้ระบุ message_id ฟังก์ชันจะถอนหมุดข้อความที่ปักหมุดล่าสุดตามเวลาที่ส่ง

tg_unpin_all(platform_id)

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

คำเตือน!

Telegram มีข้อจำกัดสำหรับฟังก์ชันปักหมุด/ถอนหมุดข้อความ

ระบบ MaviBot ไม่ได้กำหนดขีดจำกัดเวลา สำหรับการใช้ tg_pin_chat_message / tg_unpin_chat_message / tg_unpin_all ****

หากเวลาที่อนุญาตสำหรับการปักหมุดข้อความผ่านไปแล้ว ฟังก์ชันจะยังคงคืนค่า true แต่ Telegram จะไม่นำการเปลี่ยนแปลงไปใช้

สิ่งสำคัญที่ต้องทราบคือข้อความที่ปักหมุดอาจยังคงอยู่ในแคช ดังนั้นอาจไม่หายไปจากภาพทันที

tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)

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

หมายเหตุ

1. ฟังก์ชันจะคืนค่าการตอบกลับจาก Telegram พร้อม message_id ควรบันทึกไว้ ใช้ message_id เพื่อหยุดโพลด้วย tg_stop_poll (ดูคำอธิบายด้านล่าง) และรับผลลัพธ์

2. หากผู้ใช้เพิ่มโพลในเมสเซนเจอร์ จะมีการส่งคอลแบ็กไปยังแชท:

poll_added - ส่วนที่ไม่เปลี่ยนแปลง
YOUR QUESTION - ข้อความคำถามจากโพล

ตัวอย่างคอลแบ็กเมื่อเพิ่มโพลในแชนเนล

ตัวอย่างคอลแบ็กเมื่อเพิ่มโพลในแชท

คอลแบ็กที่สองหลังจาก poll_added มีตัวเลข - นี่คือ ID ผู้ใช้ใน Telegram ที่เพิ่มโพล

เมื่อสร้างโพลโดยบอท จะไม่ได้รับคอลแบ็ก

3. ในแชนเนลสามารถสร้างได้เฉพาะโพลที่ไม่ระบุชื่อเท่านั้น

โปรดทราบ แนะนำให้ส่งเฉพาะโพลที่ไม่ระบุชื่อไปยังกลุ่ม!

4. หลังจากสร้างโพล ให้บันทึก ID ของโพลลงในตัวแปร เพื่อให้ทราบว่าโพลใดที่ได้รับคอลแบ็ก

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

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

/* Example of creating a simple poll */
options = ["white", "red", "blue", "green"]
poll1 = tg_send_poll(platform_id, 'What is your favorite color?', options, 1, '', '', 1, '')

ฟังก์ชันสำหรับสร้างโพลใน Telegram:

โพลที่เราสร้างใน Telegram

tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )

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

หมายเหตุ

1. บันทึก message_id

ฟังก์ชัน API จะคืนค่าการตอบกลับจาก Telegram ที่มี message_id บันทึก ID นี้เสมอ เนื่องจากจำเป็นสำหรับ:

• สิ้นสุดแบบทดสอบโดยใช้ฟังก์ชัน tg_stop_poll (ดูคำอธิบายด้านล่าง)
• ดึงผลลัพธ์สุดท้าย

2. คอลแบ็ก poll_added

หากผู้ใช้เพิ่มโพลใน แชนเนล บอทจะได้รับคอลแบ็ก:

• รูปแบบ: poll_added + คำถามโพล
• หากเพิ่มในแชทกลุ่ม: คอลแบ็กจะรวม ID ผู้ใช้ Telegram ของผู้ที่เพิ่มโพลด้วย

หากสร้างโดยบอท: จะไม่มีการส่งคอลแบ็ก poll_added

3. ข้อจำกัดของแชนเนล

สามารถสร้าง แบบทดสอบที่ไม่ระบุชื่อ เท่านั้นในแชนเนล

4. คอลแบ็ก poll_answer (การโหวตของผู้ใช้)

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

• รูปแบบ: poll_answer + ID โพล + [ดัชนีคำตอบ]
• ตัวอย่าง: poll_answer 5325838371359031648 [3]
• หมายเหตุ: การนับคำตอบเริ่มจาก 0 [3] หมายถึงผู้ใช้เลือกตัวเลือกคำตอบที่สี่

5. เว็บฮุกสำหรับโพลกลุ่มที่ไม่ระบุชื่อ

สำหรับ โพลที่ไม่ระบุชื่อ ในกลุ่มที่บอทเป็นผู้ดูแล จะมีการส่งเว็บฮุกสำหรับ ทุกการโหวต เมื่อได้รับ บอทจะส่งต่อคอลแบ็ก poll_answer (ตามข้อ 4) ไปยังบทสนทนากับไคลเอนต์ที่เกี่ยวข้อง

6. ข้อกำหนดการเปิดใช้งานและแนวทางปฏิบัติที่ดีที่สุด

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

คำแนะนำ: เพื่อหลีกเลี่ยงข้อจำกัดนี้ ขอแนะนำอย่างยิ่งให้ส่งเฉพาะแบบทดสอบที่ไม่ระบุชื่อไปยังกลุ่ม

7. ติดตามโพลของคุณ

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

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

options = ["white", "red", "blue", "green"] 
r = tg_send_quiz_poll(platform_id, "What color is a crocodile?", options, "That is the explanation", 4, '', '', '', '', 1)

ตัวอย่าง: การสร้างแบบทดสอบ

tg_stop_poll(platform_id, message_id)

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

การเรียกฟังก์ชันนี้เพื่อสิ้นสุดโพล/แบบทดสอบจะคืนค่าดิกชันนารีที่มีผลลัพธ์สุดท้าย

tg_edit_general_forum_topic(platform_id, topic_name)

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

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

/เปลี่ยนชื่อแชทหัวข้อทั่วไป/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')

tg_close_general_forum_topic(platform_id)

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

/ปิดแชทหัวข้อทั่วไป/
answer = tg_close_general_forum_topic(-1001839380031)

tg_reopen_general_forum_topic(platform_id)

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

/เปิดแชทหัวข้อทั่วไปอีกครั้ง/
answer = tg_reopen_general_forum_topic(-1001839380031)

tg_hide_general_forum_topic(platform_id)

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

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

/ซ่อนแชทหัวข้อทั่วไป/
answer = tg_hide_general_forum_topic(-1001839380031)

tg_unhide_general_forum_topic(platform_id)

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

**สำคัญ! **

ฟังก์ชันนี้ไม่ได้เปิดหัวข้อทั่วไปอีกครั้ง แต่ทำให้มองเห็นได้เท่านั้น

/แสดงแชทหัวข้อทั่วไป/
answer = tg_unhide_general_forum_topic(-1001839380031)

tg_create_forum_topic(platform_id, name, icon, icon_color)

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

ไม่สามารถเปลี่ยนสีที่ตั้งไว้ได้ สามารถกำหนดสีได้เฉพาะเมื่อสร้างหัวข้อเท่านั้น

เมื่อดำเนินการ ฟังก์ชันจะส่งคืนการตอบกลับที่มีพารามิเตอร์ของหัวข้อใหม่ รวมถึง ID หัวข้อ (จำเป็นสำหรับฟังก์ชันต่างๆ)

เพื่อสร้างแชทหัวข้อเพิ่มเติม
answer = tg_create_forum_topic(-1001839380031, 'second_bot_topic', None, 7322096)

เพื่อบันทึก ID แชทหัวข้อเพิ่มเติมที่สร้างขึ้น
answer={"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}/
idtema1=answer['result']['message_thread_id']

tg_edit_forum_topic(platform_id, message_thread_id, name, icon)

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

answer = tg_edit_forum_topic(-1001839380031, 254)

การปิดหัวข้อหมายถึงการทำให้เป็นแบบอ่านอย่างเดียว ไม่อนุญาตให้เขียนในหัวข้อที่ปิด

tg_close_forum_topic(platform_id, message_thread_id)

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

answer = tg_close_forum_topic(-1001839380031, 254)

tg_reopen_forum_topic(platform_id, message_thread_id)

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

answer = tg_reopen_forum_topic(-1001839380031, 254)

tg_delete_forum_topic(platform_id, message_thread_id)

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

answer = tg_delete_forum_topic(-1001839380031, 254)

tg_unpin_topic_messages(platform_id, message_thread_id)

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

answer = tg_unpin_topic_messages(-1001839380031, 254)

วิธีรับรายการอิโมจิ

tg_get_forum_icon() – ฟังก์ชันนี้จะส่งคืนรายการอิโมจิที่สามารถใช้เป็นไอคอนหัวข้อฟอรัมได้ ผลลัพธ์ต้องถูกกำหนดให้กับตัวแปร เนื่องจากฟังก์ชันส่งคืนพจนานุกรมที่แต่ละคีย์คืออิโมจิ และค่าที่สอดคล้องกันคือตัวระบุเฉพาะ (id) ของอิโมจิ

พารามิเตอร์: ไม่มี

หากต้องการรับรายการอิโมจิสำหรับแชทหัวข้อ ให้ส่งคำสั่งไปยังแชทที่เกี่ยวข้อง

ฟังก์ชันจะส่งคืนรายการอิโมจิในการตอบกลับ ซึ่งหมายความว่าตัวแปร answer จะมีพจนานุกรมเป็นค่า

{'📰': '5434144690511290129', '💡': '5312536423851630001', '⚡️': '5312016608254762256', '🎙': '5377544228505134960', '🔝': '5418085807791545980', '🗣': '5368697802761185083', '🆒': '5420216386448270341', '❗️': '5379748062124056162', '📝': '5357193964787081133', '📆': '5433614043006903194', '📁': '5357315181649076022', '🔎': '5309965701241379366', '📣': '5309984423003823246', '🔥': '5312241539987020022', '❤️': '5312138559556164615', '❓': '5377316857231450742', '📈': '5350305691942788490', '📉': '5350713563512052787', '💎': '5309958691854754293', '💰': '5350452584119279096', '💸': '5309929258443874898', '\U0001fa99': '5377690785674175481', '💱': '5310107765874632305', '⁉️': '5377438129928020693', '🎮': '5309950797704865693', '💻': '5350554349074391003', '📱': '5409357944619802453', '🚗': '5312322066328853156', '🏠': '5312486108309757006', '💘': '5310029292527164639', '🎉': '5310228579009699834', '‼️': '5377498341074542641', '🏆': '5312315739842026755', '🏁': '5408906741125490282', '🎬': '5368653135101310687', '🎵': '5310045076531978942', '🔞': '5420331611830886484', '📚': '5350481781306958339', '👑': '5357107601584693888', '⚽️': '5375159220280762629', '🏀': '5384327463629233871', '📺': '5350513667144163474', '👀': '5357121491508928442', '\U0001fae6': '5357185426392096577', '🍓': '5310157398516703416', '💄': '5310262535021142850', '👠': '5368741306484925109', '✈️': '5348436127038579546', '\U0001f9f3': '5357120306097956843', '🏖': '5310303848311562896', '⛅️': '5350424168615649565', '🦄': '5413625003218313783', '🛍': '5350699789551935589', '👜': '5377478880577724584', '🛒': '5431492767249342908', '🚂': '5350497316203668441', '🛥': '5350422527938141909', '🏔': '5418196338774907917', '🏕': '5350648297189023928', '🤖': '5309832892262654231', '\U0001faa9': '5350751634102166060', '🎟': '5377624166436445368', '🏴\u200d☠️': '5386395194029515402', '🗳': '5350387571199319521', '🎓': '5357419403325481346', '🔭': '5368585403467048206', '🔬': '5377580546748588396', '🎶': '5377317729109811382', '🎤': '5382003830487523366', '🕺': '5357298525765902091', '💃': '5357370526597653193', '\U0001fa96': '5357188789351490453', '💼': '5348227245599105972', '\U0001f9ea': '5411138633765757782', '👨\u200d👩\u200d👧\u200d👦': '5386435923204382258', '👶': '5377675010259297233', '🤰': '5386609083400856174', '💅': '5368808634392257474', '🏛': '5350548830041415279', '\U0001f9ee': '5355127101970194557', '🖨': '5386379624773066504', '👮\u200d♂️': '5377494501373780436', '\U0001fa7a': '5350307998340226571', '💊': '5310094636159607472', '💉': '5310139157790596888', '\U0001f9fc': '5377468357907849200', '\U0001faaa': '5418115271267197333', '🛃': '5370947704199323325', '🍽': '5350344462612570293', '🐟': '5384574037701696503', '🎨': '5310039132297242441', '🎭': '5350658016700013471', '🎩': '5357504778685392027', '🔮': '5350367161514732241', '🍹': '5350520238444126134', '🎂': '5310132165583840589', '☕️': '5350392020785437399', '🍣': '5350406176997646350', '🍔': '5350403544182694064', '🍕': '5350444672789519765', '\U0001f9a0': '5312424913615723286', '💬': '5417915203100613993', '🎄': '5312054580060625569', '🎃': '5309744892677727325'}

answer = tg_get_forum_icon()