Preskoči na glavni sadržaj

Izrada bota

Objavljuj u kanalu putem webhooka, daj svojoj zajednici slash naredbe i dodaj gumbe ispod kartica.

Tri gradivna elementa omogućuju tvojoj vlastitoj usluzi da progovori u tvojoj zajednici. Rade zajedno: jedna integracija može objaviti karticu, odgovoriti na /naredbu, reagirati na gumb i ažurirati vlastitu poruku.

Gradivni elementi

  • Webhookovi: URL koji objavljuje u kanal. Tvoja usluga šalje mu JSON, a poruka se pojavljuje pod imenom koje dodijeliš webhooku. Stvoreni su za upozorenja: rezultate CI-ja, nadzor sustava, tikete.
  • Triggeri: vlastite slash naredbe tvoje zajednice. Član upiše /weather, mssgs pošalje poruku tvojoj web-usluzi, a ono što ona odgovori pojavljuje se u kanalu kao kartica.
  • Gumbi: ispod kartice otvaraju poveznicu, mijenjaju karticu za sve ili pokreću jedan od tvojih triggera (pogledaj Kartice i gumbi botova).

Objavi svoju prvu poruku

1
U aplikaciji za računalo otvori u svojoj zajednici Manage Server → Webhooks i klikni Add Webhook.
2
Daj mu ime, pod Channels odaberi kanale u kojima smije objavljivati, kopiraj Webhook Secret i klikni Create Webhook.
3
Klikni ikonu poveznice pokraj webhooka (View webhook URL), odaberi kanal pod Channel i kopiraj URL.
4
Pošalji JSON na taj URL metodom POST, potpisan tajnim ključem. Poruka se odmah pojavljuje u kanalu.
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 tajni ključ čuvaj za sebe. Zajedno omogućuju bilo kome da objavljuje u tom kanalu, pa ih drži podalje od javnih repozitorija i koda na strani klijenta. Zahtjev bez valjanog potpisa bit će odbijen.

Objavljuješ s GitHuba? Za to ne treba kôd: usmjeri GitHubov webhook na taj URL i zalijepi tajni ključ u njegovo polje Secret. Pogledaj integracije.

Dodaj slash naredbu

1
Otvori Manage Server → Triggers i klikni Create Trigger.
2
Ispuni Word to Match, na primjer /weather, i URL Endpoint svoje web-usluge. Pod Allowed User Groups naredbu možeš ograničiti na određene uloge.
3
Kad član pošalje poruku koja počinje s /weather, mssgs je metodom POST šalje na tvoj URL. Odgovori JSON-om u roku od 5 sekundi i odgovor se pojavljuje u kanalu kao kartica.

Treba ti više vremena? Odmah odgovori karticom s indikatorom učitavanja i dovrši je putem callback_url iz zahtjeva, koji vrijedi 30 minuta. Kartica prikazuje ime tvoje zajednice, a u njezinu podnožju piše tko je upotrijebio koju naredbu.

Bot kao zaseban član

Želiš da bot bude zaseban član, s imenom, avatarom i oznakom BOT? Izradi račun bota povezan s tvojim računom i upravljaj njime na nadzornoj ploči za botove. Kad je aplikacija za računalo prijavljena kao bot, AI asistent može objavljivati kartice s gumbima putem njezina MCP servera.

Svako polje, odgovor i kôd pogreške opisani su u dokumentaciji za programere: webhookovi, slash naredbe, kartice poruka, gumbi i ažuriranja uživo. A ako želiš ponašanje koje pokreće AI, a da pritom ništa ne gradiš, možda ti je dovoljan put preko MCP-a.

Je li ti ovaj članak pomogao?

Ne nalaziš ono što tražiš? Rado ćemo pomoći.

Postavi pitanje

Još trebaš pomoć?

Naš tim podrške obično odgovara u roku od 24 sata.

Kontaktiraj podršku