Proaktif Microsoft Teams iletileri gönderin

Aracınızı yayımladıktan ve aracıyı Microsoft Teams'deki kullanıcılar için kullanılabilir hale getirdikten sonra, Microsoft Teams'deki kullanıcıları ("alıcılar") proaktif iletilerle bilgilendirebilirsiniz. Proaktif mesajlar, içeriklerini iletmek için Power Automate akışlarını kullanır ve aşağıdakiler de dahil olmak üzere birçok senaryoda kullanışlıdır:

• Alıcının önceki isteğinin tamamlandığı bilmesini sağlama. Örneğin, kullanıcının izin talebini onaylandı.
• Anımsatıcılar veya haber güncelleştirmeleri sağlama. Örneğin, aracı çevrimiçi eğitimi tamamlamak için bir anımsatıcı iletisi gönderebilir.

Önemli

Proaktif mesajlar, Copilot Studio'da oluşturulan ve özelleştirilen aracılar ve klasik sohbet robotları için yapılandırılabilir.

Bir aracı, aşağıdaki durumlarda iletileri teslim edemez:

• Microsoft Teams'de aracı yüklü değil.
• Aracı kaldırdı.
• Aracı engelledi.
• Aracıyla sohbet etme izni olmaması; bu durumda aracı diğer kullanıcılarla paylaşmanız gerekir.

Önkoşullar

• Power Automate akışlarını kullanma
• Aracınızı yayımlama
• Microsoft Teams için bir aracı bağlama ve yapılandırma
• Power Automate ile çalışmaya başlama

Bilinen sınırlamalar

• Aracının bağlantısı kesilir ve Microsoft Teams'e yeniden bağlanırsa, kullanıcılar aracıyı yeniden yükleyene kadar proaktif iletiler almaz.
• Copilot Studio'dan gelen tüm proaktif iletiler Power Automate'teki sınırlamalara ve Microsoft Teams bağlayıcısının azaltma sınırlarına tabidir.
• Proaktif iletiler konuşma dökümlerinde veya Analiz oturumlarında günlüğe kaydedilmez.
• Proaktif mesajlar, Power Automate akışıyla aynı ortamda olmalıdır.
• Proaktif iletiler yalnızca aracı ile kişisel bir sohbete gönderilebilir.

Proaktif ileti gönderme

1. Power Automate'te, proaktif mesaj göndermek istediğiniz akışı açın.

2. Microsoft Teams'in Sohbete veya kanala ileti gönder bağlayıcı eylemini ekleyin.

3. Farklı gönder için Microsoft Copilot Studio (Önizleme) öğesini seçin.

4. Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.

5. Bot için, iletinin gönderilmesini istediğiniz aracı seçin.

6. Alıcı için alıcının adını veya e-posta adresini girin. Alıcı bilgileri akışta önceki bir adımdan geliyorsa dinamik içerik de kullanabilirsiniz.

7. İleti için göndermek istediğiniz iletiyi girin.

   

Akış çalıştırıldığında, alıcı Microsoft Teams'deki aracıdan proaktif iletiyi alır.

Proaktif Uyarlamalı Kart gönderme

Önemli

Bu bölümde, Power Automate akışlarıyla proaktif Uyarlamalı Kartların nasıl gönderileceği anlatılmaktadır. Proaktif Uyarlamalı Kartlar, kullanıcıların aracı ile etkin olmayan bir konuşmadan bilgi almasına olanak tanır.

Proaktif iletiler göndermenin yanı sıra proaktif Uyarlamalı Kartlar da gönderebilirsiniz.

Uyarlamalı Kartlar, geliştiricilerin kullanıcı arabirimi içeriğini ortak ve tutarlı bir şekilde paylaşmalarını sağlayan açık bir kart değişim biçimidir. Uyarlamalı Kartları JSON'da el ile yazabilir veya sürükle ve bırak arabirimini tercih ederseniz Uyarlamalı Kart Tasarımcısı'nı kullanabilirsiniz.

Not

