Power Automate'te Adaptive Cards ile Teams Bildirimleri

Power Automate'te bir akış tetiklendiğinde, Teams'te basit bir metin mesajı çoğu zaman yeterli olmaz. Bir onay adımı, ekip içi bir oylama veya bir siparişe ilişkin geri bildirim, sadece bilgiden fazlasını gerektirir; sohbette doğrudan yanıt verebilme imkânı gerektirir. Adaptive Cards tam olarak bunun için tasarlanmıştır: Power Automate'in Microsoft Teams bağlayıcısı üzerinden doğrudan bir sohbete veya kanala yayınladığı ve yanıtını akışın ardından beklediği etkileşimli kartlar.

Bu makale, Teams bağlayıcısının Adaptive Cards için sunduğu eylemleri, ilk etkileşimli kartını nasıl oluşturacağını ve resmi Microsoft belgelerine göre tasarım sırasında dikkat edilmesi gereken sınırlamaları gösterir. Böylece dijital çalışanının ekibinle nasıl iletişim kurduğunu baştan itibaren kontrol altında tutarsın, ilk hata görüntüsünden sonra belgelerde arama yapmak zorunda kalmazsın.

Adaptive Cards'ı basit bir Teams mesajından ayıran nedir

Teams için uyarlanabilir kartlara ilişkin Microsoft belgelerine göre, Adaptive Cards, CSS veya HTML'de değişiklik yapmana gerek kalmadan bilgi bloklarını paylaşmak ve görüntülemek için platformdan bağımsız bir yöntemdir. Kartı JSON biçiminde tanımlarsın, Teams görüntülerken bu tanımı otomatik olarak ilgili barındırıcıya uygun yerel bir arayüze dönüştürür.

Normal bir sohbet mesajından temel fark etkileşimliliktedir: Bir Adaptive Card, alıcıların doğrudan sohbette yanıt verebileceği metin alanları, seçim listeleri ve düğmeler içerebilir. Power Automate bu yanıtı alır ve akışı ayrı bir form veya ek bir uygulama olmadan girilen verilerle devam ettirir.

Microsoft Teams bağlayıcısındaki eylemlere genel bakış

Belgelere göre Teams bağlayıcısı, tek tek kişilere yönelik kartlar ile tüm kanallara yönelik kartlar arasında ve her ikisinde de bekleme işlevi olan ve olmayan bir varyant arasında ayrım yapar:

• Kendi uyarlanabilir kartını Flow bot olarak bir kullanıcıya yayınla: Kart, alıcının belirli bir Teams örneğinin üyesi olması gerekmeden sohbette ve alıcının etkinliklerinde görünür. Burada yalnızca URL düğmeleri çalışır, bunlar sadece akışta yapılandırılmış bir adrese yönlendirir.
• Uyarlanabilir kartı Flow bot olarak bir Teams kullanıcısına yayınla ve yanıt bekle: Kişi karta tepki verene kadar akış duraklar ve ardından alıcı ve kart başına dinamik içerik olarak tam olarak bir yanıt döndürür.
• Kendi uyarlanabilir kartını Flow bot olarak bir kanalda yayınla: yukarıdakiyle aynı, sadece kart, erişimin senin kendinde olması gereken bir ekip kanalında görünür.
• Uyarlanabilir kartı Flow bot olarak bir Teams kanalında yayınla ve yanıt bekle: akış, kanaldaki herhangi bir üye yanıt verene kadar bekler ve ardından girdisini işler.

Bir Copilot Studio aracısından gelen proaktif mesajlar için, proaktif Teams mesajlarına ilişkin belgelere göre, ayrıca Post adaptive card in a chat or channel ve Post adaptive card and wait for a response eylemleri de kullanılabilir. Burada Post as olarak Microsoft Copilot Studio agent seçeneğini seçer, alıcıyı ve istenen aracıyı belirtirsin.

İlk etkileşimli Adaptive Card'ını oluşturma

Başlamadan önce, belgelere göre Microsoft Teams'te Workflows uygulamasının yüklü olması gerekir, aksi takdirde akış çalıştırması net bir hata mesajıyla başarısız olur. İlk kartı şöyle oluşturursun:

1. Power Automate'a giriş yap ve Bir akışı manuel olarak tetikle tetikleyicisiyle anlık bir bulut akışı oluştur.

2. Yeni bir adım olarak Bir Teams kanalında uyarlanabilir kart yayınla ve yanıt bekle eylemini ekle ve ekibi ile kanalı seç.

3. Mesaj alanına kartının JSON kodunu yapıştır. Başlangıç için bir başlık, bir metin gövdesi, seçim seçenekleri için bir Input.ChoiceSet ve sonunda bir Action.Submit düğmesinden oluşan bir yapı yeterlidir.

4. Güncelleme mesajı alanına, kartın yanıttan sonra göstermesi gereken metni gir. Bu bilgi girilmezse, kart her gönderimden sonra basitçe sıfırlanır; bu da belgelere göre gereksiz çoklu gönderimlere yol açar.

5. Yanıtı, örneğin yanıt bekleme eyleminin dinamik içeriğinden seçilen değeri içeren bir e-posta üzerinden sonraki bir adımda işle.

Akışı çalıştırdığında, çalıştırma günlüğündeki bekleme işaretinden Power Automate'in gerçekten yanıtı beklediğini görürsün. Akış, girilen değerlerle ancak alıcı tarafından gönderim yapıldıktan sonra devam eder; bu, ilk uyarlanabilir kartı oluşturmaya ilişkin kılavuzda ayrıntılı olarak açıklanmıştır.

