Proaktif Microsoft Teams iletileri gönderme

2024-12-27

Aracınızı yayımladıktan ve aracıyı Microsoft Teams'te kullanıcıların kullanımına sunduktan sonra Microsoft Teams'te kullanıcıları ("alıcılar") proaktif iletiler ile bilgilendirebilirsiniz. Proaktif iletilerde içeriği teslim etmek için Power Automate akışları kullanılır ve bu iletiler, aşağıdakiler dahil olmak üzere birçok senaryoda faydalı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

Copilot Studio'da oluşturulan ve özelleştirilen aracılar ve klasik sohbet botları için proaktif iletiler yapılandırılabilir.

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

Microsoft Teams'te aracının yüklü olmaması.
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

Bilinen sınırlamalar

Eğer aracı bağlantısı kesilir ve Microsoft Teams'e yeniden bağlanırsa, kullanıcılar aracı yeniden yükleyene kadar proaktif mesajlar almazlar.
Copilot Studio'tan gelen tüm proaktif iletiler, Power Automate'teki sınırlara 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 iletiler, Power Automate akışıyla aynı ortamda yer almalıdır.
Proaktif iletiler yalnızca aracı ile kişisel bir sohbete gönderilebilir.

Proaktif ileti gönderme

Power Automate'te, proaktif ileti göndermek istediğiniz akışı açın.
Sohbete veya kanala ileti gönder Microsoft Teams bağlayıcısı eylemini ekleyin.
Farklı gönder için Power Virtual Agents (Önizleme) seçeneğini belirleyin.
Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.
Bot için, iletinin gönderilmesini istediğiniz aracı seçin.
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.
İleti için göndermek istediğiniz iletiyi girin.

Akış çalıştırıldığında alıcı, Microsoft Teams'te 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ğini açıklanmaktadır. Proaktif Uyarlamalı Kartlar, kullanıcıların aracı ile etkin olmayan bir konuşmadan bilgi almasına olanak tanır. Etkin bir konuşmada nasıl Uyarlamalı Kartlar göndereceğinizi öğrenmek için bkz. Copilot Studio'da Uyarlamalı Kart Gösterme.

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

Uyarlamalı kartın ekran görüntüsü.

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.

Power Automate'te, akışınızda kart göndermek istediğiniz adımda Uyarlamalı kartı sohbet veya kanalda gönder Microsoft Teams bağlayıcı eylemini ekleyin.
Farklı gönder için Power Virtual Agents (Önizleme) seçeneğini belirleyin.
Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.
Bot için, iletinin gönderilmesini istediğiniz aracı seçin.
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.

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"
        }
    ]
}

Power Automate'te uyarlamalı kart eylemi gönderin.

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

Kullanıcı yanıtını bekleme

Önemli

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

Kullanıcı için eylemleri içeren uyarlamalı kartın ekran görüntüsü.

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.

Power Automate'te, akışınızda kart göndermek istediğiniz adımda Uyarlamalı kart gönder ve yanıtı bekle Microsoft Teams bağlayıcı eylemini ekleyin.
Farklı gönder için Power Virtual Agents (Önizleme) seçeneğini belirleyin.
Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.

İ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"
        }
    ]
}

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.
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.
Bot için, kartın gönderilmesini istediğiniz aracı seçin.

Akış çalıştırıldığında alıcı, Microsoft Teams'te aracıdan uyarlamalı kartı alır ve daha sonra yanıtı sağlayabilir.

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.

Power Automate akışınızda Microsoft Teams bağlayıcısını ekleyin ve Takım al eylemini seçin.
Takım için iletiyi göndermek istediğiniz üyelerin bulunduğu takımı seçin.
Office 365 Grupları bağlayıcısını ekleyin ve Grup üyelerini listele eylemini seçin.
Grup Kimliği için Özel değer'i seçin.
Takım al eyleminin dinamik içeriğinden Takım Kimliği'ni seçin.
Microsoft Teams bağlayıcısını ekleyin ve Sohbete veya kanala ileti gönder eylemini seçin.
Farklı gönder için Power Virtual Agents (Önizleme) seçeneğini belirleyin.
Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.
Bot için, iletiyi göndermek istediğiniz aracı seçin.
Alıcı için Grup üyelerini listele eyleminden Kullanıcı Asıl Adı dinamik içeriğini seçin.
İ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.

Microsoft Entra ID bağlayıcısını ekleyip Power Automate akışınızdaki Grup üyelerini al eylemini seçin.
Grup Kimliği için güvenlik grubunun GUID değerini girin.
Microsoft Teams bağlayıcısını ekleyin ve Sohbete veya kanala ileti gönder eylemini seçin.
Farklı gönder için Power Virtual Agents (Önizleme) seçeneğini belirleyin.
Şuraya gönder için Bot ile sohbet edin seçeneğini belirleyin.
Bot için, iletiyi göndermek istediğiniz aracı seçin.
Alıcı için Grup üyelerini al eyleminden Grup Üyeleri Kullanıcı Asıl Adı dinamik içeriğini seçin.
İ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'tan gelen tüm proaktif iletiler, Power Automate'teki sınırlara 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.

Her birine uygula eyleminde, üç yatay noktayı (. . .) ve ardından Ayarlar'ı seçin.
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ızdaki ayrıntı davranışını denetlemenize olanak tanır.

Bağlayıcıdaki genişletilmiş seçenekler bölmesi.

Gönderilen iletiyi bildirim olarak etiketleme

Bildirim olarak etiketle, iletide aracı adının sonunda "Aracılığıyla bildirim" metninin bulunup bulunmadığını denetler. 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.

Ayarda, aracı adı aracılığıyla bildirim gösterilir.

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önderir.
Gönderme ve başarılı olarak işaretle: aracı, alıcı etkin bir konuşma içindeyken proaktif iletiyi göndermez. Durum kodu 300 döndürülür.
Gönderme ve başarısız olarak işaretle: aracı, alıcı etkin bir konuşma içindeyken 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 Microsoft Teams'te aracıyı yükleyen alıcılara proaktif iletiler veya kartlar teslim edebilir. 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: Akış çalıştırması, alıcı Microsoft Teams'te aracıyı yüklemediğinde başarısız olarak işaretlenir.
Durum koduyla başarılı: Akış çalıştırması, aracıyı yüklemediği için alıcı iletiyi alamasa bile başarılı olarak işaretlenir. 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.

Aracılığıyla paylaş

Proaktif Microsoft Teams iletileri gönderme

Önkoşullar

Bilinen sınırlamalar

Proaktif ileti gönderme

Proaktif Uyarlamalı Kart gönderme

Kullanıcı yanıtını bekleme

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

Takım arkadaşlarına gönderme

Güvenlik grubuna gönderme

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

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

Gönderilen iletiyi bildirim olarak etiketleme

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

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

Durum kodu tanımı

Geri Bildirim

Ek kaynaklar