Discord

დაუკავშირეთ PRX Discord-ს ბოტის აპლიკაციის გამოყენებით Gateway WebSocket-ით რეალურ დროში შეტყობინებების მისაღებად სერვერებსა და პირად შეტყობინებებში.

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

• Discord ანგარიში
• Discord აპლიკაცია ბოტის მომხმარებლით, შექმნილი დეველოპერ პორტალში
• ბოტი მოწვეული თქვენს სერვერზე შესაბამისი ნებართვებით

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

1. ბოტის აპლიკაციის შექმნა

1. გადადით Discord დეველოპერ პორტალში
2. დააწკაპუნეთ "New Application" და დაარქვით სახელი
3. გადადით "Bot" სექციაში და დააწკაპუნეთ "Add Bot"
4. დააკოპირეთ ბოტის ტოკენი
5. "Privileged Gateway Intents"-ში ჩართეთ Message Content Intent

2. ბოტის მოწვევა

შექმენით მოწვევის URL "OAuth2 > URL Generator"-ში:

• Scopes: bot
• Permissions: Send Messages, Read Message History, Add Reactions, Attach Files

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

[channels_config.discord]
bot_token = "MTIzNDU2Nzg5.XXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
allowed_users = ["123456789012345678"]

4. შემოწმება

prx channel doctor discord

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

ველი	ტიპი	ნაგულისხმევი	აღწერა
bot_token	String	სავალდებულო	Discord ბოტის ტოკენი დეველოპერ პორტალიდან
guild_id	String	null	არასავალდებულო გილდიის (სერვერის) ID ბოტის ერთ სერვერზე შესაზღუდად
allowed_users	[String]	[]	Discord მომხმარებლის ID-ები. ცარიელი = ყველას უარყოფა. "*" = ყველას დაშვება
listen_to_bots	bool	false	ჩართვისას ამუშავებს სხვა ბოტების შეტყობინებებს (საკუთარს მაინც იგნორირებს)
mention_only	bool	false	ჩართვისას პასუხობს მხოლოდ @-მოხსენიებით შეტყობინებებს

ფუნქციები

• Gateway WebSocket -- რეალურ დროში შეტყობინებების მიტანა Discord-ის Gateway API-ის მეშვეობით
• სერვერისა და პირადი შეტყობინებების მხარდაჭერა -- პასუხობს გილდიის არხებსა და პირად შეტყობინებებში
• ტექსტური დანართების დამუშავება -- ავტომატურად მოიძიებს და ჩაშვებს text/* დანართებს
• გილდიის შეზღუდვა -- არასავალდებულოდ შეზღუდეთ ბოტი ერთ სერვერზე guild_id-ით
• ბოტი-ბოტს კომუნიკაცია -- ჩართეთ listen_to_bots მრავალბოტიანი სამუშაო პროცესებისთვის
• აკრეფის ინდიკატორები -- აჩვენებს აკრეფის სტატუსს პასუხის გენერირებისას

შეზღუდვები

• Discord შეტყობინებები 2000 სიმბოლოთი არის შეზღუდული (PRX ავტომატურად ყოფს გრძელ პასუხებს)
• მხოლოდ text/* MIME ტიპის დანართები მოიძიება და ჩაიშვება; სხვა ფაილის ტიპები გამოტოვდება
• "Message Content Intent" უნდა იყოს ჩართული, რათა ბოტმა შეტყობინების ტექსტი წაიკითხოს
• საჭიროა სტაბილური WebSocket კავშირი Discord-ის Gateway-სთან

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

ბოტი ონლაინია, მაგრამ არ პასუხობს

• დარწმუნდით, რომ "Message Content Intent" ჩართულია დეველოპერ პორტალში ბოტის პარამეტრებში
• შეამოწმეთ გამგზავნის Discord მომხმარებლის ID allowed_users-ში
• შეამოწმეთ, რომ ბოტს აქვს Send Messages და Read Message History ნებართვები არხში

ბოტი მხოლოდ ზოგიერთ არხში მუშაობს

• თუ guild_id მითითებულია, ბოტი მხოლოდ ამ კონკრეტულ სერვერში პასუხობს
• შეამოწმეთ, რომ ბოტი მოწვეულია სწორი ნებართვებით თითოეული არხისთვის

სხვა ბოტების შეტყობინებები იგნორირდება

• მითითეთ listen_to_bots = true სხვა ბოტის ანგარიშებიდან შეტყობინებების დასამუშავებლად
• ბოტი ყოველთვის იგნორირებს საკუთარ შეტყობინებებს უკუკავშირის ციკლების თავიდან ასაცილებლად