Yanıtı akışta işleme

Yanıt bekleyen bir Adaptive Card içinde, her giriş öğesi değerini JSON'da saklanan kimlik üzerinden döndürür; belgelerdeki örnekte bir seçim listesi için `acPollChoices` gibi. Bu kimliği bir sonraki adımda dinamik içerik olarak bulur ve doğrudan e-postalarda, liste girişlerinde veya diğer koşullarda kullanabilirsin.

Bunun yerine bir Copilot Studio aracısı üzerinden proaktif bir kart kullanırsan, belgelere göre yanıt, değeri seçilen eylemin başlığına karşılık gelen `submitActionId` değişkenini döndürür. Her iki varyant için de geçerlidir: yanıt veren kişinin kullanıcı kimliği gibi ek ayrıntılar ancak yanıt bekleme eyleminden sonra dinamik içerik olarak kullanılabilir hale gelir; eksiksiz profil verileri için ayrıca Office 365 Kullanıcılar bağlayıcısına ihtiyacın vardır.

Bilmen gereken bilinen sınırlamalar

Belgeler, pratikte sık sık kafa karışıklığına yol açan birkaç noktayı listeler:

• Bir yanıt bekleme eylemi olmadan bir karttan veri toplanamaz, Action.OpenUrl dışındaki her düğme o zaman bir hata döndürür.
• Yanıt bekleyen her kart yalnızca bir kez gönderilebilir, sonraki tüm gönderimler sessizce yok sayılır.
• Gönderimden sonra kart yalnızca Güncelleme mesajı alanındaki metni gösterir, aksi takdirde değişmeden kalır ve yeni, işe yaramaz bir gönderime davet eder.
• Genel Adaptive Cards spesifikasyonundaki şablonlama özelliğine sahip Adaptive Cards, Power Automate tarafından desteklenmez.
• ABD Savunma Bakanlığı ortamında uyarlanabilir kartlar genel olarak kullanılamaz, ancak bu yalnızca çok özel bir kullanıcı grubunu etkiler.

Uyarlanabilir kartlarda tipik hata kaynakları

Microsoft, yapısal sınırlamaların yanı sıra kendi sorun giderme ipuçlarında öncelikle üç tekrarlayan hata türünden söz eder:

• Eksik Workflows uygulaması: Workflows uygulaması Teams'te yüklü değilse, akış çalıştırması başarısız olur. Uygulama, ilk test çalıştırmasından önce ilgili Teams örneğinde kurulmuş olmalıdır.
• Hatalı biçimlendirilmiş JSON kodu: Genellikle bunun nedeni, düz tırnak yerine kıvrık tırnak işaretleri veya metin değerlerinin etrafında eksik tırnak işaretleridir. Adaptive Cards Designer'daki bir test, kartı Power Automate'e eklemeden önce bu tür hataları güvenilir bir şekilde ortaya çıkarır.
• Geçersiz görsel URL'leri: Adaptive Cards, gömülü görsel dosyalarını desteklemez, her görselin herkese açık olarak erişilebilen bir URL üzerinden eklenmesi gerekir. Şüphe durumunda, URL'yi karta eklemeden önce doğrudan tarayıcıda kontrol et.

Yayına geçmeden önce bu üç noktayı gözden geçiren kişi, pratikte ancak ilk üretim çalıştırmasından sonra ortaya çıkan hata mesajlarının çoğundan kurtulur. Power Automate'i dijital çalışan olarak kullanan ve düzgün kurulmuş, bakımı az Teams bildirimlerine önem veren kişi, NordFlux'ın Power Automate danışmanlığında Adaptive Cards oluşturma ve ilgili hata yönetimi konusunda destek bulur.

Sık sorulan sorular

Girişler için yanıt bekleme eylemi olmadan bir Adaptive Card kullanabilir miyim?

Hayır. Belgelere göre, bu eylem olmadan kartlar Action.OpenUrl dışındaki tüm düğmeler için bir hata döndürür, dolayısıyla giriş alanlarından veriler yalnızca iki yanıt bekleme varyantından biriyle toplanabilir.

Tek bir Adaptive Card kaç kez yanıtlanabilir?

Yalnızca bir kez. İlk gönderimden sonra akış devam eder, aynı kartın her sonraki gönderimi belgelere göre yeni bir yanıt oluşmadan yok sayılır.

Kartım yanıttan sonra neden hâlâ tıpatıp aynı görünüyor?

Çünkü Güncelleme mesajı alanı doldurulmamıştır. Bu bilgi girilmezse, kart her gönderimden sonra basitçe sıfırlanır; bu da alıcıları kolayca işe yaramaz bir ikinci gönderime yönlendirir.

Adaptive Cards, Power Automate'te şablonlama özellikleriyle çalışır mı?

Hayır, belgeler, genel Adaptive Cards spesifikasyonundaki şablonlama özelliğinin Power Automate tarafından desteklenmediğini açıkça belirtir. Bunun yerine kartı, yer tutucu şablonlar olmadan tamamen doldurulmuş JSON ile oluştur.

Bir kart tasarlamak için JSON kodunu elle mi yazmam gerekiyor?

Şart değil. Adaptive Cards Designer, tamamlanmış JSON kodunu doğrudan Power Automate eyleminin mesaj alanına kopyaladığın görsel bir sürükle-bırak arayüzü sunar.