Mengirim pesan proaktif Microsoft Teams

Anda dapat mengonfigurasi pesan proaktif untuk agen dan chatbot klasik yang Anda buat dan sesuaikan di Copilot Studio. Setelah Anda publikasikan agen dan buat agen yang tersedia untuk pengguna di Microsoft Teams, agen dapat mengirim pesan proaktif untuk memberi tahu pengguna ("penerima") di Teams. Pesan proaktif menggunakan alur Power Automate untuk mengirimkan kontennya, dan berguna dalam banyak skenario, termasuk:

  • Memberi tahu penerima bahwa permintaan sebelumnya telah selesai. Misalnya, permintaan cuti pengguna disetujui.
  • Memberikan pengingat atau kabar terbaru. Misalnya, agen mengirimkan pengingat untuk menyelesaikan pelatihan online.

Important

Agen tidak dapat mengirimkan pesan jika penerima:

  • Tidak menginstal agen di Teams.
  • Menghapus instalan agen.
  • Memblokir agen.
  • Tidak memiliki izin untuk mengobrol dengan agen. Dalam hal ini, Anda perlu berbagi agen.

Prasyarat

Batasan yang diketahui

  • Jika agen terputus dan terhubung kembali ke Teams, pengguna tidak menerima pesan proaktif hingga mereka menginstal ulang agen.
  • Semua pesan proaktif dari Copilot Studio tunduk pada batas Power Automate dan batas pembatasan konektor Microsoft Teams.
  • Pesan proaktif tidak muncul dalam transkrip percakapan atau data sesi analitik.
  • Pesan proaktif harus berada di lingkungan yang sama dengan alur Power Automate.
  • Pesan proaktif hanya dapat masuk ke obrolan pribadi dengan agen.

Mengirim pesan proaktif

  1. Di Power Automate, buka alur yang ingin Anda gunakan untuk mengirim pesan proaktif.

  2. Tambahkan tindakan konektor Microsoft Teams Kirim pesan di obrolan atau saluran.

  3. Untuk Kirim sebagai, pilih Microsoft Copilot Studio agent.

  4. Untuk Posting di, pilih Obrolan dengan agen.

  5. Untuk Agen, pilih agen tempat Anda ingin mengirim pesan.

  6. Di Penerima, masukkan nama atau alamat email penerima. Anda juga dapat menggunakan konten dinamis jika info penerima berasal dari langkah sebelumnya dalam alur.

  7. Untuk Pesan, masukkan pesan yang ingin Anda kirim.

    tindakan 'Post message' di Power Automate.

Saat alur proses berjalan, penerima menerima pesan proaktif dari agen di Teams.

Kirim Kartu Adaptif proaktif

Bagian ini menjelaskan cara mengirim kartu Adaptive yang proaktif dengan menggunakan alur kerja Power Automate. Pada Kartu Adaptif proaktif, pengguna dapat menerima informasi dari percakapan yang tidak aktif dengan agen.

Tangkapan layar kartu adaptif.

Kartu Adaptif adalah format pertukaran kartu terbuka yang memungkinkan pengembang bertukar konten UI dengan cara yang sama dan konsisten. Anda dapat membuat Kartu Adaptif secara manual dalam format JSON, atau jika Anda lebih suka antarmuka drag-and-drop, Anda dapat menggunakan Kartu Adaptif Designer.

Note

Power Automate tidak mendukung Kartu Adaptif yang menggunakan fitur templating.

Dalam contoh ini, Anda mengirim kartu ringkasan pesanan untuk ditinjau pengguna.

  1. Di, Power Automate tambahkan tindakan konektor Microsoft Teams Posting kartu adaptif di obrolan atau saluran pada langkah tempat Anda ingin mengirim kartu dalam alur Anda.

  2. Untuk Kirim sebagai, pilih Microsoft Copilot Studio agent.

  3. Untuk Posting di, pilih Obrolan dengan agen.

  4. Untuk Agen, pilih agen tempat Anda ingin mengirim pesan.

  5. Di Penerima, masukkan nama atau alamat email penerima. Anda juga dapat menggunakan konten dinamis jika info penerima berasal dari langkah sebelumnya dalam alur.

  6. Untuk Kartu Adaptif, masukkan JSON templat berikut:

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

    Posting tindakan kartu adaptif di Power Automate.

Saat alur berjalan, penerima akan menerima Kartu Adaptif dari agen di Teams.