Power Automate, şablon oluşturma özelliğini kullanan Uyarlamalı Kartları desteklemez.

Bu örnekte, kullanıcının incelemesi için bir sipariş özeti kartı gönderilmektedir.

1. Power Automate'te, akışınızda kart göndermek istediğiniz adıma Microsoft Teams Uyarlamalı kartı bir sohbette veya kanalda yayımla bağlayıcı eylemini ekleyin.

2. Farklı gönder için Microsoft Copilot Studio (Önizleme) öğesini seçin.

3. Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.

4. Bot için, iletinin gönderilmesini istediğiniz aracı seçin.

5. Alıcı için alıcının adını veya e-posta adresini girin. Alıcı bilgileri akışta önceki bir adımdan geliyorsa dinamik içerik de kullanabilirsiniz.

6. Uyarlamalı Kart için aşağıdaki JSON şablonunu girin:

   {
       "type": "AdaptiveCard",
       "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
       "version": "1.5",
       "body": [
           {
               "type": "TextBlock",
               "text": "Order summary",
               "wrap": true,
               "style": "heading"
           },
           {
               "type": "FactSet",
               "facts": [
                   {
                       "title": "Name",
                       "value": "John Doe"
                   },
                   {
                       "title": "Phone number",
                       "value": "(000) 000-0000"
                   }
               ]
           },
           {
               "type": "Container",
               "items": [
                   {
                       "type": "FactSet",
                       "facts": [
                           {
                               "title": "1x",
                               "value": "Steak"
                           },
                           {
                               "title": "2x",
                               "value": "Side Rice"
                           },
                           {
                               "title": "1x",
                               "value": "Soft Drink"
                           }
                       ],
                       "spacing": "Small"
                   }
               ],
               "spacing": "Small"
           }
       ]
   }
   

   

Akış çalıştırıldığında, alıcı Microsoft Teams'deki aracıdan Uyarlamalı Kart alır.

Kullanıcı yanıtını bekleme

Önemli

Bu bölümde, Power Automate akışlarıyla proaktif Uyarlamalı Kartların nasıl gönderileceği anlatılmaktadır. Proaktif Uyarlamalı Kartlar, kullanıcıların aracı ile etkin olmayan bir konuşmadan bilgi almasına olanak tanır.

Uyarlamalı kartlar kullanıcı girişini toplamayı destekler. Bu senaryolarda, akış devam etmeden önce kullanıcının yanıtını bekleyebilirsiniz.

Not

Power Automate, şablon oluşturma özelliğini kullanan Uyarlamalı Kartları desteklemez.

Bu örnekte, kullanıcının sipariş gönderilmeden önce değişiklik yapmasına olanak tanıyan bir sipariş onay kartı gönderirsiniz.

1. Power Automate'te, akışınızda kart göndermek istediğiniz adıma Uyarlamalı kart gönder ve yanıt bekle Microsoft Teams bağlayıcı eylemini ekleyin.

2. Farklı gönder için Microsoft Copilot Studio (Önizleme) öğesini seçin.

3. Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.

4. İleti için aşağıdaki JSON şablonunu girin:

   actions bölümündeki özellikler kullanıcıya sunulan seçenekleri belirler.

   {
       "type": "AdaptiveCard",
       "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
       "version": "1.0",
       "body": [
           {
               "type": "TextBlock",
               "text": "Order confirmation",
               "wrap": true,
               "style": "heading"
           },
           {
               "type": "FactSet",
               "facts": [
                   {
                       "title": "Name",
                       "value": "John Doe"
                   },
                   {
                       "title": "Phone number",
                       "value": "(000) 000-0000"
                   }
               ]
           },
           {
               "type": "Container",
               "items": [
                   {
                       "type": "FactSet",
                       "facts": [
                           {
                               "title": "1x",
                               "value": "Steak"
                           },
                           {
                               "title": "2x",
                               "value": "Side Rice"
                           },
                           {
                               "title": "1x",
                               "value": "Soft Drink"
                           }
                       ],
                       "spacing": "Small"
                   }
               ],
               "spacing": "Small"
           }
       ],
       "actions": [
           {
               "type": "Action.Submit",
               "title": "Submit Order"
           },
           {
               "type": "Action.Submit",
               "title": "Edit Order"
           }
       ]
   }
   

