Botų kortelės ir mygtukai

Tai, ką paskelbia webhook, komanda su pasviruoju brūkšniu ar boto paskyra, neturi būti paprastas tekstas. Tai gali būti kortelė, struktūruota žinutė, kurią suvoki vienu žvilgsniu, su mygtukais apačioje.

Kortelės

Kortelėje gali būti:

• spalvotas kraštas: mėlynas (numatytasis), žalias, raudonas, oranžinis, geltonas arba violetinis
• pavadinimas (gali būti nuoroda), paantraštė ir aprašymas markdown formatu
• laukai: eilutės su etikete ir reikšme, kurias nariai nukopijuoja vienu bakstelėjimu
• paveikslėliai: vienas paveikslėlis arba galerija
• įkėlimo indikatorius: besisukantis ženklas su tavo tekstu, pavyzdžiui, „Galvoju…“, kurį pakeiti rezultatu, kai šis paruoštas

Atsakymas į komandą su pasviruoju brūkšniu gali parodyti daugiau: būsenos žymą, pavyzdžiui, Open, Merged ar Passing, ženklelį antraštėje, pridėtas ir pašalintas eilutes bei samprotavimus, paslėptus po perjungikliu. Per webhook paskelbta kortelė jų nerodo, o jos antraštėje visada matomas paties webhook’o pavadinimas.

Pagalvok apie pull request’us, diegimus ir pagalbos užklausas: viskas aišku iš pirmo žvilgsnio, o ne teksto siena.

Mygtukai

Mygtukai yra po kortele. Jų type nusako, ką daro paspaudimas:

• url:{url} atidaro nuorodą.
• webhook_action atlieka su mygtuku išsaugotus žingsnius: atnaujina kortelę, ją pašalina, prideda reakciją arba paskelbia atsakymą. Jie vykdomi mssgs serveryje, o rezultatą mato visi kanale, todėl „Patvirtinti“ ar „Atidaryti vartus“ neprireiks jokio tavo serverio.
• trigger:{guid} paleidžia vieną iš tavo bendruomenės trigerių su mygtuko duomenimis, tarsi kas nors būtų įvedęs komandą. Atsakymas ateina kaip nauja kortelė.

Grįžtamasis ryšys

Webhook įrašas su mygtukais atgal gauna stream_url, o kiekvienoje komandos su pasviruoju brūkšniu užklausoje jis jau yra: tai tiesioginis srautas su tos žinutės mygtukų paspaudimais, reakcijomis ir atsakymais. Jis lieka atviras 10 minučių (webhook įrašams, paprašius, valandą) ir nieko nesaugo vėlesniam laikui, todėl prisijunk iš karto. Kad vėliau pakeistum žinutę, naudok jos callback_url, kuris galioja 30 minučių. Boto paskyra apie savo korteles sužino ne čia, o per MCP serverį.

Kiekvienas kortelės laukas kartu su tiesioginiu kortelių kūrimo įrankiu aprašytas puslapyje žinučių kortelės. Mygtukų žingsniai, įvykiai ir klaidos yra puslapyje mygtukai, o srautas ir callback URL puslapyje tiesioginiai atnaujinimai.