Kirim Kartu Adaptif proaktif dan tunggu respons pengguna

Kartu Adaptif mendukung pengumpulan input pengguna. Dalam skenario ini, Anda ingin menunggu respons pengguna sebelum alur berlanjut.

Cuplikan layar kartu adaptif yang berisi tindakan untuk pengguna.

Note

Power Automate tidak mendukung Kartu Adaptif yang menggunakan fitur templating.

Dalam contoh ini, Anda mengirim kartu konfirmasi pesanan yang memungkinkan pengguna membuat perubahan sebelum pesanan dikirimkan.

  1. Di Power Automate, tambahkan tindakan konektor Microsoft Teams Posting kartu adaptif dan tunggu respons pada langkah tempat Anda ingin mengirim kartu dalam alur Anda.

  2. Untuk Kirim sebagai, pilih Microsoft Copilot Studio agent.

  3. Untuk Posting di, pilih Obrolan dengan agen.

  4. Untuk Pesan, masukkan JSON templat berikut. Properti dalam actions elemen menentukan opsi yang dilihat pengguna.

    {
    "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. Untuk Perbarui pesan, masukkan pesan yang dilihat penerima setelah memberikan tanggapannya.

  6. Di Penerima, masukkan nama atau alamat email penerima. Anda juga dapat menggunakan konten dinamis jika info penerima berasal dari langkah sebelumnya dalam alur.

  7. Untuk Agen, pilih agen tempat Anda ingin kartu dikirim.

    Post kartu adaptif dan tunggu tindakan respons di Power Automate.

Saat alur berjalan, penerima akan menerima kartu adaptif dari agen di Teams sehingga kemudian mereka dapat meresponsnya.

Untuk menggunakan respons dari penerima, pilih submitActionId dari menu flyout konten dinamis. Nilai variabel ini adalah title tindakan yang dipilih pengguna.

Mengirim pesan proaktif ke beberapa penerima

Dalam beberapa skenario, Anda mungkin ingin mengirim pesan proaktif yang sama ke beberapa penerima.

Bagian ini berisi contoh untuk mengirim pesan ke beberapa penerima.

Important

Setiap penerima harus memenuhi prasyarat yang disebutkan dalam artikel ini.

Misalnya, Anda dapat mengirim pesan yang sama ke 10 penerima dalam satu tindakan. Jika tiga dari 10 penerima tidak menginstal agen, ketiga penerima tersebut tidak akan menerima pesan.

Kirim ke rekan tim

Dalam contoh ini, agen mengirimkan pengingat kepada anggota tim untuk menyelesaikan pelatihan online mereka.

  1. Tambahkan konektor Microsoft Teams dan pilih tindakan Dapatkan tim dalam alur Power Automate Anda.

  2. Untuk Tim, pilih tim dengan anggota yang ingin Anda kirimi pesan.

  3. Tambahkan konektor Office 365 Groups dan pilih tindakan Kelompok daftar.

  4. Untuk ID Grup, pilih Nilai kustom.

  5. Pilih ID Tim dari konten dinamis tindakan Dapatkan tim.

  6. Tambahkan konektor Microsoft Teams dan pilih tindakan Kirim pesan dalam obrolan atau saluran.

  7. Untuk Kirim sebagai, pilih Microsoft Copilot Studio agent.

  8. Untuk Posting di, pilih Obrolan dengan agen.

  9. Untuk Agen, pilih agen tempat Anda ingin mengirim pesan.

  10. Untuk Penerima, pilih konten dinamis Nama Prinsip Pengguna dari tindakan Daftar anggota grup.

    Kirim ke rekan satu tim.

  11. Untuk Pesan, masukkan pesan yang ingin Anda kirim.

Saat alur berjalan, setiap pengguna dalam tim menerima pesan proaktif dalam obrolan pribadi dengan agen.

Kirim ke grup keamanan

Dalam contoh ini, agen mengirimkan pengingat ke grup keamanan untuk menyelesaikan pelatihan online mereka.

  1. Tambahkan konektor Microsoft Entra ID dan pilih tindakan Dapatkan anggota grup dalam alur Power Automate Anda.

  2. Untuk ID Grup, masukkan GUID grup keamanan.

  3. Tambahkan konektor Microsoft Teams dan pilih tindakan Kirim pesan dalam obrolan atau saluran.

  4. Untuk Kirim sebagai, pilih Microsoft Copilot Studio agent.

  5. Untuk Posting di, pilih Obrolan dengan agen.

  6. Untuk Agen, pilih agen tempat Anda ingin mengirim pesan.

  7. Untuk Penerima, pilih konten dinamis Nama Prinsip Pengguna Anggota Grup dari tindakan Dapatkan anggota grup.

  8. Untuk Pesan, masukkan pesan yang ingin Anda kirim.

    Opsi Kirim ke grup keamanan.

Saat alur berjalan, setiap pengguna dalam grup keamanan menerima pesan proaktif dalam obrolan pribadi dengan agen.

Kirim pesan proaktif ke beberapa penerima secara paralel

Biasanya, ketika agen mengirim pesan proaktif ke beberapa penerima, ia mengirim satu demi satu pesan. Namun, dalam beberapa situasi, mungkin lebih baik mengirim pesan ke beberapa penerima secara bersamaan.

Peringatan

Semua pesan proaktif dari Copilot Studio tunduk pada batasan Power Automate dan batas pembatasan konektor Microsoft Teams.

Jika Anda mengirim pesan ke sekelompok besar penerima, Anda akan melihat kesalahan jika Anda mencapai batas pembatasan. Anda dapat mengurangi tingkat paralelisme, atau mengurangi jumlah penerima dalam grup.

  1. Dalam tindakan Terapkan ke setiap tindakan, pilih tiga titik (...) lalu pilih Pengaturan.

    Tangkapan layar memilih pengaturan.

  2. Aktifkan kontrol keserempakan dan atur tingkat paralelisme.

    Kontrol penggeser untuk mengatur level atau keserempakan.

Mengonfigurasi opsi lanjutan untuk pesan proaktif

Copilot Studio memungkinkan Anda mengontrol perilaku terperinci pada agen Anda di bawah opsi lanjutan Show di konektor Microsoft Teams.

Panel opsi yang diperluas di konektor.

Melabeli pesan yang dikirim sebagai notifikasi

Label sebagai pemberitahuan mengontrol apakah pesan memiliki teks "Pemberitahuan melalui" di depan nama agen. Melabeli respons agen memungkinkan penerima untuk mengidentifikasi respons agen terhadap pertanyaan mereka.

Pengaturan menunjukkan Pemberitahuan melalui nama agen.

Saat penerima saat ini sedang dalam obrolan aktif dengan agen

Agen dapat mengirim pesan proaktif saat penerima sedang dalam percakapan aktif dengan agen. Anda mungkin ingin menunda pengiriman pesan proaktif hingga akhir percakapan untuk menghindari gangguan alur percakapan.

Opsi Jika obrolan dengan agen aktif mengontrol perilaku:

  • Kirim: agen mengirimkan pesan proaktif seperti biasa.

  • Jangan kirim dan berhasil: agen tidak akan mengirim pesan proaktif saat penerima berada dalam percakapan aktif. Kode status 300 dikembalikan.

  • Jangan kirim dan gagal: agen tidak mengirim pesan proaktif saat penerima berada dalam percakapan aktif. Eksekusi alur akan ditandai sebagai kegagalan.

Saat penerima belum menginstal agen

Agen hanya dapat mengirimkan pesan ke penerima yang menginstal agen di Teams. Beberapa penerima mungkin tidak ingin menginstal agen atau mungkin menghapus instalan agen.

Untuk pesan yang lebih rendah, Anda dapat mengatur eksekusi alur untuk ditandai sebagai berhasil bahkan ketika penerima tidak menginstal agen.

Opsi Jika agen tidak diinstal mengontrol perilaku:

  • Gagal: proses alur ditandai gagal ketika penerima belum menginstal agen di Teams.

  • Berhasil dengan kode status: eksekusi alur ditandai sebagai berhasil meskipun penerima tidak dapat menerima pesan tersebut karena mereka tidak menginstal agen. Kode status 100 dikembalikan.

Definisi kode status

Gunakan kode status yang ditampilkan untuk menentukan perilaku tindak lanjut yang berbeda dalam alur Anda. Misalnya, Anda dapat menentukan bahwa alur harus mencoba lagi selama periode waktu tertentu atau mencatat rekaman tentang kegagalan.

Kode status Berhasil (Boolean) Description
200 Benar Pesan berhasil dikirimkan.
100 False Pesan tidak dapat dikirimkan karena penerima tidak menginstal agen.
300 False Pesan tidak dapat dikirimkan karena penerima sedang dalam percakapan aktif dengan agen.
  • Last updated on