5. Güncelleştirme iletisi için yanıtını sağladıktan sonra alıcının göreceği güncelleştirme iletisini girin.

6. Alıcı için alıcının adını veya e-posta adresini girin. Alıcı bilgileri akışta önceki bir adımdan geliyorsa dinamik içerik de kullanabilirsiniz.

7. Bot için, kartın gönderilmesini istediğiniz aracı seçin.

   

Akış çalıştırıldığında, alıcı Microsoft Teams'deki aracıdan uyarlamalı kartı alır ve daha sonra bu karta yanıt verebilir.

Alıcıdan gelen yanıtı kullanmak için dinamik içerik açılır menüsünden submitActionId öğesini seçin. Bu değişkenin değeri, kullanıcının seçtiği eylemin title öğesidir.

Proaktif iletileri birden çok alıcıya gönderme

Bazı senaryolarda, aynı proaktif iletiyi birden çok alıcıya göndermek isteyebilirsiniz.

Bu bölüm, birden çok alıcıya ileti gönderme örnekleri içermektedir.

Önemli

Bu konuda ayrıntılı olarak açıklanan önkoşullar her alıcı için geçerlidir.

Örneğin, bir eylemde aynı iletiyi en fazla 10 alıcıya gönderebilirsiniz. 10 alıcıdan üçü aracıyı yüklemediyse bu üç alıcı iletiyi almaz.

Takım arkadaşlarına gönderme

Bu örnekte, aracı çevrimiçi eğitimlerini tamamlamaları için bir takımın üyelerine anımsatıcı gönderecektir.

1. Microsoft Teams bağlayıcısını ekleyin ve Power Automate akışınızda Ekip alın eylemini seçin.

2. Takım için iletiyi göndermek istediğiniz üyelerin bulunduğu takımı seçin.

3. Office 365 Grupları bağlayıcısını ekleyin ve Grup üyelerini listele eylemini seçin.

4. Grup Kimliği için Özel değer'i seçin.

5. Takım al eyleminin dinamik içeriğinden Takım Kimliği'ni seçin.

6. Microsoft Teams bağlayıcısını ekleyin ve Sohbette veya kanalda ileti gönder eylemini seçin.

7. Farklı gönder için Microsoft Copilot Studio (Önizleme) öğesini seçin.

8. Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.

9. Bot için, iletiyi göndermek istediğiniz aracı seçin.

10. Alıcı için Grup üyelerini listele eyleminden Kullanıcı Asıl Adı dinamik içeriğini seçin.

    

11. İleti için göndermek istediğiniz iletiyi girin.

Akış çalıştırıldığında takımdaki her kullanıcı, proaktif iletiyi aracı ile özel bir sohbette alır.

Güvenlik grubuna gönderme

Bu örnekte, aracı çevrimiçi eğitimlerini tamamlamaları için bir güvenlik grubuna anımsatıcı gönderecektir.

1. Power Automate akışınıza Microsoft Entra ID bağlayıcısını ekleyin ve Grup üyelerini al eylemini seçin.

2. Grup Kimliği için güvenlik grubunun GUID değerini girin.

3. Microsoft Teams bağlayıcısını ekleyin ve Sohbette veya kanalda ileti gönder eylemini seçin.

4. Farklı gönder için Microsoft Copilot Studio (Önizleme) öğesini seçin.

5. Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.

6. Bot için, iletiyi göndermek istediğiniz aracı seçin.

7. Alıcı için Grup üyelerini al eyleminden Grup Üyeleri Kullanıcı Asıl Adı dinamik içeriğini seçin.

8. İleti için göndermek istediğiniz iletiyi girin.

   

Akış çalıştırıldığında güvenlik grubundaki her kullanıcı, proaktif iletiyi aracı ile özel bir sohbette alır.

