Preskočiť na hlavný obsah

Vytvorenie bota

Posielaj správy do kanála cez webhook, daj komunite príkazy s lomkou a pridaj pod karty tlačidlá.

Tri stavebné prvky umožnia tvojej vlastnej službe hovoriť v tvojej komunite. Fungujú spolu: jedna integrácia môže poslať kartu, odpovedať na /príkaz, zareagovať na tlačidlo a aktualizovať vlastnú správu.

Stavebné prvky

  • Webhooky: URL adresa, ktorá posiela správy do kanála. Tvoja služba na ňu pošle JSON a správa sa objaví pod názvom, ktorý dáš webhooku. Ideálne na upozornenia: výsledky CI, monitoring, tikety.
  • Triggery: vlastné príkazy s lomkou tvojej komunity. Člen napíše /weather, mssgs pošle správu tvojej webovej službe a jej odpoveď sa objaví v kanáli ako karta.
  • Tlačidlá: pod kartou otvárajú odkaz, menia kartu pre všetkých alebo spúšťajú niektorý z tvojich triggerov (pozri Karty a tlačidlá botov).

Pošli prvú správu

1
V desktopovej aplikácii otvor vo svojej komunite Manage Server → Webhooks a klikni na Add Webhook.
2
Pomenuj ho, v Channels vyber kanály, do ktorých smie posielať, skopíruj Webhook Secret a klikni na Create Webhook.
3
Klikni na ikonu odkazu vedľa webhooku (View webhook URL), vyber kanál v Channel a skopíruj URL.
4
Pošli na túto URL JSON metódou POST, podpísaný tajným kľúčom. Správa sa v kanáli objaví okamžite.
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 ani tajný kľúč nikomu neukazuj. Spolu umožnia komukoľvek posielať správy do tohto kanála, preto ich nedávaj do verejných repozitárov ani do kódu na strane klienta. Požiadavka bez platného podpisu sa odmietne.

Posielaš z GitHubu? Na to netreba žiadny kód: nasmeruj webhook GitHubu na túto URL a vlož tajný kľúč do jeho poľa Secret. Pozri si integrácie.

Pridaj príkaz s lomkou

1
Otvor Manage Server → Triggers a klikni na Create Trigger.
2
Vyplň Word to Match, napríklad /weather, a URL Endpoint svojej webovej služby. V Allowed User Groups môžeš príkaz obmedziť na určité roly.
3
Keď člen pošle správu, ktorá sa začína na /weather, mssgs ju pošle metódou POST na tvoju URL. Odpovedz do 5 sekúnd JSON-om a odpoveď sa v kanáli zobrazí ako karta.

Potrebuješ viac času? Odpovedz hneď kartou s loaderom a dokonči ju cez callback_url z požiadavky, ktorá funguje 30 minút. Karta zobrazuje názov tvojej komunity a jej päta uvádza, kto použil ktorý príkaz.

Vlastný bot

Chceš, aby bol bot samostatným členom s menom, avatarom a označením BOT? Vytvor si účet bota prepojený s tvojím účtom a spravuj ho na paneli botov. Keď je desktopová aplikácia prihlásená ako bot, AI asistent môže posielať karty s tlačidlami cez jej MCP server.

Každé pole, odpoveď a chybový kód nájdeš v dokumentácii pre vývojárov: webhooky, príkazy s lomkou, karty správ, tlačidlá a aktualizácie naživo. A ak chceš správanie poháňané AI bez akéhokoľvek programovania, možno ti bude stačiť cesta cez MCP.

Pomohol ti tento článok?

Nenašiel si, čo hľadáš? Radi ti pomôžeme.

Opýtaj sa nás

Stále potrebuješ pomoc?

Náš tím podpory zvyčajne odpovie do 24 hodín.

Kontaktuj podporu