Botu kartītes un pogas
Kartītes ar krāsu, laukiem, attēliem un statusu, kā arī pogas, kas maina kartīti visiem.
Tam, ko publicē webhook, slīpsvītras komanda vai bota konts, nav jābūt vienkāršam tekstam. Tā var būt kartīte, strukturēta ziņa, ko uztver vienā acu uzmetienā, ar pogām apakšā.
Kartītes
Kartītei var būt:
- krāsaina mala: zila (pēc noklusējuma), zaļa, sarkana, oranža, dzeltena vai violeta
- virsraksts (pēc izvēles kā saite), apakšvirsraksts un apraksts markdown formātā
- lauki: rindas ar nosaukumu un vērtību, ko dalībnieki nokopē ar vienu pieskārienu
- attēli: viens attēls vai galerija
- ielādes indikators: griežams aplis ar tavu tekstu, piemēram, „Domāju…“, ko tu nomaini pret rezultātu, kad tas ir gatavs
Atbilde uz slīpsvītras komandu var parādīt vairāk: statusa birku, piemēram, Open, Merged vai Passing, nozīmīti galvenē, pievienotās un dzēstās rindas un spriešanu, kas paslēpta aiz pārslēga. Kartīte, kas publicēta caur webhook, tos nerāda, un tās galvenē vienmēr redzams paša webhook nosaukums.
Iedomājies pull request, izvietošanas un atbalsta pieteikumus: pārskatāmi vienā acu uzmetienā, nevis teksta siena.
Pogas
Pogas atrodas zem kartītes. To type nosaka, ko dara nospiešana:
url:{url}atver saiti.webhook_actionizpilda soļus, ko saglabāji kopā ar pogu: atjaunina kartīti, noņem to, pievieno reakciju vai publicē atbildi. Tie darbojas mssgs serverī, un rezultātu redz visi kanālā, tāpēc pogai „Apstiprināt“ vai „Atvērt vārtus“ nav vajadzīgs savs serveris.trigger:{guid}palaiž kādu no tavas kopienas trigeriem ar pogas datiem, it kā kāds būtu ierakstījis komandu. Atbilde pienāk kā jauna kartīte.
Atgriezeniskā saite
Webhook ieraksts ar pogām atbildē saņem stream_url, un tas ir arī katrā slīpsvītras komandas pieprasījumā: tā ir reāllaika plūsma ar pogu nospiešanām, reakcijām un atbildēm uz šo ziņu. Tā paliek atvērta 10 minūtes (webhook ierakstiem pēc pieprasījuma stundu) un neko neglabā vēlākam, tāpēc pieslēdzies uzreiz. Lai vēlāk mainītu ziņu, izmanto tās callback_url, kas darbojas 30 minūtes. Bota konts par savām kartītēm uzzina caur MCP serveri.
button un soļiem ws:send, local:update_message, local:remove_message, nosacījumi, piemēram, previous:success, un expire_in_seconds ārējiem sūtītājiem vairs nedarbojas. Izmanto webhook_action ar iepriekš aprakstītajiem soļiem: tie sasniedz visus, ne tikai to, kurš nospieda pogu.Katrs kartītes lauks kopā ar reāllaika kartīšu veidotāju ir lapā ziņu kartītes. Pogu soļi, notikumi un kļūdas ir lapā pogas, plūsma un callback URL lapā reāllaika atjauninājumi.