Proaktif iletiyi birden çok alıcıya eşzamanlı olarak gönderme

Normalde, birden fazla alıcıya proaktif bir mesaj gönderirken, aracınız birbiri ardına mesaj gönderir. Bununla birlikte, bazı durumlarda, iletinin aynı anda birden fazla alıcıya gönderilmesi tercih edilebilir.

Uyarı

Copilot Studio'dan gelen tüm proaktif iletiler Power Automate'teki sınırlamalara ve Microsoft Teams bağlayıcısının azaltma sınırlarına tabidir.

Büyük bir alıcı grubuna ileti gönderiyorsanız azaltma sınırına ulaştığınızda hatalar görürsünüz. Paralellik düzeyini veya gruptaki alıcı sayısını azaltabilirsiniz.

1. Her eyleme Uygula bölümünde üç noktayı (...) seçin ve ardından Ayarlar.

   

2. Eşzamanlılık denetimi'ni açın ve paralellik derecesini ayarlayın.

   

Proaktif iletiler için gelişmiş seçenekleri yapılandırma

Copilot Studio, Microsoft Teams bağlayıcısında Gelişmiş seçenekleri göster altında aracınız üzerinde ayrıntılı davranışı kontrol etmenizi sağlar.

Gönderilen iletiyi bildirim olarak etiketleme

Bildirim olarak etiket, iletide aracının adının önünde "Bildirim yoluyla" metninin olup olmadığını kontrol eder. Aracının yanıtını etiketleme, alıcının kendi sorgulaması için aracının yanıtını tanımlamasına olanak verir.

Alıcı şu anda aracı ile etkin bir sohbet içinde olduğunda

Bazen aracı, alıcı aracı ile etkin bir konuşma içindeyken proaktif ileti gönderiyor olabilir.

Konuşma akışının kesintiye uğramaması için alıcılar konuşmalarını tamamlayana kadar proaktif iletiyi göndermeyi ertelemeyi isteyebilirsiniz.

Sohbet etkinse kutusu, davranışı denetlemenize olanak tanır:

• Gönder: Aracı, proaktif iletiyi normal şekilde gönderecektir.

• Gönderme ve başarılı yap: Aracı, alıcı aktif bir görüşmedeyken proaktif iletiyi göndermez. Durum kodu 300 döndürülür.

• Gönderme ve başarısız yap: Aracı, alıcı aktif bir görüşmedeyken proaktif iletiyi göndermez. Akış çalıştırması, başarısız olarak işaretlenir.

Alıcı aracıyı yüklemediğinde

Aracı, yalnızca aracıyı Microsoft Teams'e yüklemiş olan alıcılara ileti gönderebilir. Alıcılar aracıyı yüklemek istemeyebilir veya aracıyı kaldırmış olabilir.

Daha düşük öneme sahip iletiler için alıcının aracıyı yüklemediği durumlarda bile akış çalıştırmasını başarılı olarak işaretlenecek şekilde ayarlayabilirsiniz.

Bot yüklü değilse kutusu, davranışı denetlemenize olanak tanır:

• Başarısız: Alıcı Microsoft Teams'de aracıyı yüklemediğinde akış çalışması başarısız olarak işaretlenir.

• Durum koduyla başarılı yap: Alıcı, aracıyı yüklemediği için iletiyi alamasa bile akış çalışması başarılı olarak işaretlenecektir. Durum kodu 100 döndürülür.

Durum kodu tanımı

Döndürülen durum kodunu akışınızda farklı izleme davranışları tanımlamak için kullanabilirsiniz. Örneğin, akışın bir süre boyunca yeniden denenmesi veya başarısızlıkla ilgili bir kaydın günlüğe kaydedilmesi gerektiğini belirtebilirsiniz.

Durum kodu	Başarılı (Boole)	Description
200	True	İleti başarıyla teslim edildi.
Kategori 100	False	İleti, alıcıda yüklü aracı olmadığından teslim edilemedi.
300	False	İleti, alıcı aracıyla etkin bir konuşma içinde olduğundan teslim edilemedi.