Pereiti prie pagrindinio turinio

Boto kūrimas

Skelbk kanale per webhook, suteik bendruomenei komandas su pasviruoju brūkšniu ir pridėk mygtukų po kortelėmis.

Trys statybiniai blokai leidžia tavo nuosavai paslaugai kalbėti tavo bendruomenėje. Jie veikia kartu: viena integracija gali paskelbti kortelę, atsakyti į /komandą, sureaguoti į mygtuko paspaudimą ir atnaujinti savo žinutę.

Statybiniai blokai

  • Webhook’ai: URL adresas, kuris skelbia kanale. Tavo paslauga siunčia į jį JSON, o žinutė pasirodo tuo vardu, kurį davei webhook’ui. Sukurta įspėjimams: CI rezultatams, stebėsenai, pagalbos užklausoms.
  • Trigeriai: tavo bendruomenės komandos su pasviruoju brūkšniu. Narys įveda /weather, mssgs nusiunčia žinutę tavo žiniatinklio paslaugai, o jos atsakymas kanale pasirodo kaip kortelė.
  • Mygtukai: po kortele jie atidaro nuorodą, pakeičia kortelę visiems arba paleidžia vieną iš tavo trigerių (žr. Botų kortelės ir mygtukai).

Paskelbk pirmąją žinutę

1
Kompiuterio programėlėje atidaryk savo bendruomenės Manage Server → Webhooks ir spustelėk Add Webhook.
2
Suteik jam pavadinimą, lauke Channels pasirink kanalus, kuriuose jis gali skelbti, nukopijuok Webhook Secret ir spustelėk Create Webhook.
3
Spustelėk nuorodos piktogramą prie webhook’o (View webhook URL), lauke Channel pasirink kanalą ir nukopijuok URL.
4
Siųsk JSON į tą URL metodu POST, pasirašytą slaptuoju raktu. Žinutė kanale pasirodo iš karto.
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"
Laikyk URL ir slaptąjį raktą paslaptyje. Kartu jie leidžia bet kam skelbti tame kanale, todėl nedėk jų į viešas saugyklas ir kliento pusės kodą. Užklausa be galiojančio parašo atmetama.

Skelbi iš GitHub? Tam nereikia jokio kodo: nukreipk GitHub webhook’ą į šį URL ir įklijuok slaptąjį raktą į jo lauką Secret. Žr. integracijų puslapį.

Pridėk komandą su pasviruoju brūkšniu

1
Atidaryk Manage Server → Triggers ir spustelėk Create Trigger.
2
Užpildyk lauką Word to Match, pavyzdžiui, /weather, ir savo žiniatinklio paslaugos URL Endpoint. Lauke Allowed User Groups gali leisti komandą naudoti tik tam tikriems vaidmenims.
3
Kai narys išsiunčia žinutę, prasidedančią /weather, mssgs ją nusiunčia į tavo URL metodu POST. Atsakyk JSON formatu per 5 sekundes, ir atsakymas kanale pasirodys kaip kortelė.

Reikia daugiau laiko? Iš karto atsakyk kortele su įkėlimo indikatoriumi ir užbaik ją per užklausoje esantį callback_url, kuris galioja 30 minučių. Kortelėje rodomas tavo bendruomenės pavadinimas, o jos poraštėje parašyta, kas kurią komandą panaudojo.

Atskiras botas

Nori, kad botas būtų atskiras narys su vardu, avataru ir žyma BOT? Sukurk su savo paskyra susietą boto paskyrą ir tvarkyk ją botų valdymo skydelyje. Kai kompiuterio programėlėje prisijungta kaip botas, DI asistentas gali skelbti korteles su mygtukais per jos MCP serverį.

Kiekvienas laukas, atsakymas ir klaidos kodas aprašytas dokumentacijoje programuotojams: webhook’ai, komandos su pasviruoju brūkšniu, žinučių kortelės, mygtukai ir tiesioginiai atnaujinimai. O jei nori, kad viskas veiktų su DI ir nereikėtų nieko kurti, gali užtekti MCP kelio.

Ar šis straipsnis buvo naudingas?

Neradai, ko ieškojai? Mielai padėsime.

Užduok klausimą

Vis dar reikia pagalbos?

Mūsų pagalbos komanda paprastai atsako per 24 valandas.

Susisiek su pagalba