Telegram

დაუკავშირეთ PRX Telegram-ს ოფიციალური Bot API-ის გამოყენებით პირადი შეტყობინებების, ჯგუფების, სტრიმინგ პასუხებისა და მედია დანართების მხარდაჭერით.

წინაპირობები

• Telegram ანგარიში
• ბოტის ტოკენი @BotFather-ისგან
• ნებადართული მომხმარებლების Telegram-ის მომხმარებლის ID-ები ან სახელები

სწრაფი დაყენება

1. ბოტის შექმნა

1. გახსენით Telegram და მიწერეთ @BotFather-ს
2. გაგზავნეთ /newbot და მიჰყევით მოწვევებს ბოტის დასახელებისთვის
3. დააკოპირეთ ბოტის ტოკენი (ფორმატი: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)

2. კონფიგურაცია

დაამატეთ შემდეგი თქვენს PRX კონფიგურაციის ფაილში:

[channels_config.telegram]
bot_token = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
allowed_users = ["123456789", "your_username"]

თუ allowed_users ცარიელი დარჩა, PRX შედის დაწყვილების რეჟიმში და გენერირებს ერთჯერად მიბმის კოდს. გაგზავნეთ /bind <code> თქვენი Telegram ანგარიშიდან დასაწყვილებლად.

3. შემოწმება

prx channel doctor telegram

კონფიგურაციის მითითება

ველი	ტიპი	ნაგულისხმევი	აღწერა
bot_token	String	სავალდებულო	Telegram Bot API ტოკენი @BotFather-ისგან
allowed_users	[String]	[]	Telegram მომხმარებლის ID-ები ან სახელები. ცარიელი = დაწყვილების რეჟიმი. "*" = ყველას დაშვება
stream_mode	String	"none"	სტრიმინგის რეჟიმი: "none", "edit" ან "typing". რედაქტირების რეჟიმი თანდათანობით ანახლებს პასუხის შეტყობინებას
draft_update_interval_ms	u64	500	მინიმალური ინტერვალი (მილიწამებში) შავი ვერსიის შეტყობინების რედაქტირებებს შორის რეიტ ლიმიტების თავიდან ასაცილებლად
interrupt_on_new_message	bool	false	ჩართვისას იგივე გამგზავნის ახალი შეტყობინება აუქმებს მიმდინარე მოთხოვნას
mention_only	bool	false	ჩართვისას პასუხობს მხოლოდ @-მოხსენიებებს ჯგუფებში. პირადი შეტყობინებები ყოველთვის მუშავდება
ack_reactions	bool	მემკვიდრეობითი	გლობალური ack_reactions პარამეტრის გადაფარვა. თუ მითითებული არ არის, უკან ბრუნდება [channels_config].ack_reactions-ზე

ფუნქციები

• პირადი შეტყობინებები და ჯგუფური ჩატები -- პასუხობს პირად შეტყობინებებსა და ჯგუფურ საუბრებს
• სტრიმინგ პასუხები -- თანდათანობითი შეტყობინების რედაქტირებები აჩვენებს პასუხს მისი გენერირებისას
• დაწყვილების რეჟიმი -- უსაფრთხო ერთჯერადი კოდით მიბმა, როდესაც ნებადართული მომხმარებლები კონფიგურირებული არ არის
• მედია დანართები -- ამუშავებს დოკუმენტებს, ფოტოებსა და წარწერებს
• გრძელი შეტყობინებების გაყოფა -- ავტომატურად ყოფს Telegram-ის 4096 სიმბოლოს ლიმიტს აღემატებულ პასუხებს სიტყვების საზღვრებზე
• დადასტურების რეაქციები -- რეაგირებს შემომავალ შეტყობინებებზე მიღების დასადასტურებლად
• ხმოვანი ტრანსკრიფცია -- ტრანსკრიბირებს ხმოვან შეტყობინებებს STT-ის კონფიგურაციისას

შეზღუდვები

• Telegram ტექსტურ შეტყობინებებს 4096 სიმბოლოთი ზღუდავს (PRX ავტომატურად ყოფს გრძელ შეტყობინებებს)
• Bot API-ის პოლინგი მცირე შეყოვნებას ქმნის webhook რეჟიმთან შედარებით
• ბოტებს არ შეუძლიათ საუბრების წამოწყება; მომხმარებლებმა ჯერ ბოტს უნდა მისწერონ
• ფაილების ატვირთვა Bot API-ის მეშვეობით 50 MB-ით არის შეზღუდული

პრობლემების მოგვარება

ბოტი არ პასუხობს შეტყობინებებს

• შეამოწმეთ ბოტის ტოკენის სისწორე prx channel doctor telegram-ით
• დარწმუნდით, რომ გამგზავნის მომხმარებლის ID ან სახელი allowed_users-შია
• თუ allowed_users ცარიელია, ჯერ გამოიყენეთ /bind <code> დასაწყვილებლად

რეიტ ლიმიტის შეცდომები სტრიმინგისას

• გაზარდეთ draft_update_interval_ms (მაგ., 1000-მდე ან მეტი)
• Telegram აღასრულებს თითო-ჩატის რეიტ ლიმიტებს შეტყობინების რედაქტირებებზე

ბოტი პასუხობს პირადებში, მაგრამ ჯგუფებში არა

• დარწმუნდით, რომ mention_only მითითებულია false-ზე, ან @-მოხსენიეთ ბოტი
• BotFather-ში გამორთეთ "Group Privacy" რეჟიმი, რათა ბოტმა ჯგუფის ყველა შეტყობინება იხილოს