Přeskočit na hlavní obsah

Vytvoření bota

Zveřejňuj do kanálu přes webhook, dej komunitě vlastní příkazy s lomítkem a přidej pod karty tlačítka.

Díky třem stavebním kamenům může tvoje vlastní služba promlouvat ve tvé komunitě. Fungují společně: jedna integrace může zveřejnit kartu, odpovědět na /příkaz, zareagovat na tlačítko a aktualizovat vlastní zprávu.

Stavební kameny

  • Webhooky: URL, která zveřejňuje do kanálu. Tvoje služba na ni pošle JSON a zpráva se objeví pod jménem, které webhooku dáš. Ideální pro upozornění: výsledky CI, monitoring, tikety.
  • Triggery: vlastní příkazy s lomítkem tvé komunity. Člen napíše /weather, mssgs pošle zprávu tvé webové službě a to, co odpoví, se v kanálu objeví jako karta.
  • Tlačítka: pod kartou otevřou odkaz, změní kartu pro všechny nebo spustí některý z tvých triggerů (viz Karty a tlačítka botů).

Zveřejni první zprávu

1
V desktopové aplikaci otevři ve své komunitě Manage Server → Webhooks a klikni na Add Webhook.
2
Pojmenuj ho, v Channels vyber kanály, do kterých smí zveřejňovat, zkopíruj Webhook Secret a klikni na Create Webhook.
3
Klikni na ikonu odkazu vedle webhooku (View webhook URL), v Channel vyber kanál a zkopíruj URL.
4
Pošli na tuto URL JSON metodou POST, podepsaný tajným klíčem. Zpráva se v kanálu objeví okamžitě.
BODY='{"content": "Build #1847 passed on main"}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$MSSGS_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST "$MSSGS_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -H "X-Mssgs-Signature: sha256=$SIG" \
  -d "$BODY"
URL i tajný klíč drž v soukromí. Dohromady umožňují komukoli zveřejňovat v tom kanálu, takže je nedávej do veřejných repozitářů ani do kódu na straně klienta. Požadavek bez platného podpisu je odmítnut.

Zveřejňuješ z GitHubu? K tomu nepotřebuješ žádný kód: nasměruj webhook GitHubu na tuto URL a vlož tajný klíč do jeho pole Secret. Viz integrace.

Přidej příkaz s lomítkem

1
Otevři Manage Server → Triggers a klikni na Create Trigger.
2
Vyplň Word to Match, například /weather, a URL Endpoint své webové služby. V Allowed User Groups můžeš příkaz vyhradit jen určitým rolím.
3
Když člen pošle zprávu začínající na /weather, mssgs ji odešle metodou POST na tvou URL. Odpověz do 5 sekund JSONem a odpověď se v kanálu objeví jako karta.

Potřebuješ víc času? Odpověz hned kartou s loaderem a dokonči ji přes callback_url z požadavku, která funguje 30 minut. Karta ukazuje název tvé komunity a její patička říká, kdo použil jaký příkaz.

Bot jako samostatný člen

Chceš, aby byl bot samostatným členem, se jménem, avatarem a štítkem BOT? Vytvoř účet bota propojený s tvým vlastním účtem a spravuj ho z panelu botů. Když je desktopová aplikace přihlášená jako bot, AI asistent může přes její MCP server zveřejňovat karty s tlačítky.

Každé pole, odpověď a chybový kód najdeš v dokumentaci pro vývojáře: webhooky, příkazy s lomítkem, karty zpráv, tlačítka a živé aktualizace. A pokud chceš chování řízené AI bez jakéhokoli programování, možná ti bude stačit cesta přes MCP.

Pomohl ti tento článek?

Nenašel jsi, co hledáš? Rádi ti pomůžeme.

Zeptej se nás

Pořád potřebuješ pomoct?

Náš tým podpory obvykle odpoví do 24 hodin.

Kontaktuj podporu