Bot kartları ve düğmeler

Bir webhook’un, bir eğik çizgi komutunun ya da bir bot hesabının paylaştığı şey düz metin olmak zorunda değil. Bir kart olabilir: bir bakışta kavradığın, altında düğmeler olan yapılandırılmış bir mesaj.

Kartlar

Bir kartta şunlar olabilir:

• bir renkli kenar: mavi (varsayılan), yeşil, kırmızı, turuncu, sarı ya da mor
• bir başlık (istersen bağlantı olarak), bir alt başlık ve markdown ile bir açıklama
• alanlar: üyelerin tek dokunuşla kopyaladığı etiket ve değer satırları
• görseller: tek bir görsel ya da bir galeri
• bir loader: “Düşünüyor…” gibi kendi yazdığın bir satırla dönen bir gösterge; sonuç hazır olduğunda onu sonuçla değiştirirsin

Bir eğik çizgi komutuna verilen yanıt daha fazlasını gösterebilir: Open, Merged ya da Passing gibi bir durum etiketi, başlıkta bir rozet, eklenen ve silinen satırlar ve bir aç/kapa düğmesinin arkasına gizlenmiş akıl yürütme. Webhook üzerinden paylaşılan bir kart bunları göstermez ve başlığında her zaman webhook’un kendi adı yazar.

Pull request’leri, dağıtımları ve destek taleplerini düşün: bir metin duvarı yerine bir bakışta anlaşılan kartlar.

Düğmeler

Düğmeler kartın altında durur. Basıldığında ne olacağını düğmenin type değeri belirler:

• url:{url} bir bağlantı açar.
• webhook_action düğmeyle birlikte kaydettiğin adımları çalıştırır: kartı güncelle, kaldır, bir tepki ekle ya da bir yanıt paylaş. Bu adımlar mssgs sunucusunda çalışır ve sonucu kanaldaki herkes görür; bu yüzden “Onayla” ya da “Kapıyı aç” için kendi sunucuna gerek yoktur.
• trigger:{guid} topluluğunun tetikleyicilerinden birini düğmenin verileriyle, sanki biri komutu yazmış gibi çalıştırır. Yanıt yeni bir kart olarak gelir.

Geri bildirim almak

Düğmeli bir webhook gönderisi yanıt olarak bir stream_url alır; her eğik çizgi komutu isteği de bir tane taşır: o mesajdaki basışların, tepkilerin ve yanıtların canlı akışı. 10 dakika açık kalır (webhook gönderilerinde istek üzerine bir saat) ve sonrası için hiçbir şey saklamaz, bu yüzden hemen bağlan. Mesajı sonradan değiştirmek için 30 dakika geçerli olan callback_url adresini kullan. Bir bot hesabı ise kartlarında olup biteni MCP sunucusu üzerinden öğrenir.

Her kart alanı, canlı bir kart oluşturucuyla birlikte mesaj kartları sayfasında. Düğme adımları, olaylar ve hatalar düğmeler sayfasında; akış ve callback URL’si canlı güncellemeler sayfasında.