Navigácia
ELOWEN · Dokumentácia

Posledná aktualizácia: 27. októbra 2026

Prechádzať dokumentáciu · Nástroje Discordu
Kanály a chatboty

Nástroje Discordu

Pozrite si, čo bot Discordu vie na Vašom serveri, ktoré oprávnenia Discordu potrebuje a koľko výstupu ktorý nástroj vracia.

Nástroje len na čítanie

  • DiscordListChannels vypisuje kanály a vlákna. Začnite tu, keď potrebujete ID kanála.
  • DiscordReadChannel číta posledné správy.
  • DiscordServerInfo a DiscordChannelInfo opisujú server a jeden kanál.
  • DiscordMemberInfo, DiscordSearchMembers, DiscordListMembers a DiscordListRoles čítajú ľudí a roly.
  • DiscordListPins vypisuje pripnuté správy.

DiscordSearchMembers hľadá podľa začiatku mena a DiscordListMembers potrebuje zámer Server Members.

Nástroje na správu

  • Správy a pripnutia: DiscordPinMessage, DiscordUnpinMessage, DiscordDeleteMessage, DiscordPurgeMessages.
  • Roly: DiscordAssignRole, DiscordRemoveRole.
  • Vlákna: DiscordCreateThread, DiscordArchiveThread, DiscordLockThread, DiscordAddThreadMember, DiscordRemoveThreadMember.
  • Kanály: DiscordCreateChannel, DiscordCreateCategory, DiscordRenameChannel, DiscordDeleteChannel.
  • DiscordApi odošle akúkoľvek požiadavku Discord REST API v10, ktorú bot smie volať.

Nástroje kanálov vedia vytvoriť textové, hlasové, oznamovacie, stage a fórové kanály a verejné vlákna. DiscordApi použite len vtedy, keď úlohu nepokrýva žiadny štruktúrovaný nástroj: je mocný a vymazanie správ alebo kanálov sa nedá vrátiť.

Čo bot vidí a čo môže zmeniť

  • Na každú akciu potrebuje bot zodpovedajúce oprávnenie Discordu. Bez neho volanie zlyhá s chybovým textom od Discordu.
  • Najvyššia rola bota musí byť vyššie ako rola, ktorú prideľuje alebo odoberá.
  • Viacero popisov nástrojov spomína administrátorskú reláciu. Plugin túto reláciu nekontroluje; požiadavka je súčasťou toho, ako má agent nástroj použiť.
  • Výpisy pre celý server potrebujú zámer Server Members.
  • DiscordPurgeMessages predvolene ponecháva pripnuté správy a agenta žiada, aby najskôr spustil skúšobný beh. Nástroj toto poradie nevynucuje, takže si cieľ pred skutočným behom skontrolujte.

Limity

Nástroj Limit
DiscordReadChannel Až 100 posledných správ; najstaršie sa môžu vynechať, keď text presiahne 6 000 znakov.
DiscordListMembers Predvolene 50 členov, najviac 200.
DiscordListPins Náhľady správ po 120 znakoch; kanál môže mať najviac 50 pripnutých správ.
DiscordPurgeMessages Predvolene 100 posledných správ, najviac 5 000; správy mladšie ako 14 dní sa mažú hromadne, staršie po jednej.
DiscordApi Výstup skrátený na 4 000 znakov; volania s obmedzením rýchlosti sa opakujú najviac trikrát.
Každá odpoveď Dlhé odpovede sa delia na správy s najviac 1 990 znakmi.