Discord

Co integrace přidá

Po přidání vznikne notifikační akce podle názvu Discord aplikace. Umí posílat text, přílohy z lokální cesty, soubory ze vzdálených URL a bohatě formátované embed zprávy.

Integrace je pouze pro odchozí zprávy. Pokud potřebujete reagovat na příchozí příkazy, použijte jiný mechanismus automatizace.

Příprava bota

V Discord Developer Portal vytvořte aplikaci, přidejte bot uživatele, poznamenejte si Application ID a zkopírujte skrytý bot token.

Bota přidejte na server s potřebnými oprávněními. Zapněte Developer Mode a zkopírujte ID kanálu nebo uživatele, kam se mají zprávy posílat.

Nastavení v RichPear Home

Otevřete Nastavení, Zařízení a služby, Přidat integraci a vyhledejte Discord. Do pole Token API vložte bot token.

Po dokončení uložte cílová ID kanálů do automatizací nebo skriptů. Jedno ID se zadává jako řetězec, více ID jako seznam.

Zprávy a přílohy

Pole message se posílá jako doslovný text. Když do něj vložíte uvozovky, zobrazí se v Discordu také.

action: notify.discord_chat
data:
  message: "Pračka dokončila program."
  target: "123456789012345678"

Rozšířená data

V části data lze použít images, urls, verify_ssl a embed. Embed může obsahovat titul, popis, barvu, URL, autora, patičku, náhled, obrázek a pole.

Pro označení uživatele použijte tvar <@userID>, pro roli <@&roleID> a pro kanál <#channelID>.

Provoz a bezpečnost

Bot token ukládejte jako tajný údaj. Pokud se token zobrazí ve sdíleném logu nebo screenshotu, vygenerujte nový a starý zneplatněte.

Bota držte jen v serverech, kde ho opravdu potřebujete, a dejte mu pouze oprávnění nutná pro posílání zpráv.

Řešení problémů

Když zprávy nechodí, ověřte token, oprávnění bota v kanálu, správné ID cíle a to, že voláte správnou notifikační akci. U příloh ověřte dostupnost souboru a velikostní limity Discordu.